AppLovin Asset Reporting API

最近更新 2026/10/05

提示

请注意，第三方数据集成产生的数据会被纳入集群的消耗数据量

概要

接口简介

接口名	类型	粒度	归因	成本	收益	展示	点击	转化
Asset Reporting API	API	素材聚合数据		✅		✅	✅

AppLovin Asset Reporting API 用于获取素材层级的聚合投放数据，包括素材、广告计划、广告组、曝光、点击和成本等信息。

当前集成使用 AppLovin 的日期型 Asset Reporting API：

GET https://r.applovin.com/assetAnalyticsReport

AppLovin 说明昨日数据在 UTC 06:00 后稳定。接口只允许请求最近 45 天的数据。

集成流程

1. 登录 AppLovin 后台，获取 Report Key。
2. 登录 AE 后台，进入三方集成模块，新建 AppLovin Asset Reporting API 方案并完成配置。
3. 执行单次拉取或等待定时任务，确认事件表成功接收数据。
4. 基于素材、广告计划、广告组、成本、曝光和点击等字段搭建分析报表。

一、获取 Report Key

接入 Asset Reporting API 前，需要先获取 Report Key。请登录 AppLovin 后台，在「Account」-「Keys」中获取并妥善保管。

二、方案配置

2.1 授权信息配置

点击「授权信息」下的「配置授权信息」按钮，在弹出框内填写 AppLovin Report Key。

2.2 定时拉取

您可以在「定时拉取」模块设置数据拉取策略。建议每天 UTC+8 16:00 拉取过去 1 天的数据，此时 AppLovin 的昨日数据已超过 UTC 06:00 的稳定时间。

2.3 事件表入库设置

Asset Reporting API 数据用于事件表分析。创建方案时请开启「事件表入库设置」，拉取的数据将写入配置的事件名中。

2.4 集成配置

集成配置是一个 JSON 对象，可以设置入库事件名、请求列、数值字段类型及接口筛选参数。

模块	名称	类型	含义
sink_event	event_name	字符串	入库后的事件名，可以自定义
source	group_by	字符串列表	请求的素材和广告层级维度
source	metrics	字符串列表	请求的数值指标
transfer	double_columns	字符串列表	按数值类型写入的指标字段
顶层参数	limit	字符串	每个日期请求最多返回的行数
顶层参数	offset	字符串	每个日期请求开始读取数据的偏移量
顶层参数	not_zero	整数	配置为 1 时，排除所有数值指标均为 0 的结果
顶层参数	allPurpose	JSON 字符串	维度筛选、排除筛选和数值阈值筛选

默认模板

{
  "sink_event": {
    "event_name": "applovin_asset_report"
  },
  "sink_user": [],
  "source": {
    "group_by": [
      "asset_id",
      "asset_name",
      "asset_url",
      "campaign",
      "campaign_id",
      "campaign_package_name",
      "creative_set",
      "creative_set_id"
    ],
    "metrics": [
      "clicks",
      "cost",
      "ctr",
      "impressions"
    ]
  },
  "transfer": {
    "double_columns": [
      "clicks",
      "cost",
      "ctr",
      "impressions"
    ]
  }
}

模板说明：

• source.group_by 与 source.metrics 会合并为 AppLovin 请求中的 columns 参数。
• clicks、cost、ctr、impressions 应同时配置到 transfer.double_columns，确保按数值类型写入。
• 模板事件名为 applovin_asset_report，可以按实际需要修改。
• 系统固定请求 format=json，并固定使用 sort_impressions=DESC 按曝光量降序排序。

带筛选和分页参数的完整示例

以下示例表示：筛选指定的两个素材名，只保留 cost > 10 且 impressions > 2000 的数据，排除所有数值指标均为 0 的结果，每个日期从第 1 行开始最多读取 100 行。

{
  "limit": "100",
  "offset": "0",
  "not_zero": 1,
  "allPurpose": "{\"asset_name\":\"素材A.mp4,素材B.html\",\"greater_than_cost\":10,\"greater_than_impressions\":2000}",
  "sink_event": {
    "event_name": "applovin_asset_report"
  },
  "sink_user": [],
  "source": {
    "group_by": [
      "asset_id",
      "asset_name",
      "asset_url",
      "campaign",
      "campaign_id",
      "campaign_package_name",
      "creative_set",
      "creative_set_id"
    ],
    "metrics": [
      "clicks",
      "cost",
      "ctr",
      "impressions"
    ]
  },
  "transfer": {
    "double_columns": [
      "clicks",
      "cost",
      "ctr",
      "impressions"
    ]
  }
}

2.5 可选维度与指标

可选维度

请将需要的维度写入 source.group_by。

字段名	是否默认	含义
asset_id	是	素材 ID
asset_name	是	素材名称
asset_url	是	处理前原始素材的 URL
campaign	是	Campaign 名称
campaign_id	是	Campaign 唯一标识，与 Basic Reporting API 的 campaign_id_external 对应
campaign_package_name	是	Campaign 推广应用的包名
creative_set	是	Creative Set 名称，即广告组名称
creative_set_id	是	Creative Set ID，名称变化时 ID 保持不变

可选指标

请将需要的指标写入 source.metrics，并将数值字段同时写入 transfer.double_columns。

字段名	是否默认	含义
clicks	是	点击次数
cost	是	广告主支出
ctr	是	点击次数除以曝光次数
impressions	是	曝光次数

三、标准化字段

以下字段会写入 te_ads_object 中对应的平台标准字段：

原字段	标准化字段	类型	含义
campaign	te_ads_object.campaign_name	string	广告计划名称
campaign_id	te_ads_object.campaign_id	string	广告计划 ID
campaign_package_name	te_ads_object.app_name	string	推广应用包名
creative_set	te_ads_object.ad_group_name	string	广告组名称
creative_set_id	te_ads_object.ad_group_id	string	广告组 ID
cost	te_ads_object.cost	double	广告成本
clicks	te_ads_object.clicks	double	点击量
impressions	te_ads_object.impressions	double	曝光量