Entrate pubblicitarie a livello di impressione

Quando si verifica un'impressione, Google Mobile Ads SDK for React Native fornisce i dati sulle entrate pubblicitarie associati a questa impressione. Utilizza questi dati per calcolare il lifetime value (LTV) di un utente o inoltrali a piattaforme di analisi o partner di attribuzione di terze parti.

Questa guida illustra l'implementazione dell'acquisizione dei dati sulle entrate pubblicitarie a livello di impressione nella tua app React Native.

Prerequisiti

Prima di continuare, completa queste operazioni:

Ogni formato dell'annuncio supporta un callback di evento onAdPaid. Durante il ciclo di vita di un annuncio, Google Mobile Ads SDK for React Native monitora gli eventi di impressione e richiama il gestore con un payload AdValue ottenuto.

L'esempio seguente registra un listener di eventi di pagamento su un annuncio con premio, registra i dati sulle entrate pubblicitarie generate e mostra l'annuncio:

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

Ti consigliamo di procedere come segue:

  • Per gli annunci a schermo intero, imposta il listener sull'oggetto annuncio dopo aver caricato l'annuncio e prima di mostrarlo. Per gli annunci banner e nativi, passa il callback onAdPaid come proprietà al componente <BannerAdView /> o <NativeAdView />. Questa procedura garantisce che non vengano persi i callback degli eventi a pagamento.

  • Invia le informazioni sulle entrate pubblicitarie a livello di impressione al tuo server di analisi preferito quando Google Mobile Ads SDK for React Native chiama il callback onAdPaid. Questo processo garantisce che non vengano perse le chiamate di ritorno e mantiene i dati coerenti.

Scopri di più sull'integrazione di AAP

Per informazioni dettagliate sull'inoltro dei dati sulle entrate pubblicitarie alle piattaforme di analisi, consulta le seguenti guide dei partner di attribuzione app (AAP):

Comprendi l'oggetto AdValue

Un oggetto AdValue rappresenta il valore monetario guadagnato per un annuncio, inclusi il codice valuta e il tipo di precisione. La tabella seguente elenca le proprietà dell'oggetto AdValue:

Proprietà Descrizione
amountMicros Le entrate pubblicitarie in micro-unità, dove 1000000 micro-unità equivalgono a un'unità di valuta, ad esempio 1,00$o 1,00 €.
currencyCode Il codice valuta ISO 4217 del valore dell'annuncio, ad esempio USD o EUR.
precision Il livello di precisione del valore dell'annuncio. L'elenco seguente descrive in dettaglio ogni livello di precisione:
  • UNKNOWN: un valore dell'annuncio sconosciuto. Questo valore viene restituito quando il pingback LTV è attivato senza dati sufficienti.
  • ESTIMATED: il valore di un annuncio stimato a partire da dati aggregati.
  • PUBLISHER_PROVIDED: un valore dell'annuncio fornito dal publisher, ad esempio i CPM manuali in un gruppo di mediazione.
  • PRECISE: l'esatto valore pagato per un annuncio.

Nella Mediazione AdMob, AdMob tenta di fornire un valore ESTIMATED per le origini annuncio ottimizzate. Per maggiori dettagli, consulta Ottimizza le origini annuncio con struttura a cascata nella mediazione. Se un'origine annuncio non è ottimizzata o non dispone di dati aggregati sufficienti per una stima, Google Mobile Ads SDK for React Native restituisce il tipo di precisione PUBLISHER_PROVIDED.

Impressioni di test dalle origini annuncio per l'asta

Dopo che si verifica un evento di entrate pubblicitarie a livello di impressione per un'origine annuncio per l'asta tramite una richiesta di test, ricevi solo i seguenti valori:

  • UNKNOWN: indica il tipo di precisione.
  • 0: indica il valore aggiunto dell'annuncio.

Per maggiori dettagli sull'invio di una richiesta di annuncio di prova, consulta Attiva i dispositivi di test.