腾讯社交广告

APP转化行为数据接入

转化行为数据可以帮助广告主更好地了解广告投放的效果，接入转化行为数据可以使您在投放端查看转化效果，并在oCPA中将具体的转化类型作为优化目标，持续提高广告效率和投入产出比。

首先，您可以选择是否需要获取广告的点击数据，包含：点击时间、点击id、发生点击的广告所属账户id、广告推广的应用id、发生点击的用户设备号。如需获取，请查看：获取点击数据

然后，您可以选择适合自己的转化数据上报方式：SDK上报数据，或API上报数据。可以根据您的实际情况进行选择，并确保只使用一种上报方式，如果采用多种上报方式，投放端报表的转化量会是累加的，不便于您进行上报量与报表数据的比对（如您通过SDK上报了5个激活，API上报5个激活，经过归因、反作弊等策略后，投放端看到的激活量是7个）。

一、通过SDK上报转化数据（推荐）

广告主在推广的APP中嵌入腾讯社交广告SDK，调用SDK的功能上报转化事件给腾讯社交广告平台。

SDK接入的转化数据回流更加准确、及时，有利于oCPA广告的投放效果提升。此外，您通过SDK上报数据后，可以无需积累数据量，直接零门槛投放oCPA（需要联系运营接口人申请白名单）。

iOS SDK：点击下载SDK和说明文档

Android SDK：点击下载SDK和说明文档

注：如您之前对接过老版本的 SDK，需要下载新版 SDK，并依照说明文档重新进行对接。

SDK 接入方案需要先创建 APP用户行为数据源，用户行为数据源是 APP用户行为数据的容器，针对 一个APP，只需要创建一次即可（Android 和iOS需要分开创建）。然后再通过 SDK将用户行为数据 上报到用户行为数据源中。

可以在DMP 系统（de.qq.com）的“数据接入”模块里创建APP 用户行为数据源。也可以通过MKT API 创建APP 用户行为数据源，参见：创建用户行为数据源。

配置获取广告的点击数据可以和SDK配合使用。

您通过获取点击数据功能来获取账户下APP对应的广告点击数据，通过SDK上报用户行为转化。 配置获取广告的点击数据，详情点击此 链接。

登录 腾讯社交广告官网 → 投放管理平台 → 左侧工具箱 → 转化跟踪  → 移动应用转化跟踪页面，点击 “获取点击数据”。

如您需要获取账户内某个APP对应的广告产生的点击数据，则选择对应的移动平台，并填写应用 ID和 feedbackURL（关于feedback URL 的具体要求请点击此 链接）。

二、通过API上报转化数据（Marketing API）

广告主注册成为腾讯社交广告开发者，通过marketingAPI上报转化数据给腾讯社交广告平台。

通过API上报数据有两种方案：

方案一：广告主先将转化数据与获取到的点击数据进行关联，然后将关联到的转化数据上报给腾讯社交广告，广点通进行归因处理。

方案二：广告主将所有数据上报给腾讯社交广告，腾讯社交广告与点击数据进行关联，并归因处理。

注：通过旧版转化API上报数据的广告主，无需再次进行点击转发配置，只需停止使用老转化API上报数据，并按照下文对接marketingAPI，进行数据上报即可。

使用方案一时需要将转化数据先与点击数据相关联，当您投放的广告产生点击时，您可以获取点击中所包含的信息，包括：点击发生的时间、点击id、发生点击的广告所属的账户id、广告推广的应用id、发生点击的用户设备id。如您需要获取账户内某个APP对应的广告产生的点击数据，则选择对应的移动平台，并填写应用ID和feedbackURL。具体步骤如链接获取广告的点击数据。

无论使用方案一或方案二上报数据，均需完成如下两个步骤：

步骤一：marketingAPI账户配置

步骤二：进行数据上报

1、进行APP行为数据接入，接口、参数、上报示例请点击这里

2、如果需要对上报的行为做去重，可以使用outer_action_id字段（string），字段长度最小 1 字节，长度最大 204800 字节。平台会基于user_action_set_id，outer_action_id 和action_type三个字段做去重 ，如果历史上报数据中存在某条数据的这三个字段与当前上报数据完全一样的，则当前数据会被过滤掉。例如广告主希望基于设备号维度做去重，则需要在outer_action_id字段填写实时上报行为对应的设备号，去重结果是对同设备号同action_type同user_action_set_id的行为，仅保留一条（上报的第一条）。

3、 在行为数据接口的action_type字段中，填写需要上报的转化行为类型，在action_param字段中，填写转化价值。

目前支持接入的APP转化行为类型（action_type）如下：

如需上报转化价值，可在action_param里使用value字段：

4、通过接口上报的action_type和action_param，对应投放端的指标如下。

步骤三：查看数据接入监测报表

上报数据后，您可以登录DMP系统(de.qq.com)，在App数据接入模块下查看您App数据的接入情况。在DMP系统上，您可以看到您接入的pv，映射上的pv, 映射上的uv等信息。

除了上述方法外，您也可以通过接口获取用户行为数据源报表来查看到数据上报的情况。以下将为您展示获取用户行为数据源报表接口的调用示例。

代码示例

1） 创建 Android APP 用户行为数据源示例

红色部分需要替换成对应的真实信息（创建iOS 激活数据需要将 type 中参数更换为 IOS）

curl 'https://api.e.qq.com/v1.0/user_action_sets/add?access_token=<your_access_token>&timesta mp=<timestamp>&nonce=<nonce>' \ -H 'Content-Type: application/json' \ -d 
'{
"account_id": "<your_account_id>",
"type": "ANDROID",
"mobile_app_id": "<your_app_id>",
"name": "<user_action_set_name>"
}'

2）上报 Android 激活数据示例

红色部分需要替换成对应的真实信息（上报iOS 激活数据需要将 user_id 中参数更换为 hash_idfa）

curl 'https://api.e.qq.com/v1.0/user_actions/add?access_token=<your_access_token>&timestamp=<t imestamp>&nonce=<nonce>' \ 
-H 'Content-Type: application/json' \
 -d '{ 
"account_id": "<your_account_id>",
"user_action_set_id": "<your_user_action_set_id>", 
"actions": [ { "action_time": <action_timestamp>, 
"user_id": {
 "hash_imei": "<MD5_hash_imei>" 
}, 
"action_type": "ACTIVATE_APP" 
} 
] 
}'

3)上报 Android 购买数据示例及应答

红色部分需要替换成对应的真实信息（上报iOS 激活数据需要将 user_id 中参数更换为 hash_idfa）

curl 
'https://api.e.qq.com/v1.0/user_actions/add?access_token=<your_access_token>&timestamp=<t imestamp>&nonce=<nonce>' \
 -H 'Content-Type: application/json' \
 -d '{ 
"account_id": "<your_account_id>",
"user_action_set_id": "<your_user_action_set_id>", 
"actions": [
 { 
"action_time": <action_timestamp>,
"user_id": { 
"hash_imei": "<MD5_hash_imei>"
 }, 
"action_type": "PURCHASE", 
"action_param":{ 
"value": <purchase_value> 
} 
} 
]
}'

上报成功应答：

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