资源报告 API
使用 Reporting API 来获取 JSON 或 CSV 格式的聚合资源层级 Campaign 数据。
昨天的数据在 UTC 时间上午 6:00 之后保持稳定。
请求格式
向以下基础 URL 发送 HTTP GET
请求,以生成报告请求: https://r.applovin.com/assetReport
必要参数
参数 | 用途 |
---|---|
api_key | 您的 Report Key<br />您可以在 Axon 控制面板 中找到自己的 Report Key,方法是在控制面板右上方点击您的账户,然后选择 <UILabel>Keys</UILabel> 或在 AppLovin 控制面板中打开账户页面的 <UILabel>Keys</UILabel> 选项卡。 |
range | 本报告的时间范围。有效值:yesterday 、last_7d |
columns | 报告列 (通过逗号分隔的列表) 请参阅下方允许使用的列。示例: day,creative_set_id,impressions 。 |
可选参数
参数 | 用途 |
---|---|
format | 报告格式 接受 json 或 csv 。默认为 json 。 |
limit | 您要返回的行数限制;示例:500 (使用 limit 和 offset 对结果进行分页) |
offset | 开始调取行的偏移位置;示例:100 (使用 limit 和 offset 对结果进行分页) |
可用列
列名称 | 包含信息 |
---|---|
asset_id | 资源 ID。与 Axon campaign Management API 中返回的资源 ID 相匹配 |
clicks | 点击量 |
cost | 广告主支出 |
ctr | 点击量 ÷ 展示量 |
impressions | 展示量 |
过滤列
您可以按 asset_id
过滤报告。
这样您就可以搜索符合过滤器的内容。
要按列过滤,请添加以下 URL 参数:<code>filter_<var>columnname</var>=<var>onefilter,anotherfilter,thirdfilter</var></code>
例如,如果您只想查看 asset_id
12345
的数据,就需要设置以下 URL 参数:asset_id=12345
您可使用排除过滤器即 <code>filter_not_<var>columnname</var>=<var>onefilter,anotherfilter</var></code>。
列的排序
报告排序的方法与过滤报告的方法类似。
例如,若要按 impressions
对报告进行排序,您需要添加以下 URL 参数:sort_impressions=ASC
可接受的值为 ASC
(升序) 或 DESC
(降序)。所有排序均按字典顺序。
请求示例
https://r.applovin.com/assetReport?api_key=«your-report-key»&start=2025-08-01&end=2025-08-10&columns=day%2Casset_id%2Ccreative_set_id%2Cimpressions%2Cclicks%2Ccost&format=json&limit=100&sort_impressions=DESC