Pomiar przychodów z reklam

Mierzenie źródeł przychodów pomaga poznać wartość użytkowników od początku śledzenia i rozwijać swoją działalność związaną z aplikacjami. Z tego przewodnika dowiesz się, jak skonfigurować pomiar przychodów z reklam na swojej platformie.

Po skonfigurowaniu pomiaru przychodów z reklam możesz:

analizować działania użytkowników, które przyczyniają się do przychodów z reklam generowanych przez Twoją aplikację;
przeprowadzać eksperymenty za pomocą Firebase A/B Testing, aby sprawdzać, które funkcje zwiększają przychody z reklam aplikacji, lub personalizować reklamy za pomocą Remote Config personalizowania;
tworzyć listy odbiorców i polepszać wrażenia użytkowników za pomocą Firebase Remote Config na podstawie poziomów przychodów z reklam.

Zanim zaczniesz

Jeśli jeszcze tego nie zrobisz, wykonaj te czynności:

Skonfiguruj projekt i aplikację zgodnie z opisem w artykule Pierwsze kroki w Analytics.
Upewnij się, że projekt w Firebase jest połączony z kontem Google Analytics account.
Sprawdź, czy w aplikacji masz pakiet Android SDK w wersji 17.6.0 lub nowszej albo pakiet SDK na platformy Apple w wersji 6.34.0 lub nowszej.

Implementacja

Google Analytics umożliwia mierzenie przychodów z reklam wyświetlanych za pomocą platform do generowania przychodów, takich jak AdMob, AppLovin i ironSource. Aby mierzyć przychody z reklam, musisz rejestrować ad_impression zdarzenia za każdym razem, gdy użytkownik zobaczy reklamę w Twojej aplikacji. Te zdarzenia zawierają szczegóły takie jak platforma reklamowa, źródło, waluta i wartość.

AdMob

Jeśli używasz platformy AdMob, połącz aplikację AdMob z Firebase i Analytics aby włączyć automatyczny pomiar przychodów z reklam. Pakiet SDK Firebase dla Google Analytics automatycznie rejestruje zdarzenie ad_impression za każdym razem, gdy użytkownicy zobaczą wyświetlenie reklamy.

Inne platformy do generowania przychodów z reklam

Platformy takie jak AppLovin i ironSource udostępniają dane o przychodach na poziomie wyświetlenia których możesz używać do rejestrowania Google Analytics ad_impression zdarzeń.

W sekcjach poniżej znajdziesz przykłady implementacji na kilku różnych platformach do generowania przychodów z reklam.

AppLovin

Swift

Uwaga: ta usługa Firebase nie jest dostępna na 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

Uwaga: ta usługa Firebase nie jest dostępna na 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

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

Uwaga: ta usługa Firebase nie jest dostępna na 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

Uwaga: ta usługa Firebase nie jest dostępna na 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

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);
  }
}

Uwagi o wdrażaniu

Aby umożliwić Google Ads przetwarzanie zdarzenia ad_impression, musisz uwzględnić parametry currency i value (opisane poniżej). Oba parametry powinny być jak najdokładniejsze, aby uniknąć przeszacowania lub niedoszacowania wartości użytkowników.

Parametr waluty

Parametr currency (iOS+ | Android | Unity) należy przesłać jako ciąg znaków w formacie ISO_4217 (np. "USD"). Niektóre platformy do generowania przychodów z reklam pomijają walutę, co może wymagać zakodowania parametru na stałe.

Parametr wartości

Parametr value (iOS+ | Android | Unity) należy przesłać z kropką jako separatorem dziesiętnym. Może być konieczne przekształcenie wartości otrzymanych z niektórych platform, aby dopasować je do wymaganego formatu. Niektóre platformy lokalizują formaty liczbowe i używają przecinków jako separatorów dziesiętnych. W niektórych przypadkach platforma może w ogóle nie wysyłać wartości.

Ponadto wartość powinna być typu liczbowego, np. double lub long. Prawidłowe wartości to np. 1000.01, 0.001 i 1.00. Są one prawidłowe

Weryfikacja

Google Analytics oferuje kilka funkcji, które umożliwiają weryfikację implementacji na każdym etapie programowania.

DebugView
Podczas pierwszych testów implementacji użyj DebugView, aby wyświetlić testowe dane ad_impression w konsoli. Po wybraniu zdarzenia ad_impression możesz sprawdzić parametry, które wysyłasz, w panelu Parametry (po prawej stronie ekranu). Pomaga to potwierdzić, że przetwarzane są prawidłowe informacje.
Czas rzeczywisty
Po wdrożeniu aplikacji użyj Google Analytics raportu Czas rzeczywisty w Google Analytics, aby sprawdzić, czy implementacja działa prawidłowo. W raporcie Czas rzeczywisty otwórz kartę Liczba zdarzeń według nazwy zdarzenia i wybierz ad_impression, aby wyświetlić szczegóły zdarzenia i parametrów z ostatnich 30 minut.
BigQuery
Użyj eksportu BigQuery, aby wyodrębnić próbkę zdarzeń ad_impression z co najmniej 1 dnia. Użyj wyodrębnionej próbki, aby znaleźć problemy, takie jak wartości zerowe lub nieustawione, i zastosować poprawki w kodzie w przypadku nieobsługiwanych przypadków użycia.

Dalsze kroki

Otwórz panel Analytics w konsoli Firebase lub w połączonej usłudze Analytics w konsoli Analytics. Przychody z reklam są uwzględniane w takich danych jak średnie przychody na użytkownika (ARPU) i wartość od początku śledzenia (LTV).

Pomiar przychodów z reklam Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Zanim zaczniesz

Implementacja

AdMob

Inne platformy do generowania przychodów z reklam

AppLovin

Swift

Objective-C

Kotlin

Java

Unity

ironSource

Swift

Objective-C

Kotlin

Java

Unity

Uwagi o wdrażaniu

Parametr waluty

Parametr wartości

Weryfikacja

Dalsze kroki

Pomiar przychodów z reklam