腾讯社交广告

模式1：开发者用一套完成鉴权的 account id 和对应的 user_action_set_id 来上报所有账户的数据。

模式2（推荐所有新上报数据的开发者使用）：开发者与每一个账户进行鉴权，将行为上报到各个
account id 下的 user_action_set_id 内，完成各自账户的数据上报。推荐所有新上报数据的开发者使用模式2，因为这种方式的上报可以使得效果数据到广告的归因更准确，使用模式1时如果希望归因更准确，开发者后续仍然需要完成与每一个账户的鉴权。

举例：代理商A是开发者，负责五个账户的数据上报工作，模式1是A先完成五个账户中某一个账户a的鉴权，然后将所有行为数据上报到a的数据源(user_action_set_id)，系统会自动判断每个行为是五个账户中哪个账户的广告带来的效果，但可能出现将a账户的行为归因给b的情况；模式2是A分别与五个账户进行鉴权，并且分别在各个账户下创建数据源，然后将行为数据区分上报：将账户a带来的行为上报给a账户下的数据源，账户b带来的行为上报给b账户下的数据源，以此类推。结果是a账户带来的行为仅会归因给a账户投放的广告，效果数据更准确。

---

2. API接入流程

Step 1. 注册成为腾讯社交广告 MarketingAPI (https://developers.e.qq.com/) 开发者
Step 2. 创建转化数据上报应用，等待审核
Step 3. 绑定需要追踪 H5 转化数据的广告主账户
Step 4. 上报网页转化行为数据

2.1 注册成为腾讯社交广告 MarketingAPI 开发者

要调用Marketing API，必须先注册成为开发者并创建应用。此处的应用可以理解为一个面向其他广告主的服务，下文将其统一定义为『转化数据上报应用』。

---

2.2 绑定需要追踪 H5 转化数据的广告主账户

2.2.1 完成OAuth2.0认证操作（用户行为数据接入的 refresh token 有效期为 2 年）

2.2.2 配额和频次控制

---

2.3 上报网页转化行为数据

在传入转化行为数据之前，请确保开发者已经：

• 完成了需要上报效果的广告主账户的绑定
• 获取了可用的在有效期内的 token

2.3.1 转化数据类型

要上报转化行为，首先需要填写相应的转化类型（ActionType）对应参数为action_type
如下表所示：

名称	类型	描述
account_id	integer	广告主id，需为已经和开发者完成鉴权的广告主ID
user_action_set_id	integer	原 pixel id，现更名为 user_action_set_id，旧参数名依然兼容。后续用于标识数据归属权，详见 user_action_sets 接口
action_type	enum	预定义的行为类型，全部行为类型见 action_type全集介绍
action_param	string	行为所带的参数，详见 action_param介绍
outer_action_id	string	字段长度最小 1 字节，长度最大 204800 字节。是去重标识，平台会基于user_action_set_id，outer_action_id 和action_type三个字段做去重 ，如果历史上报数据中存在某条数据的这三个字段与当前上报数据完全一样的，则当前数据会被过滤掉
actions	struct	转化行为
action_time	integer	行为发生时，客户端的时间点。 UNIX 时间，单位为秒，如果不填将使用服务端时间填写 最小值 0，最大值 2147483647
trace	struct	跟踪信息
click_id	string	点击 id 落地页URL中的click_id，对于广点通流量为URL中的qz_gdt，对于微信流量为URL中的gdt_vid

2.3.4 请求示例

需要统计『下单』的转化行为，开发者只需要在下单转化行为发生时，上报action_type=”COMPLETE_ORDER”、click_id和nonce（nonce是一个长度小于32的随机字符串，并要保证唯一性）。回传过程中如有重复上报，开发者希望基于订单id做去重，最终实现“每个订单id仅上报一次”，将每条行为中的订单id实时填入outer_action_id，如订单号为123456，请求示例如下：

curl -k "https://api.e.qq.com/v1.0/user_actions/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>" \
    -H 'Content-Type: application/json' \
    -d '{
            "account_id": "<ACCOUNT_ID>",
            "actions": [
                {
                    "user_action_set_id": "<USER_ACTION_SET_ID>",
                    "url": "<URL>",
                    "action_time": 1487923255,
                    "action_type": "COMPLETE_ORDER",
                    "trace": {
                        "click_id": "<CLICK_ID>"
                    },
                    "action_param": {
                        "int_example": 123,
                        "string_example": "123"
                    },
                    "outer_action_id":123456
                }
            ]
       }'

2.3.5 返回值

正确的返回值为：

{"code":0,"message":"ok"}

代表上报成功。

关于错误的返回码详见 MarketingAPI 返回码。

---

附录

一、特别说明·不同类型账户请求授权结果：

1. 如果请求授权的是代理商帐号，代理商用开户 QQ 登录并同意授权，完成 OAuth 2.0 后应用获得access_token，该应用会获得当前代理商所有子客户的推广帐号的操作权限
2. 如果请求授权的是直客帐号，客户用开户 QQ 登录并同意授权，完成 OAuth 2.0 后应用获得 access_token，该用户会获得当前客户推广帐号的操作权限
3. 如果请求授权的是代理商子客户，用子客户的自理管理员 QQ（由代理商分配）登录并同意授权，完成 OAuth 2.0 后应用获得 access_token，该应用会获得当前子客户推广帐号的操作权限。