应用推广-转化对接说明文档

前言：产品使用介绍

此产品适用于广告主投放自有 APP 的场景，用户的转化行为发生在广告主自有 APP 中。采用此产品跟踪，您需要与平台进行接口对接，追踪应用下载转化效果。对接过程需要广告主的技术人员参与完成 API 对接工作。​

一、为什么要使用转化跟踪工具?

目前应用推广类广告支持“激活”、“注册”、“付费”、“首活”、“次留”等转化目标，但媒体只能监测到媒体APP内的广告展示和点击行为，无法监测到用户在客户自有APP 发生的转化行为。通过使用转化跟踪工具，可有效打通广告主和媒体的数据连接通路，完成转化跟踪和进一步的归因。​

通过上报转化数据，可有效衡量广告投放效果，并且让广告系统找到更多高价值用户，从而优化广告效果，提升广告投放效率。​

二、跟踪类型说明

我们支持以下三种跟踪类型

2.1 跟踪应用

一般适用于应用推广场景，广告主推广标的为自有 APP 内转化行为。通过对接媒体的点击上报服务、转化回传服务等步骤实现转化数据跟踪和上报。跟踪应用转化事件仅可用于推广类型为“应用推广”的广告组。​

2.2 跟踪小程序

一般适用于小程序推广场景，广告主推广标的为微信小程序内转化行为。要求广告点击的首次跳转落地页必须为微信小程序页面，即用户行为路径为：看到广告 -> 点击广告 -> 跳转至广告主微信小程序页面 -> 在微信小程序内完成指定转化行为。常用场景包括：教育行业-小程序获客、游戏行业-微信小程序游戏变现等。跟踪小程序转化事件仅可用于推广类型为“销售线索收集”的广告组。​

2.3 跟踪线索

一般适用于非以上两种情况的场景，常用场景包括：

•
教育行业-销售线索收集：表单提交、有效咨询等推广目标；​

•
微信小程序客户：首次跳转落地页在媒体内打开（非微信小程序页面）；​

•
其他。​

三、应用跟踪实现原理

广告主按要求填写点击监测链接和拼接预留宏参数。 媒体会自动替换这些宏参数并下发给广告主，提供给广告主广告展示点击用户的IDFA、OAID、ANDROIDID、CAID等用户设备信息、回调链接及其他相关信息，广告主将其与自己监测到的转化用户的相关信息进行匹配后，通过回调链接回传转化数据给媒体。​

四、应用推广类API对接流程

•
广告主按要求填写点击监测链接并投放广告，用户在 APP 内点击广告；​

•
媒体侧向广告主上报点击事件：调用广告主填写的点击监测链接，并替换宏参数，上报用户设备信息、转化回调链接及其他相关信息；​

•
用户在广告主 APP 产生转化；​

•
广告主根据媒体上报的设备信息与自己 APP 监测到的转化设备信息进行匹配归因；​

•
广告主将用户转化事件通过转化回调链接回传给媒体。​

4.1 对接点击上报服务

广告主在新建应用转化时，需要填写点击监测链接，用来接收媒体上报的点击事件，进而完成转化归因。​

4.2 通信协议

支持通过HTTP或HTTPS通道进行请求通信。为了获得更高的安全性，推荐您使用HTTPS通道；如果您使用的是http通道，需保证也能支持https通道。​

4.3 请求方法

支持GET方法发送请求，这种方式下请求参数需要包含在请求的URL中。​

4.4 格式要求

点击监测链接主要由四部分组成：

https://www.xxx.com? + 自选宏参数 + 回调链接宏参数 +自定义参数（可选）

具体格式如下：

•

前缀：广告主自有或三方点击监测服务的地址，格式为“https://www.xxx.com?”

•
回调链接宏参数：媒体接受广告主转化回传的地址，广告主将用户的转化事件通过此链接回传给媒体。必须填写，格式为“广告主自定义参数名=_CALLBACK_URL_”，如“callback_url=_CALLBACK_URL_”​

•
“自选宏参数”：广告主需要在点击监测链接后拼接宏参数占位符，用以获取归因/回传所必要的信息（如OAID/IDFA/回调链接）。用户点击广告后，媒体会动态替换约定好的宏参数并上报给点击监测地址，广告主即可获取到广告点击的相关信息。广告主可以根据需要自选参数，格式为“广告主自定义参数名=_参数_”。其中，平台支持的宏参数范围请见下方附件一“点击监测链接支持的参数列表”， “参数”须严格按照附件中的值拼写，否则无法识别。​
◦
“_参数_”必须全部大写​
◦
“_参数_”格式中参数两边为单下划线，即参数左右两边均为单个英文字符'_'​

•
广告主自定义参数（不在媒体支持的宏参数范围内）：自定义参数名和固定值，由广告主自定义，媒体不做替换。如 source=rrtv，标记为该媒体的点击上报​

•
点击监测链接支持大小写字母、数字以及下划线字符，多个参数中间使用“&”连接​

点击监测链接示例：

https://www.xxx.com? &callback_url=_CALLBACK_URL_&ip=_IP_&os=_OS_&oaid=_OAID_&oaidmd5=_OAIDMD5_&androidid=_ANDROIDID_&idfa=_IDFA_&caid=_CAID_&caid2=CAID2

五、广告主归因

由广告主或广告主对接的第三方机构完成。广告主在收到媒体上报的点击事件后，进行转化归因。媒体会替换广告主选择的宏参数，如广告主广告点击用户的IDFA、OAID、ANDROIDID、CAID等设备信息，广告主将其与自己监测到的转化用户的相关信息进行匹配，完成转化归因。​

六、对接转化事件回调服务

在完成归因后，广告主需要将相应的转化事件信息通过请求上报点击事件里的回调链接回传给媒体服务器，并以此计算一次转化。​

6.1 回调链接

媒体在点击事件上报时下发的 callback URL。广告主需完成以下操作后，请求此链接完成转化事件回传。​

应用推广-转化对接说明文档​

应用推广-转化对接说明文档