广告收入归因指南

广告收入归因支持各种颗粒度层级，具体取决于变现平台。

前期准备：

• 让广告收入对接渠道将API证书发送给您。

请按以下方式与变现平台对接广告收入：

1. 从AppsFlyer后台进入ROI360 > 收入设置 > 广告收入。
2. 在广告收入配置页面中，点击新建广告收入对接。
3. 选择要添加的广告收入合作渠道，然后点击下一步。
   
   
4. 选择您想要接收的广告收入数据类型。注意：可用的数据类型取决于具体平台。
   • 归因收入（Attributed Revenue）是指可归因到获客渠道的收入数据。归因记录报告分为以下两种：
     • 汇总数据（通过S2S API上报）
       • 选择事件，该事件与广告收入的计算相关联。假设您选择的事件是af_app_opened，那么广告收入就是平均每次应用打开所产生的广告收入，即总体广告收入除以应用打开事件总数。
     • 通过S2S API上报设备级别数据
       • 注意：如果您需要启用某聚合平台的设备级别广告收入API，就必须关闭该平台所聚合的变现平台的广告收入对接，否则会产生重复数据。
     • 通过SDK上报的展示级别数据。
     • 让您的开发人员在相关应用中接入AppsFlyer的广告收入SDK connector。我们提供安卓、iOS和Unity版本，请根据实际情况选用。
     • 由SDK上报展示级别的数据与由S2S API上报的汇总层级数据相结合。
     • 让您的开发人员在相关应用中接入AppsFlyer的广告收入SDK connector。我们提供安卓、iOS和Unity版本，请根据实际情况选用。
     • 由SDK上报的展示级别数据与由S2S API上报的设备级别数据相结合。
     • 让您的开发人员在相关应用中接入AppsFlyer的广告收入SDK connector。我们提供安卓、iOS和Unity版本，请根据实际情况选用。
     • 注意：如果您正在使用聚合平台进行广告变现，请务必先关闭该平台所聚合的变现平台的广告收入对接，然后再启用该聚合平台的广告收入对接，否则会产生重复数据。
5. 按对接渠道的要求填写API证书或登录信息。这与SDK集成无关。
6. 点击保存。
7. 如果界面显示“测试连接”按钮（如上图所示），请点击测试连接。
   • 如果界面显示消息“API key verified”（API密钥已验证），则表示您已顺利完成该流程。
   • 若界面显示其它信息，请参照广告收入API的连接状态与测试排查问题，然后重复上述流程。
8. 如果界面未显示测试连接按钮，则表示您已完成该流程。
   AppsFlyer会在一天内多次从该渠道收集数据。
9. 【可选】核查您在AppsFlyer中看到的广告收入数据，并将其与聚合平台和UA渠道面板中的广告收入进行对比。了解详情
10. 【可选】通过UA signals和广告收入事件回传将广告收入数据分享给您的合作渠道。

注意：如果您更改了对接方式，新的对接配置将在第二天UTC时间的凌晨12点生效。

如需查看、修改或删除您与广告收入平台的对接，请按以下方式操作：

1. 从AppsFlyer后台进入ROI360 > 收入设置 > 广告收入，然后选择相关应用。
   界面会列出您所有的渠道对接，包括对应的产品和对接类型、对接状态以及广告收入事件名称。
2. 将鼠标悬停在相关对接上，然后根据实际需要点击编辑或删除。

如果您的应用同时使用两个聚合平台，且这两个平台都关联了同一个变现平台，这时可能会有一部分广告收入出现重复。这种情况下，每个聚合平台都会上报其关联变现平台带来的所有广告收入，无论这些广告收入是否确实通过自身平台的聚合产生。

如需在两个聚合平台同时上报相互对应的广告收入时避免出现数据重复，请按以下方式操作：

1. 从AppsFlyer后台进入ROI360 > 收入设置 > 广告收入。
2. 点击通用设置下的两个聚合平台上报对应广告收入时去重。请注意：如果这两个聚合平台所聚合的广告样式不同，请勿启用去重。比如平台1展示横幅和插屏广告，而平台2展示开屏和原生广告，这时就无需进行去重。

汇总级别广告收入数据的作用原理如下：

• 对接平台上报分地区的每日总收入。
• AppsFlyer的eRPA（实际用户行为平均收入）计算方式为：广告收入/某个事件的触发次数
• AppsFlyer创建a _monetized事件，其中包含每个已归因设备的总体eRPA，如ad_matched_monetized。
• 通过eRPA将收入归因到媒体渠道。
• 您可以使用以下任一事件类型：
  • 特有变现事件要求对应用进行相应修改。
  • af_app_opened事件默认可用。
• 请勿在使用广告收入对接的同时通过应用内事件上报广告收入金额，否则会导致面板中出现重复的广告收入数据。这是因为AppsFlyer会通过对接获取变现平台的收入数据。

按事件汇总广告收入

应用内事件配置方式对比

• 广告收入对接正常时的状态信息如下：

  • 成本和广告收入对接状态面板：集中查看账户下已对接相关应用（一个或多个）广告收入的渠道列表。
  • 部分渠道允许广告主测试广告变现API的连接状态，这种情况下界面会显示测试连接按钮。
  • 验证API连接是否正常：
  • 点击测试连接。
    界面显示消息“API key已验证”。若未显示，请按下表指南进行排查。

广告收入数据能反映出各渠道的长期用户质量。随着用户打开应用并与广告互动的行为逐渐累积，用户的LTV就会持续提升。

注意：各面板和报告的广告收入数据之间可能会有差异，详情请见此处。

您可通过下列方式查看广告收入：

• LTV维度：
  • 面板展示：数据总览、事件报告
  • LTV报告
  • 群组面板和报告
  • Master API
• 活跃维度：
  • 面板展示：活跃数据报告
  • 广告收入原始数据

数据总览面板-汇总效果报告

数据总览面板：

• 面板中的收入等各种数据是LTV维度的。详情请见LTV数据与活跃数据的差异。
• 收入一栏显示所有收入，包括广告收入和应用内购。
• 深入各广告层级（媒体渠道、广告系列、广告组、地理位置）对数据进行切分，查看报告中的变现事件。

活跃面板：

• 面板中的收入等各种数据是活跃维度的（即按用户行为发生日期计算），详情请见LTV数据与活跃数据的差异。
• 用户平均操作次数用于说明用户在应用中与广告互动的可能性。

广告收入原始数据报告中的数据来自与AppsFlyer对接的变现平台，对接类型可以是设备级别，也可以是展示级别。

广告收入原始数据的作用原理

• 广告收入数据是基于每个用户的独立展示数来汇总的。独立展示数是根据广告变现平台、广告单元和广告位综合计算得出的。
• 展示级别的原始数据：
  • 汇总到设备级别，呈现在设备级别的报告中。
  • 呈现在Data Locker的展示级别报告中。
  • 原始数据的时效性与活跃数据报告中的设备级别广告收入一致。

数据特征和字段

广告收入报告中的填充字段：

• 按广告收入事件填充，详见下文表格。这些字段分为两类：
  • 专用字段：专用于广告收入的字段，如展示数和广告位。注意：具体的字段填充取决于变现平台，详情请见下文表格，其中列出了分平台的填充字段。
  • 通用字段：与其他原始数据报告相似的字段，如事件名称、事件值、货币等。
• AppsFlyer将广告收入事件归因到相关用户的拉新渠道，并以此为基础来填充相应字段。也就是说，这些字段按最初的拉新转化事件信息来填充，如媒体渠道和广告系列。这些字段不包含在下表所列范围内。

广告收入填充字段

分平台的填充字段

数据时效性取决于对接类型以及上报方式：

在S2S API对接中，数据的最早呈现时间为：

• 面板和Data Locker中的报告从UTC时间第X+1天的上午8点开始呈现数据，每天约更新4次，每6小时更新一次。若您购买了ROI360，还可获得第2、3、7、14天的数据，每天更新一次。

在展示级别的SDK对接中，数据的最早呈现时间为：

• 理想状态下，面板和Data Locker中的报告会从UTC时间第X天的早晨5点开始呈现数据，每天约更新6次，每4小时更新一次。
• 展示级别的原始数据报告（通过Data Locker拉取）在UTC时间第X天的凌晨1点呈现数据，且每小时更新一次。

对于带有设备级别数据（通过S2S API上报）的展示级别数据（通过SDK上报），您可以在第X天获得当天数据，并在第X+1天获得准确数据，具体如下：

• 对于通过SDK上报的展示级别数据：
  • 理想状态下，面板和Data Locker中的报告会从UTC时间第X天的早晨5点开始呈现数据，每天约更新6次，每4小时更新一次。
  • 展示级别的原始数据报告（通过Data Locker拉取）在UTC时间第X天的凌晨1点呈现数据，且每小时更新一次。
• 对于通过S2S API上报的设备级别数据：
  • 面板和Data Locker中的报告从UTC时间第X+1天的上午8点开始呈现数据，每天约更新4次，每6小时更新一次。若您购买了ROI360，还可获得第2、3、7、14天的数据，每天更新一次。

在ROI360之前的遗留对接中，数据最早从UTC时间第X+1天的下午5点开始呈现。

请注意：更改对接类型后，新对接不会对之前通过原对接类型接收的数据进行回滚更新。举例来说，假设您在第X天将对接类型从SDK改为S2S，那么新的对接会从第X+1天开始拉取数据，而不会拉取第X天之前的数据。

• 切换颗粒度不会影响历史广告收入数据，也就是说历史数据保持不变。
• 广告收入数据每天拉取一次，拉取时间为UTC时间14点，颗粒度取决于数据拉取当下的设置。
• 与汇总层级不同，设备级别的数据上报不需要定义应用内事件。您可以继续发送这些事件，但它们不会出现在AppsFlyer的设备级别数据中。

有些广告平台可以接收到UA信号，建议广告主首选与这类平台合作。这类拉新平台可以从聚合平台接收广告收入数据，并使用这些数据来优化广告主的拉新投放。

如需向拉新平台发送信号，聚合平台的对接必须达到展示级别或设备级别的对接。

• 如需了解渠道接收该报告的方式，请参考此文档。
• 如需了解广告主应如何为渠道开通此报告的权限，请参考此文档。

可向UA平台发送UA信号的聚合平台包括：

• Applovin Max
• Google Admob
• Appodeal
• Chartboost
• Fyber
• Tapdaq
• Topon
• Unity
• Unity LevelPlay聚合平台（前身为ironSource）
• Admost
• Tradplusad
• Yandex

可收到UA信号的UA平台列表：

• AdAction
• Adamobi
• Adjoe
• Adonco
• Adshow
• Appier
• Apprainbow
• Aura from Unity
• Betop
• Bidswave
• Brandscale
• Chameleostudios
• Chartboost
• Datawave
• DLab
• Ecomonline
• Etusdigital
• Foregon
• GNA Company
• Happimobi
• Hybrid
• Inflecto
• Irismedia
• Lambadapp
• Leadidadmonster
• Lifestreet
• Liftoff
• Melodong
• Mintegral
• Mobrand
• Moloco
• Motive
• Mpnd
• Msla
• Muvmobile
• Nexamob
• Nftdroper
• Nsofmedia
• Performadlive
• Personalyrtb
• Pitatroas
• Rebornads
• RTBhouse
• Runfuns
• Scmobi
• Shalltry
• Shareit
• Smadex
• Tapjoy
• Targetmedia
• Thepurpleline
• TikTok for Business
• Trademob
• Truemoney
• Unity Ads
• Yandex
• Yeahmobi
• Z2A Digital
• Zoyo

拉新渠道必须先获得您的授权，然后才能接收聚合平台的数据。

前期准备：

• 需要购买ROI360 Advanced进阶功能。
• 请先联系相关渠道，确认其具备数据接入流程和优化逻辑，有能力处理您的数据。

请按以下步骤向渠道开放广告收入数据的权限：

1. 进入配置 > 活跃对接。
2. 选择要对接的合作伙伴。
3. 转到对接选项卡。
4. 确认激活合作伙伴是否已开启。如果未开启，数据就不会被共享。
5. 进入授权选项卡。
6. 打开广告平台权限开关。
7. 打开访问广告收入原始数据开关。
8. 发送选项部分有两种发送方式可选：若选择仅该合作渠道，则仅发送该渠道带来的广告收入数据；若选择所有媒体渠道，包括自然流量，则发送来自所有媒体渠道的广告收入。
9. 点击保存设置。
10. 联系该渠道，告知其授权已完成。
11. 请确保相关广告平台已在其Data Locker中启用该报告，并已配置报告内容。

您可以配置广告平台的广告收入回传。也就是说，拉新平台可以接收到聚合平台的实时广告收入数据，并使用这些数据来优化广告主的拉新投放。

如需向UA平台发送回传，您与聚合平台之间必须具有展示级别的SDK对接。AppsFlyer会自动为每个展示生成一个af_ad_revenue事件。这些事件会出现在通过应用内事件回传发送给UA平台的事件列表中，供您选取。

请按以下方式设置广告收入事件回传：

1. 搜索并选择相关渠道，可以从Marketplace渠道平台或进入配置 > 活跃对接页面操作。
2. 在渠道对接选项卡中，向下滚动到应用内事件回传，打开此开关。
3. 在“AppsFlyer事件”列表中选择af_ad_revenue。
4. 将该事件映射到相关UA广告平台中的对应事件，具体如下：

   UA广告平台	af_ad_revenue的渠道映射事件	截屏
   Ironsource	adRevenue
   Unity Ads	ad_revenue
   Moloco	无需映射
   Mintegral	无需映射
   Smadex	无需映射
   Meta Ads	fb_mobile_purchase
   TikTok For Business - 高级SRN	ImpressionLevelAdRevenue
   Aura from Unity	ad_revenue

5. 点击保存对接。

可向UA平台发送展示级别广告收入事件的聚合平台包括：

• Applovin Max
• Google Admob
• Appodeal
• Chartboost
• Fyber
• Tapdaq
• Topon
• Unity
• Ironsource
• Admost
• Tradplusad
• Yandex

可收到广告收入事件回传的拉新平台包括：

• Ironsource
• Unity Ads
• Moloco
• Mintegral
• Meta Ads
• Smadex
• TikTok For Business - 高级SRN