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 广告收入发送给 Adjust?

常见问题

设置 S2S 安全

设置 S2S 安全,可保护 S2S 广告收入的安全,抵御欺诈请求的侵害。设置认证后,每个传入的请求都必须带有您在 Adjust 控制面板中生成的识别码。识别码缺失或错误的请求会被我们的服务器拒绝。要开始设置,请按S2S 安全文档中的步骤操作

请注意:
在控制面板中激活 S2S 认证之前,请务必测试广告收入请求中是否已正确附加验证码。

必要参数

如需发送广告收入到 Adjust,请发送以下参数到 https://s2s.adjust.com/ad_revenue:

参数描述示例
idfa; gps_adid; 等. 不同平台的设备 ID (参阅完整列表)idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E

gps_adid=660e1d86-6796-463a-be86-897993136018
app_token控制面板上的 Adjust 应用识别码app_token=4w565xzmb54d
s2ss2s 参数设置为 11
revenueamount设备上生成的广告收入额4.99
currency收入使用的币种

如果您的事件请求中包含带有值的 {revenue} 或 {amount} 参数,就必须要附加 {currency}。当此参数缺失时,我们的后端会拒绝该请求。
USD
ad_impressions_count与收入相关的广告展示次数 (大于 0 的整数)100
source始终是 publisher (广告发行商)publisher
非必要但推荐发送的参数:
adidAdjust 设备 ID(所有平台)18546f6171f67e29d1cb983322ad1329
created_at_unix (推荐) 或 created_at向用户展示广告时的确切时间 (不应为早于 28 天前的时间点)created_at_unix=1484085154

or

created_at=2017-01-02T15:04:05.000+0000
environment当前 SDK 的环境设置 productionsandbox

其他推荐回传参数

参数
描述
示例
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&currency=USD&s2s=1"

成功响应示例:

{"status":"OK"}

错误响应示例:

{"error":"Ad revenue request failed (wrong authentication token) (app_token:abc123abc123)"}