評估廣告收益

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

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

事前準備

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

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

此外，值應為數值類型，例如 double 或 long。例如 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)。