帮助中心
|
S2S 广告收入
如果您是自己跟踪广告收入,就可以以服务器到服务器 (S2S) 的方式发送数据,同时查看 Adjust 跟踪的所有其他指标及广告收入数据。这样,您就能全面查看推广活动的表现,计算用户的生命周期价值 (LTV),提高推广活动的广告支出回报率 (ROAS) 和投资回报率 (ROI)。
以 S2S 的方式向 Adjust 发送您的广告收入数据,并在控制面板的统计数据和同期群中查看。
操作前须知
以下是您在操作前需要了解的内容。
适用条件
- 已购买广告收入套餐
实用信息
- 通过 S2S 方式发送的广告收入会被添加至广告收入 KPI 和同期群数据中,用于计算 LTV 和 ROAS。
发送 S2S 广告收入
我们接受以下类型的 S2S 广告收入请求:
- 含 URL 参数的 GET
- 含 URL 参数的 POST(无主体 no body)
- 含作为 Content-Type 的正文参数的 POST
application/x-www-form-urlencoded
设置 S2S 安全
设置 S2S 安全,可保护 S2S 广告收入的安全,抵御欺诈请求的侵害。设置认证后,每个传入的请求都必须带有您在 Adjust 控制面板中生成的识别码。识别码缺失或错误的请求会被我们的服务器拒绝。要开始设置,请按S2S 安全文档中的步骤操作
请注意:
必要参数
如需发送广告收入到 Adjust,请发送以下参数到 https://s2s.adjust.com/ad_revenue
:
参数 | 描述 | 示例 |
---|---|---|
idfa ; gps_adid ; 等. | 不同平台的设备 ID (参阅完整列表) | idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E |
app_token | 控制面板上的 Adjust 应用识别码 | app_token=4w565xzmb54d |
s2s | s2s 参数设置为 1 | 1 |
revenue 或 amount | 设备上生成的广告收入额 | 4.99 |
currency | 收入使用的币种 如果您的事件请求中包含带有值的 {revenue} 或 {amount} 参数,就必须要附加 {currency}。当此参数缺失时,我们的后端会拒绝该请求。 | USD |
ad_impressions_count | 与收入相关的广告展示次数 (大于 0 的整数) | 100 |
source | 始终是 publisher (广告发行商) | publisher |
非必要但推荐发送的参数: | ||
adid | Adjust 设备 ID(所有平台) | 18546f6171f67e29d1cb983322ad1329 |
created_at_unix
(推荐)
或
created_at | 向用户展示广告时的确切时间 (不应为早于 28 天前的时间点) | created_at_unix=1484085154 or created_at=2017-01-02T15:04:05.000+0000 |
environment | 当前 SDK 的环境设置 | production 或 sandbox |
其他推荐回传参数
参数 | 描述 | 示例 |
callback_params | 用来将回传参数作为 JSON 对象 (适当转义,字符串转字符串) 进行传递 | callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D |
ad_revenue_network | 其他广告收入相关的数据 | ad_revenue_network=Admob |
ad_revenue_unit | 其他广告收入相关的数据 | ad_revenue_unit=rewarded_video |
ad_revenue_placement | 其他广告收入相关的数据 | ad_revenue_placement=home_screen |
附加识别码的 POST 请求示例:
curl -X POST -H "Authorization: Bearer b9eb9d6228842aeb05d64f30d56b361e" "https://s2s.adjust.com/ad_revenue?app_token=abc123abc123&idfa=FAD135C7-C5F8-4DCC-9478-2203956B0870&source=publisher&ad_impressions_count=1&revenue=0.01¤cy=USD&s2s=1"
成功响应示例:
{"status":"OK"}
错误响应示例:
{"error":"Ad revenue request failed (wrong authentication token) (app_token:abc123abc123)"}