跳到主要内容

AppLovin Basic Reporting API

最近更新 2026/10/03
提示

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

概要​

接口简介​

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

除了用户粒度的收益数据外，AppLovin 也提供了聚合指标 API，即 Basic Reporting API。

集成流程​

  1. 登录 AppLovin 后台，获取 Report Key
  2. 登录 AE 后台，进入三方集成模块，新增 AppLovin Basic Reporting API 方案，并完成相关配置
  3. 查看 AE 系统是否成功接收数据，并完成报表搭建

一、获取 Report Key​

需要接入 AppLovin Basic Reporting API 数据，您需要先获取 Report Key。请您登录 AppLovin 后台，在「Account」-「Key」中获取 Report Key，请将该 Key 妥善保管

二、方案配置​

当您获得 Report Key 后，您可以登录 AE 系统，在「三方集成」模块中完成新方案的配置。下图是 AppLovin Basic Reporting API 的配置界面，请您按照本章节内容完成方案的创建：

2.1 授权信息配置​

点击「授权信息」下的「配置授权信息」按钮，在弹出框内填写您在授权工作中获取到的信息

API Key 即为刚刚获得的 Report Key

2.2 定时拉取​

您可以在「定时拉取」模块设置 AE 系统定时拉取 AppLovin Basic Reporting API 数据的策略，可以选择在每天的某时或者每小时拉取一段时间的数据。

2.3 事件表入库设置​

打开「事件表入库设置」开关后，拉取的数据都将写入到事件表中，我们建议您开启事件数据入库。

2.4 集成配置​

您可以在集成配置模块对数据拉取的细节配置进行控制。包括数据的时间聚合粒度，拉取的指标字段与维度，以及入库后的事件名等。

集成配置中的内容是一个 JSON，您可以按照以下内容进行自定义配置：

模块名称含义
sink_eventevent_name入库后的事件名，可以自定义
source

report_types

数据拉取的层级，列表类型，建议您只填入一个元素，即一次只拉取一个层级的数据

可选值: advertiser、publisher

metrics数据中的指标，列表类型，不同层级支持不同的 metrics，填写时需要注意
group_by数据中的分组维度，列表类型，不同层级支持不同的 group_by，填写时需要注意

Basic Reporting API 提供了两种截然不同的报表，即广告主报表（advertiser）与流量主报表（publisher），以下章节将会分别介绍这两类报表如何配置：

2.4.1 广告主报表（advertiser）​

广告主报表的模板如下：

{
    "sink_event":
    {
        "event_name": "applovin_advertiser"
    },
    "source":
    {
        "group_by":
        [
            "day",
            "campaign",
            "campaign_id_external",
            "creative_set",
            "creative_set_id",
            "ad_id",
            "ad",
            "ad_type",
            "campaign_ad_type",
            "campaign_package_name",
            "campaign_store_id",
            "campaign_type",
            "country",
            "device_type",
            "external_placement_id",
            "platform",
            "size",
            "traffic_source"
        ],
        "report_types":
        [
            "advertiser"
        ],
        "metrics":
        [
            "impressions",
            "clicks",
            "ctr",
            "conversions",
            "conversion_rate",
            "average_cpa",
            "average_cpc",
            "cost",
            "sales"
        ]
    }
}
  • 模板中使用的时间粒度为天（广告主报表不支持按小时聚合），系统将使用数据中的 day 字段，即数据的日期，作为数据的时间
  • 模板中使用的事件名为 -- applovin_advertiser
  • 其余字段都将会入库
  • 可选维度

以下是广告主报表可选的维度，您可以按照实际需要进行调整，请将需要字段的字段名写入 source.group_by 中

字段名是否默认含义
day是报表的日期
campaign是Campaign 名称
campaign_id_external是Campaign 的唯一标识
creative_set是广告组名
creative_set_id是广告组 ID
ad_id是广告 ID
ad是广告名称
ad_type是广告类型，取值如：GRAPHIC, VIDEO, REWARD, 或 PLAY
application流量 App 名称
campaign_ad_type是如果是 User Acquisition Campaign，该值为 ua ，如果是 Retargeting Campaign，该值为 rt
campaign_package_name是推广 App 的包名，安卓端为 package name，iOS 端为 Bundle ID
campaign_store_id是推广 App 的应用市场 ID，安卓端为 package name，iOS 端为 iTunes ID 的数字部分
campaign_type是Campaign 的优化目标（PP, CPE, IAP ROAS, ad ROAS, or ROAS）
custom_page_id与广告组关联的 iOS 自定义产品页或者 Android 商店详情页
country是两位英文字母的 Country Code
device_type是设备类型，取值如：phone, tablet 或 other
external_placement_id是经过编码的应用 ID
optimization_day_targetCampaign 的目标优化日期 (比如 day 0 或者 day 7)
platform是设备平台，取值如：android, ios, fireos, tvos
size是广告尺寸，取值如：INTER, BANNER, MREC, LEADER, 或 NATIVE
target_eventCampaign 的计价事件(只对 CPE Campaign 有效)
traffic_source是流量来源，取值为 AppLovin 或其他 exchange 渠道名
  • 可选指标

以下是广告主报表可选的指标，您可以按照实际需要进行调整，请将需要字段的字段名写入 source.metrics 中

字段名是否默认含义
average_cpa是平均 CPA（安装）
average_cpc是平均 CPC
clicks是点击量
conversions是转化量（即安装量）
conversion_rate是转化率（安装量 / 点击量）
cost是广告成本
ctr是点击率
campaign_bid_goalCampaign 的出价目标
campaign_roas_goalCampaign 的 ROAS 目标
first_purchase首次内购的用户数 (需要配置 Revenue 回调)
impressions是曝光量
sales是内购次数 (需要配置 Revenue 回调)

2.4.2 流量主报表（publisher）​

流量主报表的模板如下：

{
    "sink_event":
    {
        "event_name": "applovin_publisher"
    },
    "source":
    {
        "group_by":
        [
            "day",
            "hour",
            "country",
            "ad_type",
            "size",
            "device_type",
            "platform",
            "application",
            "package_name",
            "store_id",
            "placement",
            "application_is_hidden",
            "zone",
            "zone_id",
            "bidding_integration"
        ],
        "report_types":
        [
            "publisher"
        ],
        "metrics":
        [
            "impressions",
            "clicks",
            "ctr",
            "revenue",
            "ecpm"
        ]
    }
}
  • 模板中使用的时间粒度为小时，即数据中的 day + hour 字段，作为数据的时间
  • 模板中使用的事件名为 -- applovin_publisher
  • 其余字段都将会入库
  • 可选维度

以下是流量主报表可选的维度，您可以按照实际需要进行调整，请将需要字段的字段名写入 source.group_by 中

字段名是否默认含义
day是报表的日期
hour是报表的小时值 (仅支持拉取最近 30 天的数据)，不使用此字段时，数据时间将只取 day
country是两位英文字母的 Country Code
ad_type是广告类型，取值如：GRAPHIC, PLAY, VIDEO, REWARD, 或 MRAID
size是广告尺寸，取值如：INTER, BANNER, MREC, LEADER, 或 NATIVE
device_type是设备类型，取值如：phone, tablet 或 other
platform是设备平台，取值如：android, ios, fireos, tvos
application是App 名称
package_name是App 的包名，安卓端为 package name，iOS 端为 Bundle ID
store_id是App 的应用市场 ID，安卓端为 package name；iOS 端为 iTunes ID 的数字部分，无法获取时取 Bundle ID
placement是Placement 名称
application_is_hidden是该 App 是否在 AppLovin 看板中被隐藏
zone是Zone 名称（仅当您的账号开启了 Zones）
zone_id是Zone ID（仅当您的账号开启了 Zones）
bidding_integration是集成的竞价方式（取值如 MAX 或 Admob Open Bidding）
  • 可选指标

以下是流量主报表返回的字段，您可以按照实际需要，选择返回的字段

字段名是否默认含义
impressions是曝光量
clicks是点击量
ctr是点击率
revenue是变现总收益
ecpm是ECPM

2.5 标准化字段​

以下展示的是 AppLovin Basic Reporting API 的标准化字段：

  • 广告主报表
原字段标准化字段含义
traffic_sourcete_ads_object.media_source变现渠道
campaignte_ads_object.campaign_name广告计划名
campaign_id_externalte_ads_object.campaign_id广告计划 ID
creative_sette_ads_object.ad_group_name广告组名
creative_set_idte_ads_object.ad_group_id广告组 ID
adte_ads_object.ad_name广告名
ad_idte_ads_object.ad_id广告 ID
campaign_package_namete_ads_object.app_name应用名
campaign_store_idte_ads_object.app_id应用 ID
countryte_ads_object.country国家地区编码
platformte_ads_object.platform平台，即 Android、iOS 等
【USD】定值te_ads_object.currency投放的币种
impressionste_ads_object.impressions曝光量
clickste_ads_object.clicks点击量
conversionste_ads_object.installs转化量（安装）
costte_ads_object.cost买量成本
  • 流量主报表
原字段标准化字段含义
countryte_ads_object.country国家地区编码
platformte_ads_object.platform平台，即 Android、iOS 等
applicationte_ads_object.app_name应用名
package_namete_ads_object.app_id应用 ID
placementte_ads_object.placement广告位置
【USD】定值te_ads_object.currency变现收益的币种
impressionste_ads_object.impressions曝光量
clickste_ads_object.clicks点击量
revenuete_ads_object.revenue变现收益
这篇文档对你有帮助吗？
本页内容