应用推广 · 转化对接说明

前言产品使用介绍

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

01为什么要使用转化跟踪工具？

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

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

02跟踪类型说明

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

2.1 跟踪应用

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

2.2 跟踪小程序

一般适用于小程序推广场景，广告主推广标的为微信小程序内转化行为。 要求广告点击的首次跳转落地页必须为微信小程序页面，即用户行为路径为：

看到广告 → 点击广告 → 跳转至广告主微信小程序页面 → 在微信小程序内完成指定转化行为

常用场景包括：教育行业小程序获客、游戏行业微信小程序游戏变现等。 跟踪小程序转化事件仅可用于推广类型为「销售线索收集」的广告组。

2.3 跟踪线索

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

• 教育行业销售线索收集：表单提交、有效咨询等推广目标；
• 微信小程序客户：首次跳转落地页在媒体内打开（非微信小程序页面）；
• 其他。

04应用推广类 API 对接流程

1. 广告主填写点击监测链接并投放广告用户在 APP 内点击广告。
2. 人人视频向广告主上报点击事件调用广告主填写的点击监测链接，并替换宏参数，上报用户设备信息、转化回调链接及其他相关信息。
3. 用户在广告主 APP 产生转化
4. 广告主完成匹配归因根据人人视频上报的设备信息与自己 APP 监测到的转化设备信息进行匹配归因。
5. 广告主回传转化事件通过转化回调链接回传给媒体。

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__

05广告主归因

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

06对接转化事件回调服务

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

6.1 回调链接

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

• 解码：callback URL 字段值需先做 UTF-8 decode 解码。 即，使用标准 HTML、application/x-www-form-urlencoded、UTF-8 对获取到的 callback URL 解码。 如使用 java.net.URLDecoder#decode(java.lang.String) 解码。
• 替换转化事件类型参数值：callback URL 中 type 默认是激活（act）。 如需支持其他事件，需要替换 type 取值。type 支持的事件类型及其枚举值请参考附件二。

callback URL 示例 · 激活

http://monitor.adwutong.com/ad-action/click/callback?uid=535430
  &timestamp=1730881957135&ip=43.247.101.206&os=android
  &imeiMd5=__IMEI_MD5__&oaid=54797b1a24ca9a42
  &androidId=c2ab64a3c6ff6c6a&materialId=76279352
  &idfa=__IDFA__&type=act
  &invokeId=700837507&responseId=17284651019595

http://monitor.adwutong.com/ad-action/click/callback?uid=535430
  &timestamp=1730881957135&ip=43.247.101.206&os=android
  &imeiMd5=__IMEI_MD5__&oaid=54797b1a24ca9a42
  &androidId=c2ab64a3c6ff6c6a&creativeId=76279352
  &idfa=__IDFA__&type=pay
  &invokeId=700837507&responseId=17284651019595&pay_amount=166.50

http://monitor.adwutong.com/ad-action/click/callback?uid=535430
  &timestamp=1730881957135&ip=43.247.101.206&os=android
  &imeiMd5=__IMEI_MD5__&oaid=54797b1a24ca9a42
  &androidId=c2ab64a3c6ff6c6a&creativeId=76279352
  &idfa=__IDFA__&type=act
  &invokeId=700837507&responseId=17284651019595&gender=0

6.2 通信协议

目前接口仅支持通过 HTTP 方式进行请求通信。

6.3 请求方法

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

6.4 返回值

成功：HTTP code 200，标准返回值如下；失败：其他值。

{
    "type":"SUCCESS",
    "text":null,
    "data":null,
    "errors":[]
}

07渠道包投放场景转化回调服务

说明：适用于 PC 游戏、安卓游戏等渠道包投放场景，将渠道包投放带来的转化事件进行转化回调。
适用归因方式：渠道包归因（apk 下载包／exe 下载包）、落地页 URL 渠道跟踪参数归因。

7.1 对接转化事件回调服务

完成归因后，用户在应用中达成转化事件时，广告主需要通过 API 回调媒体用户转化事件。

7.2 通信协议

目前接口仅支持通过 HTTP 方式进行请求通信。

7.3 请求方法

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

7.4 参数说明

7.5 请求示例

回调链接地址示例

http://monitor.adwutong.com/ad-action/click/callback?type=act
  &timestamp=1767241503000&trackId=559367194&ip=192.168.1.1
  &oaid=54797b1a24ca9a42
  &ua=Mozilla%205.0(Linux%20Android4.0.4%20GTI9220%20Build%20IMM76D)&pay_amount=6.48

Java（OkHttp）

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("http://monitor.adwutong.com/ad-action/click/callback?oaid=54797b1a24ca9a42&type=act&timestamp=1767241503000&trackId=559367194&ip=192.168.1.1&ua=Mozilla%205.0(Linux%20Android4.0.4%20GTI9220%20Build%20IMM76D)&pay_amount=6.48")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

cURL

curl --location 'http://monitor.adwutong.com/ad-action/click/callback?oaid=54797b1a24ca9a42&type=act&timestamp=1767241503000&trackId=559367194&ip=192.168.1.1&ua=Mozilla%205.0(Linux%20Android4.0.4%20GTI9220%20Build%20IMM76D)&pay_amount=6.48'

7.6 返回值

{
    "type":"SUCCESS",
    "text":null,
    "data":null,
    "errors":[]
}