評估廣告收益

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

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

• 分析使用者採取的行動，這些行動有助於提升應用程式產生的廣告收益。

• 使用 Firebase A/B Testing 進行實驗，找出哪些功能可提升應用程式廣告收益，或使用 Remote Config 個人化功能提供個人化廣告體驗。

• 根據廣告收益等級使用 Firebase Remote Config，建立使用者目標對象並調整使用者體驗。

事前準備

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

1. 按照「開始使用 Analytics」一文的說明設定專案和應用程式。

2. 請確認您已將 Firebase 專案連結至 Google Analytics 帳戶。

3. 請確認您已在應用程式中加入 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

注意：這項 Firebase 產品不適用於 macOS 目標。

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

注意：這項 Firebase 產品不適用於 macOS 目標。

- (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+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
        }
    }
}
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

注意：這項 Firebase 產品不適用於 macOS 目標。

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

注意：這項 Firebase 產品不適用於 macOS 目標。

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

此外，這個值應為數字類型，例如雙精度浮點數或長整數。例如 1000.01、0.001 和 1.00 都是有效

驗證

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

1. DebugView
   首次測試實作項目時，請使用 DebugView 在控制台中查看測試 ad_impression 資料。選取 ad_impression 事件後，您可以在「參數」面板 (位於畫面右側) 中查看傳送的參數。這有助於您確認系統處理的是正確資訊。

2. 即時
   部署應用程式後，請使用 Google Analytics 即時報表確認導入方式是否正常運作。在「即時」報表中查看「按事件名稱劃分的事件計數」資訊卡，然後選取「ad_impression」，即可查看過去 30 分鐘的事件和參數詳細資料。

3. BigQuery
   使用 BigQuery 匯出功能，擷取一或多天 ad_impression 事件的樣本。使用這個擷取的範例來查找問題 (例如零值或未設定的值)，並針對所有未處理的用途，將修正程式碼套用至程式碼。

後續步驟

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