Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Misurare le entrate pubblicitarie

Misurare le tue fonti di entrate ti aiuta a comprendere il lifetime value dei tuoi utenti e a far crescere la tua attività con l'app. Questa guida mostra come configurare la misurazione delle entrate pubblicitarie per la tua piattaforma.

Dopo aver configurato la misurazione delle entrate pubblicitarie, puoi eseguire una delle seguenti operazioni:

Analizza le azioni degli utenti che contribuiscono alle entrate pubblicitarie generate dalla tua app.
Esegui esperimenti utilizzando Firebase A/B Testing per scoprire quali funzionalità migliorano le entrate pubblicitarie della tua app oppure crea esperienze pubblicitarie su misura utilizzando la personalizzazione di Remote Config.
Crea segmenti di pubblico di utenti e personalizza le esperienze utente utilizzando Firebase Remote Config in base ai livelli di entrate pubblicitarie.

Prima di iniziare

Se non l'hai già fatto, assicurati di completare le seguenti attività:

Configura il progetto e l'app come descritto in Inizia a utilizzare Analytics.
Assicurati di aver collegato il tuo progetto Firebase a un account Google Analytics.
Assicurati di aver incluso nella tua app l'SDK Android v17.6.0 o versioni successive o l'SDK per piattaforme Apple v6.34.0 o versioni successive.

Implementazione

Puoi utilizzare Google Analytics per misurare le entrate pubblicitarie generate dalla pubblicazione di annunci display con piattaforme di monetizzazione, come AdMob, AppLovin e ironSource. Per misurare le entrate pubblicitarie, devi registrare gli eventi ad_impression ogni volta che l'utente visualizza un annuncio nella tua app. Questi eventi contengono dettagli come la piattaforma pubblicitaria, l'origine, la valuta e il valore.

AdMob

Se utilizzi la piattaforma AdMob, collega la tua app AdMob a Firebase e Analytics per attivare la misurazione automatica delle entrate pubblicitarie. L'SDK Firebase per Google Analytics registra automaticamente l'evento ad_impression ogni volta che gli utenti visualizzano un'impressione dell'annuncio.

Altre piattaforme di monetizzazione pubblicitaria

Piattaforme come AppLovin e ironSource forniscono dati sulle entrate a livello di impressione che puoi utilizzare per registrare gli eventi Google Analytics ad_impression.

Le sezioni seguenti mostrano esempi di implementazione per alcune piattaforme di monetizzazione pubblicitaria.

AppLovin

Swift

Nota: questo prodotto Firebase non è disponibile per il target watchOS.

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

Nota: questo prodotto Firebase non è disponibile per il target watchOS.

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

Nota: questo prodotto Firebase non è disponibile per il target watchOS.

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

Nota: questo prodotto Firebase non è disponibile per il target watchOS.

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

Considerazioni sull'implementazione

Per consentire a Google Ads di elaborare il tuo ad_impression, assicurati di includere sia il parametro currency sia il parametro value (descritti di seguito). Entrambi i parametri devono essere il più precisi possibile per evitare di sopravvalutare o sottovalutare gli utenti.

Parametro della valuta

Il parametro currency (iOS+ | Android | Unity) deve essere inviato come stringa nel formato ISO_4217 di tre lettere (ad esempio, "USD"). Alcune piattaforme di monetizzazione pubblicitaria omettono la valuta, il che potrebbe richiedere l'impostazione del parametro come hardcoded.

Parametro value

Il parametro value (iOS+ | Android | Unity) deve essere inviato utilizzando un punto come separatore decimale. Potresti dover trasformare i valori ricevuti da alcune piattaforme per adattarli al formato richiesto sopra. Alcune piattaforme localizzano i formati numerici e utilizzano le virgole come separatori decimali. In alcuni casi, una piattaforma potrebbe non inviare alcun valore.

Inoltre, il valore deve essere un tipo numerico, ad esempio un valore double o long. Ad esempio, 1000.01, 0.001 e 1.00 sono tutti validi

Convalida

Google Analytics offre diverse funzionalità per convalidare l'implementazione durante il ciclo di sviluppo.

DebugView
Quando testi l'implementazione per la prima volta, utilizza DebugView per visualizzare i dati di test ad_impression nella console. Quando selezioni un evento ad_impression, puoi esaminare i parametri che stai inviando nel riquadro Parametri (sul lato destro dello schermo). In questo modo puoi verificare che vengano elaborate le informazioni corrette.
In tempo reale
Dopo aver eseguito il deployment dell'app, utilizza il Google Analytics report In tempo reale per verificare che l'implementazione funzioni correttamente. Nel report In tempo reale, visualizza la scheda Conteggio eventi per nome evento e seleziona ad_impression per visualizzare i dettagli dell'evento e dei parametri degli ultimi 30 minuti.
BigQuery
Utilizza l'esportazione di BigQuery per estrarre un campione di uno o più giorni di eventi ad_impression. Utilizza questo campione estratto per cercare problemi, ad esempio valori pari a zero o non impostati, e applica correzioni al codice per eventuali casi d'uso non gestiti.

Passaggi successivi

Visita la dashboard di Analytics nella console Firebase o nella proprietà Analytics collegata nella console Analytics. Le entrate pubblicitarie vengono prese in considerazione in metriche come le entrate medie per utente (ARPU) e il lifetime value (LTV).

Misurare le entrate pubblicitarie Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Implementazione

AdMob

Altre piattaforme di monetizzazione pubblicitaria

AppLovin

Swift

Objective-C

Kotlin

Java

Unity

ironSource

Swift

Objective-C

Kotlin

Java

Unity

Considerazioni sull'implementazione

Parametro della valuta

Parametro value

Convalida

Passaggi successivi

Misurare le entrate pubblicitarie