使用合作伙伴广告支出 API,向 Adjust 发送与推广活动相关的广告支出信息。Adjust 可接受交互发生后 最多 7 天 的广告支出数据。
设置成本 ID
- 成本 ID
-
唯一广告支出交互标识符,长度在 12 - 256 个字符之间 。
每次调用合作伙伴广告支出 API 时,您必须提供与推广活动关联的唯一 成本 ID 。Adjust 会使用成本 ID,匹配随点击或展示发送的广告支出数据。
成本 ID 必须是唯一的。Adjust 强烈建议您使用通用唯一标识符 (UUID) 或在 ID 上加入公司名前缀。例如: network_name_848dsf4939fgwjn028erg4
您可以使用已有的 click_id
或 impression_id
。如果您不生成自己的点击或展示 ID,则可以将两个或多个占位符组合在一起构建 ID。例如,对于单次展示成本 (CPI),您可以将用户 IDFA (广告主 ID) 和应用 ID 组合在一起。
使用 Adjust 监测 CPM
要向 Adjust 发送 CPM (每千次展示成本) 数据,请向您的展示 URL 添加 cost_id
参数,其值需要与合作伙伴广告支出 API 调用中发送的 cost_id
相同。在监测 CPM 时,您必须随 每次 展示发送 CPM。
发送广告支出数据
向 /cost
终端发送 POST 请求,以向 Adjust 发送广告支出信息。
参数
您必须在每个请求中发送以下参数。所有 查询参数 都必须为小写。
cost_type
(String
)-
定价模型。例如:
cpc
、cpi
、cpe
。 cost_currency
(String
)cost_id
(String
)-
您的唯一成本 ID。请参阅上文的成本 ID 部分,了解更多信息。
tag
(String
)-
用于日志记录和调试的标签。该值最大长度不得超过 128 个字符。
示例
响应
200 Success
-
广告支出信息已提交至 Adjust。
400 Bad request
-
您的请求格式不正确。确保包含所有必要参数。
401 Unauthorized
-
您未能提供必要的认证信息,因此您的请求未被处理。请发送邮件至 wizards@adjust.com,设置您的合作伙伴凭证。
403 Forbidden
-
您提供的凭证权限不足,无法发布您发送的信息。请发送邮件至 wizards@adjust.com,进行故障排查。
测试集成
完成服务器配置,可发送所需的参数后,请联系 wizards@adjust.com,Adjust 会为您提供一系列测试。您可以检查不同广告支出类型中的差异,在集成上线之前发现并解决任何问题。我们还会针对 Adjust API 进行测试,确保 API 集成顺利进行并能正常运作。
测试完成后,Adjust 会将您添加至集成广告支出合作伙伴列表。