Pomiar źródeł przychodów pomaga określić wartość długookresową użytkowników i rozwijać działalność związaną z aplikacjami. Z tego przewodnika dowiesz się, jak skonfigurować przychody z reklam dla Twojej platformy.
Po skonfigurowaniu pomiaru przychodów z reklam możesz wykonać dowolne :
Analizuj działania użytkowników, które przyczyniają się do generowania przychodów z reklam w aplikacji.
Przeprowadzaj eksperymenty za pomocą narzędzia Firebase A/B Testing, aby sprawdzić, funkcje zwiększające przychody z reklam w aplikacji lub personalizują reklamę; korzystania z personalizacji Remote Config.
Utwórz odbiorcy u użytkowników i dostosowania wrażeń użytkowników za pomocą Firebase Remote Config na podstawie poziomów przychodów z reklam.
Zanim zaczniesz
Pamiętaj, aby wykonać te czynności:
Skonfiguruj projekt i aplikację zgodnie z opisem w sekcji Wypróbuj Analytics
Upewnij się, że Twój projekt Firebase został połączony Google Analytics.
upewnij się, że masz w aplikacji zainstalowany pakiet Android SDK w wersji 17.6.0 lub nowszej lub SDK platformy Apple 6.34.0 lub nowszej.
Implementacja
Google Analytics umożliwia pomiar przychodów z reklam uzyskiwanych dzięki
wyświetlanie reklam na platformach generujących przychody, takich jak AdMob, AppLovin,
ironSource. Aby mierzyć przychody z reklam, musisz rejestrować
Zdarzenia: ad_impression
za każdym razem, gdy użytkownik zobaczy reklamę w Twojej aplikacji. Te zdarzenia zawierają
takie jak platforma reklamowa, źródło, waluta i wartość.
AdMob
Jeśli korzystasz z 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,
wyświetlenie reklamy użytkownikom.
Inne platformy do zarabiania na reklamach
Platformy takie jak AppLovin i ironSource dostarczają danych o przychodach na poziomie wyświetleń
których możesz potem używać do logowania Google Analytics
ad_impression
.
zdarzeń.
W poniższych sekcjach znajdziesz przykłady implementacji kilku różnych reklam platformom zarabiania.
AppLovin
Swift
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, ]) } }
Objective-C
- (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 }]; }
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 } } }
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); }
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
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, ]) }
Objective-C
- (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 }]; }
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) } }
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); } }
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ć usłudze Google Ads przetwarzanie
ad_impression
, pamiętaj o podaniu
zarówno parametr currency
, jak i value
(zgodnie z opisem poniżej). Obie opcje
powinny być jak najdokładniejsze, by zapobiec nadmiernej wartości lub niedostatecznej wartości
wartości użytkowników.
Parametr waluty
Parametr currency
(iOS+
| Android
| Unity)
należy wysyłać jako ciąg w trzyliterowym
ISO_4217
format (na przykład "USD"
). Niektóre platformy do generowania przychodu z reklam pomijają walutę,
co może wymagać
zakodowania parametru na stałe.
Parametr wartości
Parametr value
(iOS+
| Android
| Unity)
należy wysyłać przy użyciu kropki jako separatora dziesiętnego. Może być konieczne przekształcenie
wartości otrzymane z niektórych platform, aby dopasować je do powyższego wymaganego formatu. Niektóre
platformy lokalizują formaty liczbowe i używają przecinków jako separatorów dziesiętnych. W
w niektórych przypadkach platforma w ogóle nie przesyła wartości.
Dodatkowo wartość powinna być ciągiem liczb, np. liczba zmiennoprzecinkowa lub długi.
Na przykład 1000.01
, 0.001
i 1.00
to wszystkie
prawidłowe
Weryfikacja
Google Analytics udostępnia wiele funkcji, które umożliwiają sprawdzenie implementacji w całym cyklu programowania.
Widok debugowania
Przy pierwszym testowaniu implementacji użyj funkcji DebugView, aby wyświetlić dane testowead_impression
w konsoli. Po wybraniu zdarzeniaad_impression
możesz zobaczyć wysyłanego parametru w panelu Parameters (Parametry) ekranu). Dzięki temu możesz się upewnić, że informacje są prawidłowe przetworzono.Czas rzeczywisty
Po wdrożeniu aplikacji skorzystaj z Google Analytics Raport Czas rzeczywisty aby potwierdzić, że implementacja działa prawidłowo. W raporcie Czas rzeczywisty wyświetl kartę Liczba zdarzeń według nazwy zdarzenia i wybierz ad_impression, aby zobaczyć te dane. szczegóły zdarzenia i parametrów z ostatnich 30 minut.BigQuery
Wyodrębnianie danych za pomocą BigQueryeksportu próbka z co najmniej jednym dniem zdarzeńad_impression
. Użyj wyodrębnionych przykładową próbkę umożliwiającą znalezienie problemów, takich jak zero lub nieustawiona wartość, oraz zastosowanie poprawek do kodu w nieobsłużonych przypadkach użycia.
Dalsze kroki
Otwórz panel usługi Analytics w konsoli Firebase lub w powiązanym połączeniu właściwość Analytics w konsoli Analytics. Uwzględniane są przychody z reklam takich jak Średni przychód na użytkownika (ARPU) i Wartość od początku śledzenia. Wartość (od początku śledzenia).