Entrate pubblicitarie a livello di impressione

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

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

Prerequisiti

Implementazione di un gestore di eventi a pagamento

Ogni formato dell'annuncio ha un evento OnAdPaid. Durante il ciclo di vita di un evento correlato agli annunci, l'SDK Google Mobile Ads monitora gli eventi di impressione e richiama il gestore con un AdValue che rappresenta il valore guadagnato.

L'esempio seguente gestisce gli eventi a pagamento per un annuncio con premio:

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    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 all'annuncio.

Eseguire l'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 o ottenuto l'accesso all'oggetto annuncio e, in ogni caso, prima di mostrare l'annuncio. In questo modo, non mancherai alcun callback.
  • Invia immediatamente le informazioni sulle entrate pubblicitarie a livello di impressione al tuo server di analisi preferito nell'handler OnPaidEvent. In questo modo, eviterai di perdere accidentalmente i callback ed eviterai discrepanze nei dati.

AdValue

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

AdValue.PrecisionType Descrizione
Unknown Un valore dell'annuncio sconosciuto. Viene restituito quando il pingback LTV è attivo, 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 L'esatto valore di questo annuncio.

In caso di mediazione, AdMob tenta di fornire un valore Estimatedper le origini annuncio ottimizzate. Per le origini annuncio non ottimizzate o nei casi in cui non sono disponibili dati aggregati sufficienti per generare una stima significativa, viene restituito il valore PublisherProvided.

Testare le impressioni provenienti 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 dell'annuncio.

In precedenza, potresti aver visto il tipo di precisione 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, consulta Attivare i dispositivi di test.