发生展示时,Google 移动广告 SDK 会提供广告收入数据 与此展示相关联的广告素材您可以使用此数据来计算用户的生命周期价值,也可以将此数据传送到下游的其他相关系统。
本指南旨在帮助您实现展示机会层级的广告收入 如何在 Unity 项目中捕获数据
前提条件
- 确保您已在 Ad Manager 界面中启用展示机会层级的广告收入功能。
- Unity 插件 5.0.0 或更高版本。
- 完成入门指南。Unity 应用应该 您已经导入了 Google 移动广告 Unity 插件。
您需要先植入以下至少一种广告格式,然后才能收到任何展示机会层级的广告收入数据:
实现付费事件处理脚本
每种广告格式都有一个 OnPaidEvent
事件。在广告事件的生命周期内
Google 移动广告 SDK 会监控展示事件并调用处理脚本,
以及赚取的价值
以下代码演示了如何处理激励广告的付费事件:
RewardedAd rewardedAd; private void RequestRewardedAd() { rewardedAd = new RewardedAd("AD_UNIT_ID"); rewardedAd.OnPaidEvent += this.HandleAdPaidEvent; AdRequest adRequest = new AdRequest(); rewardedAd.LoadAd(adRequest); } public void HandleAdPaidEvent(object sender, AdValueEventArgs args) { // TODO: Send the impression-level ad revenue information to your // preferred analytics server directly within this callback. AdValue adValue = args.AdValue; long valueMicros = adValue.Value; string currencyCode = adValue.CurrencyCode; PrecisionType precision = adValue.Precision; ResponseInfo responseInfo = rewardedAd.GetResponseInfo(); string responseId = responseInfo.GetResponseId(); AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo(); string adSourceId = loadedAdapterResponseInfo.AdSourceId; string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId; string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName; string adSourceName = loadedAdapterResponseInfo.AdSourceName; string adapterClassName = loadedAdapterResponseInfo.AdapterClassName; long latencyMillis = loadedAdapterResponseInfo.LatencyMillis; Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping; Dictionary<string, string> extras = responseInfo.GetResponseExtras(); string mediationGroupName = extras["mediation_group_name"]; string mediationABTestName = extras["mediation_ab_test_name"]; string mediationABTestVariant = extras["mediation_ab_test_variant"]; }
要详细了解胜出的广告来源,请参阅在 Google Ads 中检索 广告响应简介。
与应用归因合作伙伴 (AAP) 集成
如需全面了解如何将广告收入数据转发到分析平台, 请参阅合作伙伴指南:
合作伙伴 SDK |
---|
调整 |
AppsFlyer |
单数 |
Tenjin |
植入方面的最佳做法
- 在创建或访问
OnPaidEvent
而且一定要在展示广告之前进行这样可以确保您不会错过任何回调。 - 将展示机会层级的广告收入信息发送到您的首选分析工具
服务器。
OnPaidEvent
这可确保您 意外丢弃所有回调并避免数据差异。
AdValue
AdValue
是一个类,用于表示展示某个广告可赚取的货币价值,它包括价值的货币代码及精度类型,代码说明如下。
AdValue.PrecisionType |
说明 |
---|---|
Unknown |
广告值未知。当生命周期价值回 ping 为 但系统没有足够的可用数据。 |
Estimated |
广告价值是根据汇总数据估算的。 |
PublisherProvided |
广告价值是由发布商提供的,例如中介组中的人工每千次展示费用。 |
Precise |
此广告的确切价值。 |
对于中介,Ad Manager 会尝试为广告提供 ESTIMATED
值
已启用自动数据收集功能的来源。如需了解详情,请参阅
自动收集数据。对于
广告来源未开启自动收集数据功能,或是在某种情况下
如果没有足够的汇总数据来报告有意义的估算值,
PUBLISHER_PROVIDED
值。
测试通过公开出价功能获得的展示机会
通过测试请求为公开出价广告来源触发展示机会级广告收入事件后,您只会收到以下值:
Unknown
:表示精度类型。
0
:表示广告价值。
之前,您可能会看到精确度类型为 Unknown
以外的值,并且广告价值超过 0
。
有关发送测试广告请求的详情,请参见 启用测试设备。