自归因上报流程
广告投放中与数据上报相关的事项如下。其中，蓝色为具体的上报事项，红色为前置条件。
自归因是广告监测数据回传给广告主对接的第三方归因平台，或由广告主自己完成对应的事件归因。在平台归因上报流程中和 DataNexus 相关的部分为 “1监测链接”、“4 匹配转化信息“、“5使用 API/SDK 接入”和“6归因结果检查”。
1 监测链接
当您同时投放多个平台的广告时，可通过填入监测链接，以识别出腾讯广告给您带去的 muid、android_id、ip、user_agent、oaid、caid、model 等设备信息。推荐的接入方案如下。
| 接入方式 | 投放APP & Web | 投放微信小游戏 & 小程序 | 投放企业微信、公众号 |
|---|---|---|---|
| API 接入 | 可接入 点击监测链接 ，曝光监测链接 | 全部回传可略过该步骤 | 全部回传可略过该步骤 或接入 效果监测链接 |
| SDK 接入 | 不适用 | 不适用 | 不适用 |
| 文件上传 | 可接入 点击监测链接 ，曝光监测链接 | 可接入 点击监测链接 ，曝光监测链接 | 可接入 点击监测链接 ，曝光监测链接 |
| 平台授权 | 不适用 | 不适用 | 不适用 |
4 匹配转化信息
4.1 如何匹配
腾讯广告将通过 1 监测链接 将 imei、idfa、phone、android_id、oaid、wechat_appid+wechat_openid、wechat_appid+wechat_unionid、caid+caid_version 下发给您，请您将其与自己监测到的转化用户的相关信息进行匹配。
如，腾讯广告监测到 imei 号为 123 的用户在腾讯客户端点击了您的广告，并将该用户的相关信息通过监测链接下发给您。您监测到 imei 号 123 和 imei 号 456 为新增转化用户，通过匹配发现 imei 号 123 匹配成功，则将该用户的信息通过 5 回传给腾讯广告；imei 号 456 匹配失败，则无需回传。
4.2 关于“匹配转化信息”的建议
Android 系统
- 优先使用 muid 归因
- 若 muid 归因失败，使用 AndroidID 归因
- 若 AndroidID 归因失败，使用 oaid 归因
- 若 oaid 归因失败，使用 IP+UA 归因
iOS 系统
- 优先使用 muid 归因
- 若 muid 归因失败，使用 qaid_ caa 归因
- 若 qaid_ caa 归因失败，使用 IP+UA 归因
微信类
- 对于通过点击下发进行归因的方式：建议通过 wechat_open_id 进行归因，回传自归因成功的 click_id 与 wechat_openid
- 对于通过落地页参数进行归因的方式：建议通过对应行为发生的小程序参数 gdt_vid 进行归因，回传全量的 gdt_vid 中的 traceid 作为 clickid；落地页参数下发 参考
注：对于微信小程序，如果通过点击下发和落地页参数同时获取点击信息，不建议通过将点击下发的 id 信息与 gdt_vid 信息进行匹配归因（因部分版位拼接的参数 id 取值逻稍有差异）。
4.3 请上传“归因方式”
由于存在多种归因逻辑，故期望您能够把最终转化归因对应的归因方式 上报 至腾讯广告（例如本次转化是通过 idfa 归因，则回传该信息），以便双方共同关注归因设备 ID 的变化情况，当异常发生时可以第一时间发现，减少归因差异。
5 使用 API/SDK 上报
5.1 回传方式
请在正式投放之前完成行为回传的开发。
| API api.e.qq | API tracking.e.qq | |
|---|---|---|
| 接入工具 | 用户行为添加/更新 注：转化归因不支持“线下”类型数据源 | APP 转化数据 API 自归因 Web 转化数据 API 自归因 小游戏转化数据 API 自归因 小程序转化数据 API 自归因 公众号转化数据 API 自归因 企业微信转化数据 API 自归因 |
| 优势 | 一接多用，支持以下场景使用 转化归因 一方数据合作 腾讯广告如翼 动态商品广告 | callback 方式免鉴权 支持自动创建数据源 |
5.2 回传规范
5.2.1 数据源
转化归因不支持“线下”数据源。
5.2.2 用户 ID
用户 ID 在 Android APP、iOS APP、微信应用（小程序、小游戏、公众号）、web 应用、线下等端，识别用户的设备号或用户 ID 不同，因此不同端有不同的合法 ID 类型。上报的 ID 信息越完整，归因的准确率越高。详细可参考 ID上报方式 。
| 信息分类 | 数据源类型 | 合法 ID 类型 |
|---|---|---|
| 用户ID | Android 应用 | imei、oaid、android_id、手机号、click_id |
| 用户ID | iOS 应用 | CAID（推荐）、idfa（iOS 14版本及以上，不建议上报）、手机号、click_id |
| 用户ID | 微信应用 | appid+openid、appid+unionid、clickid |
| 用户ID | web 应用 | imei、oaid、android_id、手机号、click_id、idfa、caid、openid、unionid |
5.2.3 公共信息
用户实体基础信息结构如下。
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| account_id | integer | Y | 推广帐号 id或 DataNexus 账号 id |
| user_action_set_id | integer | Y | 数据源 id，通过DataNexus创建数据源时分配的唯一 id。请注意，当填写的数据源类型为 {WECHAT, WECHAT_MINI_PROGRAM, WECHAT_MINI_GAME} 时，必填 user_id 字段中的 wechat_openid (或 wechat_unionid) 及 wechat_app_id。 |
| actions | array | Y | 返回数组列表，不能大于 50KB，数组最小长度 1，最大长度 50 |
| action_time | integer | Y | 行为发生时，客户端的时间点。UNIX 时间，单位为秒，如果不填将使用服务端时间填写，最大值 2147483647 |
| user_id | object | C | 用户标识，app 数据上报时必填，user_id 与 click_id 二选一必填 |
| hash_imei | string | C | Android设备填写，IMEI 设备号，转小写后md5编码，并选取32位小写数字字母上传。例如原文IMEI：A000002C9060F7，加密时md5(a000002c9060f7)，加密后：f2d5a650733ca8c27d502b1c08da14e5 |
| md5_sha256_imei | string | C | Android设备填写，IMEI 设备号先采用 MD5 加密，再采用SHA256加密，加密前转化成 14 位或 15 位数字+小写字母串，加密后为 64 位小写数字字母组合。例如：加密前 a000002c9060f7，加密后 d64db6590359b386397db4d8a61dbc8fbd586b8a0b822ee6bc19316402d583b4 |
| hash_idfa | string | C | iOS设备填写，先转为8-4-4-4-12格式，再大写，最后进行md5加密，将加密后的32位小写数字字母上报。例如： 原文4FCFEFA1-096D-4176-B352-1870ED6DB777，加密后，09c593c62a6074ae5f859e97a222c0e8。iOS设备14版本及以上，建议增加上报caid |
| md5_sha256_idfa | string | C | iOS设备填写，IDFA 号先采用 MD5 加密，再采用 SHA256 加密，加密前转化成 14 位或 15 位数字 + 小写字母串，加密后为 64 位小写数字字母组合。 示例：加密前 a000002c9060f7，加密后 d64db6590359b386397db4d8a61dbc8fbd586b8a0b822ee6bc19316402d583b4 |
| gdt_openid | string | C | GDT Cookie Mapping 分配的 openid，不做处理，字段长度为 64 字节 |
| hash_phone | string | 电话号码直接 MD5 编码，如 md5(13500000000)，字段长度为 32 字节 | |
| sha256_phone | string | SHA256 算法加密后的手机号，加密前为 11 位的纯数字串，加密后为不计大小写的 64 位数字字母串，字段长度为 64 字节 | |
| hash_android_id | string | C | Android设备填写，对 android_id 进行 MD5 编码，字段长度为 32 字节 |
| hash_oaid | string | C | Android设备填写，OAID 设备号 MD5 加密，加密前使用 OAID 原值直接 MD5，不要转换大小写或去连接符，加密后32位小写数字字母组合。例如：原文97e7ef3f-e5f2-d0b8-ccfc-f79bbeaf4841，加密后，87f8274c36eb73fabcbf143a10eca6a4 |
| md5_sha256_oaid | string | C | Android设备填写，OAID 设备号先采用 MD5 加密，再采用 SHA256 加密，加密前使用 OAID 原值直接 MD5，不要转换大小写或去连接符，加密后为64位数字字母组合，小写。例如：加密前 12AD57A5C1D04C00A5B2F2F32213C617fa44f21b8c8744531b222481150a846f，加密后7d36cf61fafac6df50aa7c874148e8241fcb57c61268037d19ed86389100bab0 |
| wechat_openid | string | C | 微信应用填写，wechat_openid 和 wechat_unionid 二者必选其一上报。微信 openid 是微信用户在公众号/小程序/小游戏 appid 下的唯一用户标识（appid 不同，则获取到的 openid 不同），可用于永久标记一个用户。您只能上传您已经获得授权关联的 APPID 内的 openID。否则会解析失败，字段长度为 64 字节 |
| wechat_unionid | string | C | 微信应用填写，微信数据源 wechat_openid 和 wechat_unionid 二者必选其一上报。微信 openid 是用户在公众号/小程序/小游戏下的唯一用户标识。例如：oWQ0O5MUpWG9P4WAZlhYUNTHwIj0。 微信数据源 user_action_set_id 类型为WECHAT, WECHAT_MINI_PROGRAM, WECHAT_MINI_GAME |
| wechat_app_id | string | C | 微信应用填写，微信分配的 APPID。请填写所填的 wechat_openid 对应的 APPID。请确保您已经获得所填 APPID 的授权关联，否则将无法通过鉴权。当您填写 wechat_openid 时，此项必填。当您未填 wechat_openid，此项填写无效。请注意，当所填 user_action_set_id 的类型为{WECHAT, WECHAT_MINI_PROGRAM, WECHAT_MINI_GAME}时，此字段必填，字段长度为 64 字节 |
| caid | string | C | iOS设备填写，全称 CAA Advertising id，中国广告协会互联网广告标。通过采集 IOS 系统 12 个非隐私参数使用固定规则生成的设备指纹，由数字与小写字母组成的 32 位长度的字符串。上报 caid 时 caid_version 为必填项，建议上报最新的 caid 版本，例如：0a211fcbca0f336a891fc798c4db757d，字段长度为 64 字节 |
| caid_version | integer | C | iOS设备填写，caid 版本编号。当前生效枚举值：[1005：中广协20220111；1006：中广协20230330]。建议上报最新的caid版本， 完整枚举值 |
| action_type | enum | Y | 标准行为类型，见 枚举值，当值为 'CUSTOM' 时表示自定义行为类型 |
| outer_action_id | string | 用户自定义的行为 id 标识，最大值 255 字节 | |
| action_param | object | 行为所带的参数，最大值 204800 字节 | |
| claim_type | integer | 归因类型，腾讯平台会基于归因类型进行对应方式的归因，见 枚举值 | |
| value | integer | 订单价值，单位：分，100代表1元。体现转化带来的价值，一般在 action_type 为 COMPLETE_ORDER 或 PURCHASE 行为时选填 | |
| object | string | 行为对象，例如 action_type 为 VIEW_CONTENT 时，object=product代表“商品页面浏览 | |
| length_of_stay | integer | 停留时间，单位：天，例如action_type为START_APP作为留存行为时必填，length_of_stay=1，表示上报的是次日留存行为。枚举值：1、3、5、7，对应归因优化目标次日留存、移动app 3日留存、移动app 5日留存、移动app 7日留存 | |
| consult_type | string | 咨询类型，见 枚举值 | |
| trust | integer | 反作弊过滤，广告主判定该转化行为，是否真实可靠。见 枚举值；为空/不上报，与trust=0处理逻辑一致 | |
| custom_action | string | 自定义行为类型，当 action_type=CUSTOM 时必填，最大值 128 字节 | |
| trace | object | 跟踪信息 | |
| click_id | string | 点击ID，user_id 与 click_id 二选一必填，广点通的click_id长度是20位数字+字母组合；微信的click_id长度是10-50，如wx0im5kwh44gh2yq，字段长度为 64 字节 | |
| url | string | C | 网页应用填写，url，请填写效果数据发生 h5 页面 URL 地址，如datanexus.qq.com，最大值 2048 字节 |
| product_inform | object | 商品信息 | |
| content_type | enum | 商品库行业。当您需要传输的商品信息为商品库行业标准类目时需要填写，详见 枚举值 | |
| product_catalog_id | string | 商品库 id。您已经同步到腾讯的商品库所对应的商品库 id，当填了商品 id 时，必须填写商品库 id，字段长度为 64 字节 | |
| product_id | string[] | 与行为相关的商品 id 列表。请填写商品库 id 内对应的商品 id，数组最大长度为 1000 | |
| category_path | string[] | 与行为相关的类目名称列表。对于所需回传的每一个商品类目，请按照“一级类目名称/二级类目名称/三级类目名称/四级类目名称”的格式回传完整类目路径，数组最大长度为 16 | |
| channel | enum | 渠道信息，标识该条行为发生在何渠道上，详见 枚举值，转化归因场景中，填写TENCENT或留空时，数据进入转化归因 | |
| ext_info | object | 拓展设备信息 | |
| package_name | string | app 安装包名称，长度最大 255 字节 | |
| app_version | string | app 安装包版本，长度最大 255 字节 | |
| mac | string | mac，长度最大 255 字节 | |
| device_brand | string | 设备品牌，长度最大 255 字节 | |
| model | string | 设备机型，长度最大 255 字节 | |
| os_version | string | 操作系统版本，长度最大 255 字节 | |
| language | string | 设备的系统语言，长度最大 255 字节 | |
| ip | string | 设备 ip，需上报行为发生时的 ip，长度最大 255 字节 | |
| user_agent | string | 设备 User-Agent 信息，长度最大 255 字节 | |
| wifi_name | string | 设备使用 wifi 名称，长度最大 512 字节 |
5.2.4 行业规范
针对 2.3 中的 action_type 和 action_param 做了进一步规范的行业如下。
金融 - 保险、金融 - 券商、金融 - 投顾、金融 - 银行、金融 - 贷款、金融 - 期货、金融 - 财商、金融 - 基金
本地生活 - 丽人、本地生活 - 结婚摄影、本地生活 - 婚恋服务、本地生活 - 家政、本地生活 - 餐饮休娱、本地生活 - 加盟
6 归因结果检查
在 日志查询 页面，查看“归因结果” 列信息。
- 操作后需等待 1- 3 小时（此为日志功能处理时长，不等同于归因时长，广告归因为实时归因）；
- 广告预览中产生的数据也可在 DataNexus - 日志查询中查看归因结果。
注：
FAQ
Q：回传用户行为数据用于归因时，有哪些特殊要求？
A：前提条件：数据源已开启给「转化归因」的分发开关
1）当填写的用户行为数据源类型为 { WECHAT公众号，WECHAT_MINI_PROGRAM小程序，WECHAT_MINI_GAME小游戏 } 时，必填user_id字段中的wechat_openid（或wechat_unionid）及wechat_appid。
2）通过 DataNexus 上报用户行为数据时，必须对“行为数据源-微信行为” 操作 申请微信AppID，微信行为数据源需要授权，归因需要识别数据源 AppID 的绑定。
3）DataNexus 上报，如果是上传 Openid/Unionid 行为数据，使用web数据源（微信生态的归因时，如果回传了 appid，只支持公众号推广 pt 的归因，不能支持销售线索 pt 的归因，所以需要选 Web 数据源）。
Q：上报的数据如何做归因去重？
A：用户自定义的行为 id 标识 outer_action_id为去重字段。当上报的数据满足“数据源id”、“行为类型（action_type）”和“outer_action_id”一致时，去重 id 就会生效。
Q：如果需要回传腾讯渠道的历史数据，怎么避免重复归因？
A：如客户已使用 AppID 创建过开启转化归因的数据源，建议客户单独创建其它类型的数据源（如 Web 类型或者线下类型），或者在另外的账号下使用相同 AppID 创建数据源，同时注意不要开启归因开关，用于回传腾讯渠道的历史数据。
Q：上报到数据源的数据不归因？
A：根据 日志查询 的页面提示，请在 资产分发 中确认该数据源是否已开启「转化归因」分发开关，开启后，上报的数据才会进入归因。