Entrate pubblicitarie a livello di impressione

Quando si verifica un'impressione, l'SDK Google Mobile Ads fornisce i dati sulle entrate pubblicitarie associati a quell'impressione. Puoi utilizzare i dati per calcolare il valore del ciclo di vita di un utente o inoltrarli 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

Implementare un gestore di eventi a pagamento

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

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&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 Recuperare informazioni sulla 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 del partner:

SDK partner
Adjust
AppsFlyer
Singular
Tenjin

Best practice per l'implementazione

  • Imposta l'evento OnPaidEvent immediatamente dopo aver creato l'oggetto annuncio o aver ottenuto l'accesso e sicuramente prima di mostrare l'annuncio. In questo modo, non perderai nessuna richiamata.
  • Invia immediatamente le informazioni sulle entrate pubblicitarie a livello di impressione al server di analisi che preferisci nel tuo gestore OnPaidEvent. In questo modo, eviti di perdere 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 indicato di seguito.

AdValue.PrecisionType Descrizione
Unknown Un valore dell'annuncio sconosciuto. Questo valore viene restituito quando il pingback del valore del ciclo di vita è abilitato, ma non sono disponibili dati sufficienti.
Estimated Il valore di un annuncio stimato a partire da dati aggregati.
PublisherProvided Il valore di un 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, Ad Manager tenta di fornire un valore ESTIMATED per le origini annuncio per cui è attivata la raccolta automatica dei dati. Per saperne di più, consulta Raccolta automatica dei dati. Per le origini annuncio per cui la raccolta automatica dei dati non è attivata o nei casi in cui non sono presenti dati aggregati sufficienti per generare una stima significativa, viene restituito il valore PUBLISHER_PROVIDED.

Impressioni di test da Open Bidding

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

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

In precedenza, il tipo di precisione poteva essere visualizzato come un valore diverso da Unknown e un valore dell'annuncio superiore a 0.

Per informazioni dettagliate sull'invio di una richiesta di annuncio di prova, vedi Attivare i dispositivi di test.