adjust-icon

合作伙伴广告支出推送 API

使用合作伙伴广告支出 API,向 Adjust 发送与推广活动相关的广告支出信息。Adjust 可接受交互发生后 最多 7 天 的广告支出数据。

设置成本 ID

成本 ID

唯一广告支出交互标识符,长度在 12 - 256 个字符之间

每次调用合作伙伴广告支出 API 时,您必须提供与推广活动关联的唯一 成本 ID 。Adjust 会使用成本 ID,匹配随点击或展示发送的广告支出数据。

成本 ID 必须是唯一的。Adjust 强烈建议您使用通用唯一标识符 (UUID) 或在 ID 上加入公司名前缀。例如: network_name_848dsf4939fgwjn028erg4

您可以使用已有的 click_idimpression_id。如果您不生成自己的点击或展示 ID,则可以将两个或多个占位符组合在一起构建 ID。例如,对于单次展示成本 (CPI),您可以将用户 IDFA (广告主 ID) 和应用 ID 组合在一起。

使用 Adjust 监测 CPM

要向 Adjust 发送 CPM (每千次展示成本) 数据,请向您的展示 URL 添加 cost_id 参数,其值需要与合作伙伴广告支出 API 调用中发送的 cost_id 相同。在监测 CPM 时,您必须随 每次 展示发送 CPM。

发送广告支出数据

终端
POST https://app.adjust.com/cost

/cost 终端发送 POST 请求,以向 Adjust 发送广告支出信息。

参数

您必须在每个请求中发送以下参数。所有 查询参数 都必须为小写。

cost_type (String)

定价模型。例如:cpccpicpe

cost_currency (String)

广告支出信息的货币代码。必须采用 ISO 4217 货币代码格式。请参阅我们支持币种的完整清单

cost_id (String)

您的唯一成本 ID。请参阅上文的成本 ID 部分,了解更多信息。

tag (String)

用于日志记录和调试的标签。该值最大长度不得超过 128 个字符。

示例

cURL
$ curl -X POST https://app.adjust.com/cost \
-d "cost_type=cpi&cost_currency=usd&cost_amount=2&cost_id=abc123_company_name_test_1&tag=company_name_test"

响应

200 Success

广告支出信息已提交至 Adjust。

400 Bad request

您的请求格式不正确。确保包含所有必要参数

401 Unauthorized

您未能提供必要的认证信息,因此您的请求未被处理。请发送邮件至 wizards@adjust.com,设置您的合作伙伴凭证。

403 Forbidden

您提供的凭证权限不足,无法发布您发送的信息。请发送邮件至 wizards@adjust.com,进行故障排查。

测试集成

完成服务器配置,可发送所需的参数后,请联系 wizards@adjust.com,Adjust 会为您提供一系列测试。您可以检查不同广告支出类型中的差异,在集成上线之前发现并解决任何问题。我们还会针对 Adjust API 进行测试,确保 API 集成顺利进行并能正常运作。

测试完成后,Adjust 会将您添加至集成广告支出合作伙伴列表