本頁面由 Cloud Translation API 翻譯而成。

評估廣告收益

評估收益來源有助於瞭解使用者的生命週期價值，進而拓展應用程式業務。本指南說明如何為平台設定廣告收益評估功能。

設定廣告收益評估功能後，您可以執行下列任一操作：

分析有助於應用程式產生廣告收益的使用者動作。
使用 Firebase A/B Testing 執行實驗，找出可提高應用程式廣告收益的功能，或使用Remote Config個人化功能，提供個人化的廣告體驗。
根據廣告收益等級，建立使用者目標對象，並使用 Firebase Remote Config 調整使用者體驗。

事前準備

如果尚未完成下列工作，請務必完成：

按照「開始使用 Analytics」一文所述，設定專案和應用程式。
請確認您已將 Firebase 專案連結至 Google Analytics 帳戶。
請確認您已在應用程式中加入 Android SDK 17.6.0 以上版本，或 Apple 平台 SDK 6.34.0 以上版本。

導入作業

您可以使用 Google Analytics 評估透過營利平台 (例如 AdMob、AppLovin 和 ironSource) 放送廣告所產生的廣告收益。如要評估廣告收益，您必須在使用者於應用程式中看到廣告時，記錄 ad_impression 事件。這些事件包含廣告平台、來源、幣別和價值等詳細資料。

AdMob

如果您使用 AdMob 平台，請將 AdMob 應用程式連結至 Firebase 並Analytics，以便自動評估廣告收益。每當使用者看到廣告曝光時，Firebase SDK 就會自動記錄 ad_impression 事件。Google Analytics

其他廣告營利平台

AppLovin 和 ironSource 等平台會提供曝光層級的收益資料，您可以使用這些資料記錄 Google Analytics ad_impression 事件。

下列各節會顯示幾個不同廣告營利平台的實作範例。

AppLovin

Swift

注意：macOS 目標不支援這項 Firebase 產品。

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,
      ])
  }
}ViewController.swift

Objective-C

注意：macOS 目標不支援這項 Firebase 產品。

- (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
                    }];
}AnalyticsHelper.m

Kotlin

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
        }
    }
}MainActivity.kt

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);
}MainActivity.java

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

注意：macOS 目標不支援這項 Firebase 產品。

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,
    ])
}ViewController.swift

Objective-C

注意：macOS 目標不支援這項 Firebase 產品。

- (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
                      }];
}AnalyticsHelper.m

Kotlin

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)
    }
}MainActivity.kt

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);
    }
}MainActivity.java

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 參數 (iOS+ | Android | Unity) 應以字串形式傳送，並採用由三個字母組成的 ISO_4217 格式 (例如 "USD")。部分廣告營利平台會省略貨幣，因此您可能需要將參數硬式編碼。

Value 參數

value 參數 (iOS+ | Android | Unity) 應以半形句號做為小數分隔符傳送。您可能需要轉換從某些平台收到的值，以符合上述必要格式。部分平台會將數字格式本地化，並使用半形逗號做為小數分隔符。在某些情況下，平台可能不會傳送任何值。

此外，值應為數值型別，例如 double 或 long。例如 1000.01、0.001 和 1.00 都是有效的

驗證

Google Analytics 提供多項功能，可在整個開發週期驗證實作項目。

DebugView
首次測試導入作業時，請使用 DebugView 在控制台中查看測試 ad_impression 資料。選取 ad_impression 事件後，即可在「參數」面板 (位於畫面右側) 中，查看您傳送的參數。確認系統處理的資訊是否正確。
即時
部署應用程式後，請使用Google Analytics 即時報表確認導入作業是否正常運作。在「即時」報表中，查看「按事件名稱劃分的事件數」資訊卡，然後選取「ad_impression」，即可查看過去 30 分鐘的事件和參數詳細資料。
BigQuery
使用 BigQuery export 擷取一或多天的 ad_impression 事件樣本。使用這個擷取的樣本尋找問題 (例如零值或未設定的值)，並針對任何未處理的用途，將修正內容套用至程式碼。

後續步驟

前往Firebase控制台中的Analytics資訊主頁，或前往Analytics控制台中已連結的Analytics資源。廣告收益會納入每位使用者平均收益 (ARPU) 和生命週期價值 (LTV) 等指標。

評估廣告收益 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

導入作業

AdMob

其他廣告營利平台

AppLovin

Swift

Objective-C

Kotlin

Java

Unity

ironSource

Swift

Objective-C

Kotlin

Java

Unity

導入方面的注意事項

貨幣參數

Value 參數

驗證

後續步驟

評估廣告收益