广告支出 API
集成 Adjust 广告支出 API 后,您的客户便可接收比以往准确度更高、更加透明且精细的全自动广告支出数据。广告支出数据可在点击、展示或安装后的 7 天窗口内以非同步方式发送。本文将向您介绍集成 Adjust 广告支出 API 的条件和流程。

集成广告支出 API 的要求

为了集成 Adjust 广告支出 API,您需要设置服务器,通过向我们的指定终端发送 HTTPS POST 请求,向 Adjust 发送一系列必传参数。注意:您可以在用户交互后的 7 天窗口内,随时将广告支出数据发送给 Adjust。

终端地址

https://app.adjust.com/cost

参数

参数示例描述必传参数
cost_typecpi定价模型——必须为 cpccpicpm
cost_currencyusdISO 4217 货币代码。请参阅我们支持币种的完整清单
cost_amount1.99成本浮点值
最大长度:小数点后 5 位
cost_id3P4OXS8dMAQbqn4Y将成本数据和交互进行匹配的唯一值
最小长度:12 个字符
最大长度:256 个字符
标签my_network用于日志记录和调试的标签
最大长度:128 个字符

请求示例

curl -d "cost_type=cpi&cost_currency=usd&cost_amount=2&cost_id=abc123_company_name_test_1&tag=company_name_test" -X POST https://app.adjust.com/cost
如果请求成功,您将收到 OK 响应。如果发生格式错误,您将收到 Bad Request 响应。如果您在设置格式时需要帮助,请联系我们的集成团队:wizards@adjust.com

什么是 cost_id

您可以通过 cost_id 向我们发送长度在 12 到 256 个字符之间的唯一值。我们使用 cost_id 参数来准确匹配我们所收到的成本数据与点击或展示。最佳实践:
  • 您可使用既有的 click_idimpression_id
    • 注意:您必须使用 cost_id 参数来发送 cost_id 值(即使您已将该值包含在其他参数中)
  • 为了避免在匹配时与我们的其他渠道合作伙伴冲突,cost_id 值必须为唯一值。我们建议您使用通用唯一标识符 (UUID) 或在 ID 上加上您公司名前缀(例如 network_name_848dsf4939fgwjn028erg4)。
  • 如果您还未生成自己的点击或展示 ID,则可以使用两个或多个占位符组合成 ID。例如,对于单次安装成本 (CPI),您可以将用户 IDFA 和应用 ID 组合在一起使用。

通过 Adjust 跟踪 CPM

若要向 Adjust 传输 CPM 数据,您可通过展示跟踪链接发送 cost_id,并将其引用在广告支出 API 调用中。请确保您随每个展示发送了 CPM(即单次展示成本 x 1000)。

完成与 Adjust 广告支出 API 的集成

在您完成服务器的配置,发送给我们必需参数(和任何可选参数)后,请发送电子邮件至 wizards@adjust.com 联系 Adjust。我们将为您准备集成测试。

我们会为您提供一系列测试,以便您查看不同成本类型的误差情况,并在集成上线之前及时发现任何潜在的问题。我们还会在 Adjust 后端进行测试,以确保 API 集成顺利进行。

在全部的测试都通过后,我们将与您和您的客户联系,并将您纳入已集成广告支出合作伙伴的名单中,自此您便成为 Adjust 官方广告支出 API 合作伙伴。

有关此主题