評估廣告收益

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

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

事前準備

如果您尚未完成下列工作，請務必完成這項作業：

  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

目標-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

目標-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 參數

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 事件後，您可以在「Parameters」面板中 (位於畫面右側) 查看要傳送的參數。這有助於確認系統正在處理正確的資訊。

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

  3. BigQuery
    使用 BigQuery Export 擷取一或多天的 ad_impression 事件範例。請使用這個擷取的範例來找出問題 (例如零或未設定值)，並修正程式碼，以解決任何未處理的用途。

後續步驟

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