腾讯广告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/&amp;lt;RESOURCE&amp;gt;/&amp;lt;ACTION&amp;gt;?access_token=&amp;lt;ACCES S_TOKEN&amp;gt;&amp;agency_token=&amp;lt;AGENCY_TOKEN&amp;gt;&amp;version=v1.0&amp;version=&amp;lt;VERSION&amp;gt;

广告主

获取access_token

开发者ID（AppID）

开发者密码（AppSecret）

获取access_token接口

所有接口的请求路径：

https://api.weixin.qq.com/marketing/&amp;lt;RESOURCE&amp;gt;/&amp;lt;ACTION&amp;gt;?access_token=&amp;lt;ACCES S_TOKEN&amp;gt;&amp;version=&amp;lt;VERSION&amp;gt;

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：如：[&amp;quot;米饭_500_2&amp;quot;,&amp;quot;番茄鸡蛋_1000_1&amp;quot;]

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）