評估收益來源有助於您瞭解使用者的生命週期價值,並拓展應用程式業務。本指南說明如何設定平台的廣告收益評估功能。
設定廣告收益評估功能後,您就可以執行下列任一操作:
分析能為應用程式帶來廣告收益的使用者動作。
使用 Firebase A/B 測試功能進行實驗,找出哪些功能可以提升應用程式廣告收益,或運用遠端設定個人化功能提供個人化的廣告體驗。
使用 Firebase 遠端設定,根據廣告收益等級建立使用者目標對象及量身打造使用者體驗。
事前準備
如果您尚未完成下列工作,請務必完成這項作業:
按照「開始使用 Analytics (分析)」一文的說明設定專案和應用程式。
確認您已在應用程式中納入 Android SDK 17.6.0 以上版本或 Apple 平台 SDK 6.34.0 以上版本。
導入作業
您可以使用 Google Analytics (分析),評估透過 AdMob、AppLovin 和 ironSource 等營利平台的多媒體廣告所產生的廣告收益。如要評估廣告收益,您必須在使用者在應用程式中看到廣告時記錄 ad_impression
事件。這些事件包含廣告平台、來源、貨幣和價值等詳細資料。
AdMob
如果您使用 AdMob 平台,請將 AdMob 應用程式連結至 Firebase 和 Analytics (分析),啟用自動評估廣告收益。Google Analytics (分析) 專用 Firebase SDK 會在使用者每次看到廣告曝光時,自動記錄 ad_impression
事件。
其他廣告營利平台
AppLovin 和 ironSource 等平台提供曝光層級收益資料,方便您記錄 Google Analytics (分析) ad_impression
事件。
以下各節說明幾種不同廣告營利平台的導入範例。
AppLovin
Swift
func didPayRevenue(_ impressionData: MAAd?) { if let impressionData = impressionData { Analytics.logEvent( AnalyticsEventAdImpression, parameters: [ AnalyticsParameterAdPlatform: "AppLovin", AnalyticsParameterAdUnitName: impressionData.adUnitIdentifier, AnalyticsParameterAdFormat: impressionData.format, AnalyticsParameterValue: impressionData.revenue, AnalyticsParameterCurrency: "USD", // All Applovin revenue is sent in USD AnalyticsParameterAdSource: impressionData.networkName, ]) } }
目標-C
- (void)didPayRevenueForAd:(MAAd *)impressionData { [FIRAnalytics logEventWithName:kFIREventAdImpression parameters: @{ kFIRParameterAdPlatform: @"AppLovin", kFIRParameterAdSource: impressionData.networkName, kFIRParameterAdFormat: impressionData.format, kFIRParameterAdUnitName: impressionData.adUnitIdentifier, kFIRParameterCurrency: @"USD", // All Applovin revenue is sent in USD kFIRParameterValue: impressionData.revenue }]; }
Kotlin+KTX
override fun onAdRevenuePaid(impressionData: MaxAd?) { impressionData?.let { firebaseAnalytics = Firebase.analytics firebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION) { param(FirebaseAnalytics.Param.AD_PLATFORM, "appLovin") param(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.adUnitId) param(FirebaseAnalytics.Param.AD_FORMAT, impressionData.format.label) param(FirebaseAnalytics.Param.AD_SOURCE, impressionData.networkName) param(FirebaseAnalytics.Param.VALUE, impressionData.revenue) param(FirebaseAnalytics.Param.CURRENCY, "USD") // All Applovin revenue is sent in USD } } }
Java
@Override public void onAdRevenuePaid(MaxAd impressionData) { double revenue = impressionData.getRevenue(); // In USD mFirebaseAnalytics = FirebaseAnalytics.getInstance(this); Bundle params = new Bundle(); params.putString(FirebaseAnalytics.Param.AD_PLATFORM, "appLovin"); params.putString(FirebaseAnalytics.Param.AD_SOURCE, impressionData.getNetworkName()); params.putString(FirebaseAnalytics.Param.AD_FORMAT, impressionData.getFormat().getLabel()); params.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.getAdUnitId()); params.putDouble(FirebaseAnalytics.Param.VALUE, revenue); params.putString(FirebaseAnalytics.Param.CURRENCY, "USD"); // All Applovin revenue is sent in USD mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, params); }
Unity
// Attach callbacks based on the ad format(s) you are using MaxSdkCallbacks.Interstitial.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent; MaxSdkCallbacks.Rewarded.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent; MaxSdkCallbacks.Banner.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent; MaxSdkCallbacks.MRec.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent; private void OnAdRevenuePaidEvent(string adUnitId, MaxSdkBase.AdInfo impressionData) { double revenue = impressionData.Revenue; var impressionParameters = new[] { new Firebase.Analytics.Parameter("ad_platform", "AppLovin"), new Firebase.Analytics.Parameter("ad_source", impressionData.NetworkName), new Firebase.Analytics.Parameter("ad_unit_name", impressionData.AdUnitIdentifier), new Firebase.Analytics.Parameter("ad_format", impressionData.AdFormat), new Firebase.Analytics.Parameter("value", revenue), new Firebase.Analytics.Parameter("currency", "USD"), // All AppLovin revenue is sent in USD }; Firebase.Analytics.FirebaseAnalytics.LogEvent("ad_impression", impressionParameters); }
ironSource
Swift
func impressionDataDidSucceed(_ impressionData: ISImpressionData!) { Analytics.logEvent( AnalyticsEventAdImpression, parameters: [ AnalyticsParameterAdPlatform: "ironSource", AnalyticsParameterAdSource: impressionData.ad_network ?? "No ad_network", AnalyticsParameterAdFormat: impressionData.ad_unit ?? "No ad_unit", AnalyticsParameterAdUnitName: impressionData.instance_name ?? "No instance_name", AnalyticsParameterCurrency: "USD", AnalyticsParameterValue: impressionData.revenue ?? 0, ]) }
目標-C
- (void)impressionDataDidSucceed:(ISImpressionData *)impressionData { [FIRAnalytics logEventWithName:kFIREventAdImpression parameters:@{ kFIRParameterAdPlatform: @"ironSource", kFIRParameterAdSource: impressionData.ad_network, kFIRParameterAdFormat: impressionData.ad_unit, kFIRParameterAdUnitName: impressionData.instance_name, kFIRParameterCurrency: @"USD", kFIRParameterValue: impressionData.revenue }]; }
Kotlin+KTX
override fun onImpressionSuccess(impressionData: ImpressionData) { // The onImpressionSuccess will be reported when the rewarded video and interstitial ad is // opened. // For banners, the impression is reported on load success. Log.d(TAG, "onImpressionSuccess" + // impressionData) firebaseAnalytics = Firebase.analytics firebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION) { param(FirebaseAnalytics.Param.AD_PLATFORM, "ironSource") param(FirebaseAnalytics.Param.AD_SOURCE, impressionData.adNetwork) param(FirebaseAnalytics.Param.AD_FORMAT, impressionData.adUnit) param(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.instanceName) param(FirebaseAnalytics.Param.CURRENCY, "USD") param(FirebaseAnalytics.Param.VALUE, impressionData.revenue) } }
Java
@Override public void onImpressionSuccess(ImpressionData impressionData) { // The onImpressionSuccess will be reported when the rewarded video and interstitial ad is opened. // For banners, the impression is reported on load success. Log.d(TAG, "onImpressionSuccess" + impressionData); mFirebaseAnalytics = FirebaseAnalytics.getInstance(this); if (impressionData != null) { Bundle bundle = new Bundle(); bundle.putString(FirebaseAnalytics.Param.AD_PLATFORM, "ironSource"); bundle.putString(FirebaseAnalytics.Param.AD_SOURCE, impressionData.getAdNetwork()); bundle.putString(FirebaseAnalytics.Param.AD_FORMAT, impressionData.getAdUnit()); bundle.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.getInstanceName()); bundle.putString(FirebaseAnalytics.Param.CURRENCY, "USD"); bundle.putDouble(FirebaseAnalytics.Param.VALUE, impressionData.getRevenue()); mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, bundle); } }
Unity
private void ImpressionSuccessEvent(IronSourceImpressionData impressionData) { if (impressionData != null) { Firebase.Analytics.Parameter[] AdParameters = { new Firebase.Analytics.Parameter("ad_platform", "ironSource"), new Firebase.Analytics.Parameter("ad_source", impressionData.adNetwork), new Firebase.Analytics.Parameter("ad_unit_name", impressionData.getInstanceName), new Firebase.Analytics.Parameter("ad_format", impressionData.getAdUnit), new Firebase.Analytics.Parameter("currency","USD"), new Firebase.Analytics.Parameter("value", impressionData.getRevenue) }; Firebase.Analytics.FirebaseAnalytics.LogEvent("ad_impression", AdParameters); } }
導入方面的注意事項
為了讓 Google Ads 處理您的 ad_impression
,請務必同時加入 currency
和 value
參數 (如下所述)。這兩個參數應盡可能準確,以避免高估值或低估使用者價值。
Currency 參數
currency
參數 (iOS+ | Android | Unity) 應以三個字母的 ISO_4217 格式 (例如 "USD"
) 做為字串傳送。有些廣告營利平台會省略貨幣,因此您可能需要以硬式編碼方式寫入參數。
值參數
value
參數 (iOS+ | Android | Unity) 應以半形句號做為小數分隔符來傳送。您可能需要轉換來自某些平台的值,以符合上述所需格式。有些平台會採用本地化的數字格式,並使用半形逗號做為小數分隔符號。在某些情況下,平台可能根本不會傳送任何值。
此外,這個值應為數字類型,例如雙精度浮點數或長整數。舉例來說,1000.01
、0.001
和 1.00
都是「有效」。
驗證
Google Analytics (分析) 提供多種功能,方便您在整個開發週期中驗證導入情況。
DebugView
首次測試實作項目時,請使用 DebugView 在控制台中查看測試ad_impression
資料。選取ad_impression
事件後,您可以在「Parameters」面板中 (位於畫面右側) 查看要傳送的參數。這有助於確認系統正在處理正確的資訊。即時
部署應用程式後,請使用 Google Analytics (分析) 即時報表確認導入作業是否正常運作。在即時報表中,查看「按事件名稱列出的事件計數」資訊卡,然後選取「ad_impression」,即可查看最近 30 分鐘的事件和參數詳細資料。BigQuery
使用 BigQuery Export 擷取一或多天的ad_impression
事件範例。請使用這個擷取的範例來找出問題 (例如零或未設定值),並修正程式碼,以解決任何未處理的用途。
後續步驟
您可以透過 Firebase 控制台或 Analytics (分析) 控制台中已連結的 Analytics (分析) 資源,前往 Analytics (分析) 資訊主頁。廣告收益也會納入指標,例如每位使用者平均收益 (ARPU) 和生命週期價值 (LTV)。