腾讯广告API
2020-09-21 10:22:08 0 举报
AI智能生成
对腾讯广告API的深刻剖析
作者其他创作
大纲/内容
腾讯广告API
腾讯广告(EQQ)Marketing API
授权
上报
微信广告(wximg.qq.com)
服务商
条件1:开放平台第三方应用授权(access_token)
条件2:有服务商账号(agency_token)
agency_id(spid)
apikey
条件3:服务商账号和开放平台第三方应用绑定,生成apikey
微信广告服务商spid + 第三方应用appid生成
所有接口的请求路径:
https://api.weixin.qq.com/marketing/<RESOURCE>/<ACTION>?access_token=<ACCESS_TOKEN>&agency_token=<AGENCY_TOKEN>&version=v1.0&version=<VERSION>
广告主
获取access_token
开发者ID(AppID)
开发者密码(AppSecret)
获取access_token接口
https://api.weixin.qq.com/marketing/<RESOURCE>/<ACTION>?access_token=<ACCESS_TOKEN>&version=<VERSION>
2.1.1 获取销售线索数据
2.1.2 获取广告关注数据
2.2.1 创建异步任务
2.2.2 获取异步任务
2.2.3 获取文件接口
2.3.1 获取资金账户信息
2.3.2 获取资金账户流水
2.4.1 获取定向标签信息
2.5.1 获取微信原生落地页信息
H5/小程序广告转化行为数据接入更新日期:2018 年 8 月 17 日
使用背景
目前支持的行为类型
下单(COMPLETE_ORDER)
预约(RESERVATION)
目前支持的广告流量包括
1)公众号底部和文中:品牌活动推广、电商推广、销售线索收集广告的 H5 和小程序落地页;
2)朋友圈信息流:品牌活动推广、本地推广、电商推广、销售线索收集广告的 H5和小程序落地页;
原理介绍
1.对于落地页为 H5 或小程序的广告而言,在微信广告平台推广时,每次点击都会生成一个 click_id
2.在跳转到落地页时,会将 click_id 作为参数传入对应的 URL 中
3.回传转化数据时,需要回传 click_id 与转化行为
4.广告平台会通过 click_id 关联到该次转化对应的广告,从而得到点击与转化的关联
5.关联后计算的广告效果会呈现在 MP 投放端报表中,并会成为后续智能优化的数据基础。
对接步骤
1.注册成为开发者
如果是第三方就是开放平台授权
2.创建数据源
目标:创建数据源,生成数据源 ID(user_action_set_id)
类型type:WEB,APP
3.获取用户 click_id
落地页为 H5
用户点击广告进入落地页后,广告平台会在 URL 增加 click_id。即,URL中的 gdt_vid;
落地页为小程序
https://ad.weixin.qq.com/guide/679
超链接
4.确定行为类型
5.回传数据
目标:根据 click_id、Action_Type、创建时保存的数据源 ID,调用 API 进行回传,获取成功应答;
请求地址: user_actions/add
关注类广告转化行为数据接入更新日期:2019 年 8 月 26 日
注册(REGISTER)
1)公众号底部和文中;
2)朋友圈信息流;
3)小程序/小游戏广告位;
1.对于公众号的粉丝,每个粉丝都会生成一个 openid,将 openid 与公众号appid作为转化数据的标识之一回传广告平台。
2.广告平台会通过 openid 和 appid 关联到之前投放的关注类广告,从而得到关注与转化的关联。
3.关联后计算的广告效果会呈现在 MP 投放端报表中,并会成为后续智能优化的数据基础。
请求字段type,增加了新类型:WECHAT
增加了wechat_app_id字段,该字段就是公众号/小程序appid,对应接下来的接口
3.获取用户 openid
该appid应为创建数据源时,wechat_app_id下的openid
增加字段:user_id
微信广告(ad.weixin.qq.com)
广告主在DMP数据管理平台操作,不支持第三方平台操作
H5+小程序click_id方式i
H5-JS回传
使用场景
标准行为参数
支持作为行为人群创建
全部行为参数
支持作为投放端数据指标展示
支持作为oCPM优化目标
对接流程
1.创建行为数据源
2.嵌入JS代码
3.用途说明
H5-Open MKT API回传
对接流程简介
特别说明:使用已开通广告主身份的公众号或小程序身份进行联调
1.在微信公众平台的『开发』—『基本配置』中注册成为开发者
2.创建转化数据对应的数据源;
3.获取用户click_id,根据转化行为、推广目标,选择对应的行为类型回传数据,构造请求回传数据至对应的行为源,需要确保回传成功;
4.例行化:确保线上实际投放时,用户发生转化后,会自动实时运行步骤2,调用API回传数据,并回传成功;
5.验证:判断步骤3是否正常运行;
确认有效销售线索(CONFIRM_EFFECTIVE_LEADS)
1.公众号底部和文中:品牌活动推广、电商推广、销售线索收集广告的H5落地页;
2.朋友圈信息流:品牌活动推广、本地推广、电商推广、销售线索收集广告的H5落地页;
1.对于落地页为H5的广告而言,在微信广告平台推广时,每次点击都会生成一个 click_id
2.跳转到落地页时, 会将 click_id 作为参数传入对应的 URL 中
3.回传转化数据时,需要回传click_id与转化行为
4.广告平台会通过click_id关联到该次转化对应的广告,从而得到点击与转化的关联
准备阶段
(一) 注册成为开发者
目标:获取开发者ID、密码和access_token 步骤
(二) 创建数据源
一个公众号有一个数据源,使用access_token创建
请求地址: user_action_sets/add
正式对接
(一) 获取用户click_id
目标:获取访问H5的用户click_id,作为回传数据的用户标识;
用户点击广告进入落地页后,广告平台会在URL增加click_id。即,URL中的gdt_vid
(二) 确定行为类型
目标:请与业务人员沟通确认,根据推广目标和oCPM优化目标,确认需要回传的行为类型;
(三)回传数据
目标:根据click_id、Action_Type、创建时保存的数据源ID,调用API进行回传,获取成功应答;
小程序广告接入
对接流程简介
同H5-Open MKT API回传
同H5-Open MKT API回传,H5落地页换成小程序落地页
(一) 注册成为开发者(同H5)
(二) 创建数据源(同H5)
目标:获取访问小程序的用户click_id,作为回传数据的用户标识;
广告主在微信广告侧投放小程序广告,用户点击广告打开小程序页面时,微信侧在小程序页面路径上所带的额外参数及参数说明
gdt_vid:广告traceid
weixinadinfo:广告adinfo
(二) 确定行为类型(同H5)
(三)回传数据(同H5)
『外卖行业』专属流程
其他的都一样,且同时支持H5和小程序。
action_param参数中增加了几个专属字段
value:代表订单或付费金额,单位为分
user_locations:用户当前位置的经纬度信息
shipping_locations:收货地址经纬度信息,依序为纬度,经度
小程序广告接入-腾讯有数SDK
公众号-Open MKT API
附录
数据源查询
请求地址: user_action_sets/get
数据源报表查询
请求地址:user_action_set_reports/get
枚举值
预定义标准的行为类型 | action_type
action_param结构
action_param是一个Map,key类型为String
DMP数据管理平台(de.qq.com)
入口:MP后台-广告主-『人群管理』-『高级功能』
微信开放平台
授权流程技术说明
步骤 1:第三方平台方获取预授权码(pre_auth_code)
入参
#1 先获取令牌(component_access_token)
component_appid,第三方平台 appid
component_appsecret,第三方平台 appsecret
验证票据(component_verify_ticket)
#2 component_appid,第三方平台 appid
步骤 2:引入用户进入授权页
方式一:授权注册页面扫码授权
component_appid
pre_auth_code,预授权码
redirect_uri,回调 URI
auth_type,要授权的帐号类型
1-则商户扫码后,手机端仅展示公众号
2-表示仅展示小程序
3-表示公众号和小程序都展示
null = 3
biz_appid,指定授权唯一的小程序或公众号
方式二:点击移动端链接快速授权
步骤 3:用户确认并同意登录授权给第三方平台方
步骤 4:授权后回调 URI,得到授权码(authorization_code)和过期时间
#1 使用授权码获取授权信息
component_access_token
authorization_info,授权信息
authorizer_appid,授权方 appid
authorizer_access_token,接口调用令牌
expires_in,authorizer_access_token 的有效期
authorizer_refresh_token,刷新令牌
func_info,授权给开发者的权限集列表
出参
#2 获取/刷新接口调用令牌
authorizer_refresh_token,刷新令牌,获取授权信息时得到
authorizer_access_token,授权方令牌
expires_in,有效期,单位:秒
获取授权方的帐号基本信息
获取授权方选项信息
设置授权方选项信息
#3 授权变更通知推送
步骤 5:利用授权码调用公众号或小程序的相关 API
代替公众号或小程序调用接口
等于开发者的access_token
广告管理权限
公众号授权时有默认授权广告管理权限;但是小程序没有。小程序的广告管理权限是最近新增的。
腾讯有数(lingshou.tencent.com)
收藏
收藏
0 条评论
回复 删除
下一页