腾讯广告API总结汇总分享
2022-10-27 20:25:55 0 举报AI智能生成
腾讯广告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=<ACCES S_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=<ACCES S_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.确定行为类型
下单（COMPLETE_ORDER）
预约（RESERVATION）
5.回传数据
目标：根据 click_id、Action_Type、创建时保存的数据源 ID，调用 API 进行回传，获取成功应答；
请求地址： user_actions/add
关注类广告转化行为数据接入 更新日期：2019 年 8 月 26 日
使用背景
目前支持的行为类型
下单（COMPLETE_ORDER）
预约（RESERVATION）
注册（REGISTER）
目前支持的广告流量包括
1）公众号底部和文中；
2）朋友圈信息流；
3）小程序/小游戏广告位；
原理介绍
1.对于公众号的粉丝，每个粉丝都会生成一个 openid，将 openid 与公众号appid作为转化数据的标识之一回传广告平台。
2.广告平台会通过 openid 和 appid 关联到之前投放的关注类广告，从而得到关注与转化的关联。
3.关联后计算的广告效果会呈现在 MP 投放端报表中，并会成为后续智能优化的数据基础。
对接步骤
1.注册成为开发者
如果是第三方就是开放平台授权
2.创建数据源
请求字段type，增加了新类型：WECHAT
增加了wechat_app_id字段，该字段就是公众号/小程序appid，对应接下来的接口
3.获取用户 openid
该appid应为创建数据源时，wechat_app_id下的openid
4.确定行为类型
下单（COMPLETE_ORDER）
预约（RESERVATION）
注册（REGISTER）
5.回传数据
请求地址： user_actions/add
增加字段：user_id
微信广告（ad.weixin.qq.com）
H5-JS回传
使用场景
标准行为参数
支持作为行为人群创建
全部行为参数
支持作为投放端数据指标展示
下单（COMPLETE_ORDER）
预约（RESERVATION）
支持作为oCPM优化目标
下单（COMPLETE_ORDER）
预约（RESERVATION）
对接流程
1.创建行为数据源
2.嵌入JS代码
3.用途说明
H5-Open MKT API回传
对接流程简介
特别说明：使用已开通广告主身份的公众号或小程序身份进行联调
1.在微信公众平台的『开发』—『基本配置』中注册成为开发者
2.创建转化数据对应的数据源；
3.获取用户click_id，根据转化行为、推广目标，选择对应的行为类型回传数据，构造请求回传数据至对应的行为源，需要确保回传成功；
4.例行化：确保线上实际投放时，用户发生转化后，会自动实时运行步骤2，调用API回传数据，并回传成功；
5.验证：判断步骤3是否正常运行；
使用背景
目前支持的行为类型
下单（COMPLETE_ORDER）
预约（RESERVATION）
确认有效销售线索（CONFIRM_EFFECTIVE_LEADS）
目前支持的广告流量包括
1.公众号底部和文中：品牌活动推广、电商推广、销售线索收集广告的H5落地页；
2.朋友圈信息流：品牌活动推广、本地推广、电商推广、销售线索收集广告的H5落地页；
原理介绍
1.对于落地页为H5的广告而言，在微信广告平台推广时，每次点击都会生成一个 click_id
2.跳转到落地页时， 会将 click_id 作为参数传入对应的 URL 中
3.回传转化数据时，需要回传click_id与转化行为
4.广告平台会通过click_id关联到该次转化对应的广告，从而得到点击与转化的关联
5.关联后计算的广告效果会呈现在 MP 投放端报表中，并会成为后续智能优化的数据基础。
对接步骤
准备阶段
（一） 注册成为开发者
目标：获取开发者ID、密码和access_token 步骤
（二） 创建数据源
一个公众号有一个数据源，使用access_token创建
请求地址： user_action_sets/add
正式对接
（一） 获取用户click_id
目标：获取访问H5的用户click_id，作为回传数据的用户标识；
用户点击广告进入落地页后，广告平台会在URL增加click_id。即，URL中的gdt_vid
（二） 确定行为类型
目标：请与业务人员沟通确认，根据推广目标和oCPM优化目标，确认需要回传的行为类型；
目前支持的行为类型
下单（COMPLETE_ORDER）
预约（RESERVATION）
确认有效销售线索（CONFIRM_EFFECTIVE_LEADS）
（三）回传数据
目标：根据click_id、Action_Type、创建时保存的数据源ID，调用API进行回传，获取成功应答；
请求地址： user_actions/add
小程序广告接入
对接流程简介
同H5-Open MKT API回传
使用背景
目前支持的行为类型
同H5-Open MKT API回传
目前支持的广告流量包括
同H5-Open MKT API回传，H5落地页换成小程序落地页
原理介绍
同H5-Open MKT API回传
对接步骤
准备阶段
（一） 注册成为开发者（同H5）
（二） 创建数据源（同H5）
正式对接
（一） 获取用户click_id
目标：获取访问小程序的用户click_id，作为回传数据的用户标识；
广告主在微信广告侧投放小程序广告，用户点击广告打开小程序页面时，微信侧在小程序页面路径上所带的额外参数及参数说明
gdt_vid：广告traceid
weixinadinfo：广告adinfo
（二） 确定行为类型（同H5）
（三）回传数据（同H5）
『外卖行业』专属流程
其他的都一样，且同时支持H5和小程序。
action_param参数中增加了几个专属字段
value：代表订单或付费金额，单位为分
user_locations：用户当前位置的经纬度信息
order_detail：array：如：["米饭_500_2","番茄鸡蛋_1000_1"]
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
component_appid
authorization_code，授权码, 会在授权成功时返回给第三方平台
authorization_info，授权信息
authorizer_appid，授权方 appid
authorizer_access_token，接口调用令牌
expires_in，authorizer_access_token 的有效期
authorizer_refresh_token，刷新令牌
func_info，授权给开发者的权限集列表
#2 获取/刷新接口调用令牌
component_access_token
component_appid
authorizer_appid，授权方 appid
authorizer_refresh_token，刷新令牌，获取授权信息时得到
authorizer_access_token，授权方令牌
expires_in，有效期，单位：秒
authorizer_refresh_token，刷新令牌
获取授权方的帐号基本信息
获取授权方选项信息
设置授权方选项信息
#3 授权变更通知推送
步骤 5：利用授权码调用公众号或小程序的相关 API
代替公众号或小程序调用接口
authorizer_access_token，授权方令牌
授权
广告管理权限
公众号授权时有默认授权广告管理权限；但是小程序没有。小程序的广告管理权限是最近新增的。
腾讯有数（lingshou.tencent.com）
0 条评论
下一页
