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 questi dati per calcolare la il lifetime value o inoltrare i dati a valle ad altri sistemi pertinenti.

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

Prerequisiti

• Assicurati di aver attivato le entrate pubblicitarie a livello di impressione nell'interfaccia utente di AdMob.
• Plug-in Unity 5.0.0 o successivo.
• Completa la sezione Inizia. L'app Unity dovrebbe il plug-in Unity di Google Mobile Ads è già importato.

• 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

Implementare un gestore di eventi a pagamento

Ogni formato dell'annuncio ha un evento OnPaidEvent. Durante il ciclo di vita di un evento pubblicitario, l'SDK Google Mobile Ads monitora gli eventi di impressione e richiama il gestore con un valore guadagnato.

Il codice seguente 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&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary&ltstring, 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 delle informazioni. relative alla risposta all'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 per i partner:

SDK partner
Adjust
AppsFlyer
Singular
Tenjin

Best practice per l'implementazione

• Imposta l'evento OnPaidEvent subito dopo aver creato o ottenuto l'accesso al e sicuramente prima di mostrarlo. In questo modo avrai la certezza di non perderne il callback.
• Invia le informazioni sulle entrate pubblicitarie a livello di impressione ai tuoi dati e analisi preferiti immediatamente nel tuo gestore OnPaidEvent. In questo modo avrai la certezza di non tralasciare accidentalmente i callback ed evita 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 segue.

Punto chiave: il valore di AdValue è un microvalore che rappresenta la di Google Cloud. Ad esempio, un valore pari a 5000 indica che l'annuncio è stimato essere del valore di 0,005 $.

AdValue.PrecisionType	Descrizione
Unknown	Un valore dell'annuncio sconosciuto. Viene restituito quando il pingback LTV è attiva, ma non sono disponibili dati sufficienti.
Estimated	Il valore di un annuncio stimato in base a dati aggregati.
PublisherProvided	Valore dell'annuncio fornito dal publisher, 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 non ci siano dati aggregati sufficienti per generare una stima significativa, viene restituito il valore PUBLISHER_PROVIDED.