媒体方回传

像奖励型应用、冲榜媒体这样使用自有跟踪系统的媒体方，会要求「发生转化时请通知我们的地址」。adstage 以按链接配置的方式处理这类需求。只要填入媒体方提供的回调 URL，当通过该链接进入的用户触发安装、购买等事件时，adstage 就会代为调用媒体方的地址。

无需为每家媒体方单独开发。拿到规格后在仪表板中填写即可立即完成对接。

1. 在哪里设置

在 深度链接 > 创建 或现有链接的详情页面中，打开 媒体方回传 区块。设置是按链接分别保存的，因此请按媒体方分别创建链接，并在各链接中填入该媒体方的地址。

2. 设置项

如果媒体方说「点击时我们会用名为 cb 的参数传递我们的点击 ID」，就在 点击 ID 参数名 中填入 cb。

3. URL 模板与宏

将媒体方提供的地址原样粘贴，并在需要填入值的位置使用宏。

https://postback.network.com/install?cb={click_id}&adid={adid}

可以使用的宏如下。

媒体方要求列表中没有的宏时

如果媒体方要求 {sub_id}、{pub_id} 这类他们专用的值，直接照写即可。 列表中没有的宏会以**把点击时以该名称传入的参数原样回送（echo）**的方式运作。

也就是说，如果媒体方在点击 URL 上附加了 ?sub_id=abc123，那么回传中 {sub_id} 的位置就会被填入 abc123。

请注意

如果点击时没有传入该参数，发出时就会是空值。请确认媒体方规格中的参数是否确实包含在实际的点击 URL 中。

4. 工作方式

1. 用户点击媒体方广告，进入 adstage 跟踪链接。此时点击 ID 与媒体方参数会一并被记录。

2. 该用户安装应用或触发所设置的事件时，adstage 会通过归因找出对应的媒体方点击。

3. 将 URL 模板中的宏替换为实际值，并调用媒体方地址。

防止重复

对于同一次点击，同一事件只会发送一次。即使用户多次打开应用或事件被重复收集，也不会向媒体方发送两次。

install 与 first_open 这类含义相同的事件名称会被归并处理，因此即使两者都进来，回传也只会发出一次。

失败时重试

如果媒体方服务器暂时没有响应，为了不让转化悄悄丢失，系统会自动重试。

5. 对接前需要向媒体方确认的事项

与新媒体方对接时，只需拿到以下四项。

1. 回传 URL — 安装用的地址，如果另有事件用的地址也一并提供
2. 点击 ID 参数名 — 在点击 URL 中用什么名称附加标识符
3. 需要的宏列表 — 希望接收哪些值
4. 目标事件 — 只需要安装，还是也需要购买等其他事件

6. 注意事项

• 回传设置以链接为单位。向同一家媒体方提供多个链接时，必须在每个链接中都进行设置。
• 必须成立归因才会发送回传。未经过媒体方链接的流量不在对象范围内。
• URL 中填入的值会自动进行 URL 编码。请不要在宏的位置预先填入已编码的值。
• 有些媒体方会通过响应正文区分成功/失败。adstage 仅根据 HTTP 状态码判定，并将 2xx 与 3xx 视为成功。如果媒体方在正文中带上错误却以 200 响应，adstage 将无法识别失败，因此请要求其在出错时返回 4xx、5xx。