Entrate pubblicitarie a livello di impressione

Quando si verifica un'impressione, l'SDK Google Mobile Ads fornisce i dati sulle entrate pubblicitarie associate all'impressione. Puoi utilizzare i dati per calcolare il lifetime value di un utente o inoltrare i dati a valle ad altri sistemi pertinenti.

Questa guida ha lo scopo di aiutarti a implementare l'acquisizione dei dati sulle entrate pubblicitarie a livello di impressione nel tuo progetto Unity.

Prerequisiti

• Assicurati di aver attivato la funzionalità per le entrate pubblicitarie a livello di impressione nell'interfaccia utente di AdMob.
• Plug-in Unity 5.0.0 o versione successiva.
• Completa la procedura Inizia. Nella tua app Unity dovrebbe già essere importato il plug-in Unity di Google Mobile Ads.

• Prima di poter ricevere dati sulle entrate pubblicitarie a livello di impressione, devi implementare almeno un formato dell'annuncio:

  • Banner
  • Interstitial
  • Con premio
  • Interstitial con premio
  • Nativo

Implementazione di un gestore di eventi a pagamento

Ogni formato dell'annuncio include un evento OnPaidEvent. Durante il ciclo di vita di un evento relativo all'annuncio, l'SDK Google Mobile Ads monitora gli eventi relativi alle impressioni e richiama il gestore con un valore ottenuto.

Il codice riportato di seguito mostra come gestire gli eventi a pagamento per un annuncio con premio:

RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

Per saperne di più sull'origine annuncio vincente, consulta la sezione Recupero di informazioni sulla risposta dell'annuncio.

Integrazione con i partner di attribuzione app (AAP)

Per informazioni dettagliate sull'inoltro dei dati sulle entrate pubblicitarie alle piattaforme di analisi, consulta la guida del partner:

SDK Partner
Regola
AppsFlyer
Singular
Tenjin

Best practice per l'implementazione

• Imposta l'evento OnPaidEvent subito dopo aver creato o ottenuto l'accesso all'oggetto annuncio, e decisamente prima di mostrare l'annuncio. In questo modo non perderai nessun callback.
• Invia immediatamente le informazioni sulle entrate pubblicitarie a livello di impressione al tuo server di analisi preferito nel tuo gestore OnPaidEvent. In questo modo eviterai di non ignorare accidentalmente i callback ed eviti discrepanze nei dati.

AdValue

AdValue è una classe che rappresenta il valore monetario guadagnato per un annuncio, inclusi il codice valuta del valore e il tipo di precisione codificato come di seguito.

Punto chiave: il valore di AdValue è un valore micro che rappresenta il valore di ogni annuncio. Ad esempio, un valore di 5000 indica che si stima che il valore di questo annuncio sia di 0,005 $.

AdValue.PrecisionType	Descrizione
Unknown	Valore dell'annuncio sconosciuto. Viene restituito quando viene attivato il pingback LTV, ma non sono disponibili dati sufficienti.
Estimated	Un valore dell'annuncio stimato in base a dati aggregati.
PublisherProvided	Un publisher ha fornito un valore dell'annuncio, ad esempio i CPM manuali in un gruppo di mediazione.
Precise	Il valore esatto di questo annuncio.

In caso di mediazione, AdMob cerca di fornire un ESTIMATEDvalore per le origini annuncio ottimizzate. Per le origini annuncio non ottimizzate o nei casi in cui i dati aggregati non siano sufficienti per registrare una stima significativa, viene restituito il valore PUBLISHER_PROVIDED.