Questa pagina è stata tradotta dall'API Cloud Translation.

Entrate pubblicitarie a livello di impressione

Quando si verifica un'impressione, l'SDK Google Mobile Ads chiama l'handler dell'evento a pagamento con i dati sulle entrate associati. Se implementi questo gestore, puoi utilizzare i dati per calcolare il lifetime value di un utente o inoltrarli a valle ad altri sistemi pertinenti.

Questa guida ha lo scopo di aiutarti a implementare l'acquisizione dei dati LTV nella tua app per iOS.

Prerequisiti

Assicurati di aver attivato la funzionalità delle entrate pubblicitarie a livello di impressione nell'interfaccia utente di AdMob.

Importa l'SDK Google Mobile Ads 9.10.0 o versioni successive.
Completa la Guida introduttiva.
Prima di poter ricevere entrate pubblicitarie a livello di impressione, devi implementare almeno un formato dell'annuncio:

Implementare un gestore di eventi a pagamento

Ogni formato dell'annuncio ha una proprietà paidEventHandler di tipo GADPaidEventHandler. Durante il ciclo di vita di un evento dell'annuncio, l'SDK Google Mobile Ads monitora gli eventi di impressione e richiama il gestore con un valore ottenuto.

Swift

class ViewController: UIViewController, GADFullScreenContentDelegate {
  var rewardedAd: GADRewardedAd?
  func requestRewardedAd() {
    GADRewardedAd.load(
      withAdUnitID: "AD_UNIT_ID", request: GADRequest()
    ) { (ad, error) in
      if let error = error {
        print("Rewarded ad failed to load with error: \(error.localizedDescription)")
        return
      }
      if let ad = ad {
        self.rewardedAd = ad
        self.rewardedAd?.paidEventHandler = { adValue in
          // TODO: Send the impression-level ad revenue information to your preferred analytics
          // server directly within this callback.

          // Extract the impression-level ad revenue data.
          let value = adValue.value
          let precision = adValue.precision
          let currencyCode = adValue.currencyCode

          // Get the ad unit ID.
          let adUnitId = ad.adUnitID

          let responseInfo = ad.responseInfo
          let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo
          let adSourceId = loadedAdNetworkResponseInfo?.adSourceID
          let adSourceInstanceId = loadedAdNetworkResponseInfo?.adSourceInstanceID
          let adSourceInstanceName = loadedAdNetworkResponseInfo?.adSourceInstanceName
          let adSourceName = loadedAdNetworkResponseInfo?.adSourceName
          let mediationGroupName = responseInfo?.extrasDictionary["mediation_group_name"]
          let mediationABTestName = responseInfo?.extrasDictionary["mediation_ab_test_name"]
          let mediationABTestVariant = responseInfo?.extrasDictionary["mediation_ab_test_variant"]
        }
      }
    }
  }
}

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()
@property(nonatomic, strong) GADRewardedAd *rewardedAd;
@end

@implementation ViewController
- (void)requestRewardedAd {
  __weak ViewController *weakSelf = self;

  GADRequest *request = [GADRequest request];
  [GADRewardedAd
   loadWithAdUnitID:@"AD_UNIT_ID"
   request:request
   completionHandler:^(GADRewardedAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
      return;
    }
    self.rewardedAd = ad;
    self.rewardedAd.paidEventHandler = ^void(GADAdValue *_Nonnull value){
      ViewController *strongSelf = weakSelf;
      // TODO: Send the impression-level ad revenue information to your preferred analytics
      // server directly within this callback.

      // Extract the impression-level ad revenue data.
      NSDecimalNumber *value; = value.value;
      NSString *currencyCode = value.currencyCode;
      GADAdValuePrecision precision = value.precision;

      // Get the ad unit ID.
      NSString *adUnitId = strongSelf.rewardedAd.adUnitID;

      GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo =
          strongSelf.rewardedAd.responseInfo.loadedAdNetworkResponseInfo;
      NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
      NSString *adSourceID = loadedAdNetworkResponseInfo.adSourceID;
      NSString *adSourceInstanceName = loadedAdNetworkResponseInfo.adSourceInstanceName;
      NSString *adSourceInstanceID = loadedAdNetworkResponseInfo.adSourceInstanceID;
      NSDictionary&lt;NSString *, id&gt; *extras = strongSelf.rewardedAd.responseInfo.extrasDictionary;
      NSString *mediationGroupName = extras["mediation_group_name"];
      NSString *mediationABTestName = extras["mediation_ab_test_name"];
      NSString *mediationABTestVariant = extras["mediation_ab_test_variant"];
    };
  ]};
}

Per saperne di più sull'origine annuncio vincente, consulta Recuperare 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 il gestore subito dopo aver creato o ottenuto l'accesso all'oggetto annuncio e sicuramente prima di mostrare l'annuncio. In questo modo, non perderai alcun callback per eventi pagati.
Invia le informazioni sugli eventi a pagamento al tuo server di analisi preferito immediatamente al momento dell'invocazione del metodo paidEventHandler. In questo modo, eviterai di perdere accidentalmente i callback ed eviterai discrepanze nei dati.

GADAdValue

GADAdValue è 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.

GADAdValuePrecision	Descrizione
`GADAdValuePrecisionUnknown`	Un valore dell'annuncio sconosciuto. Viene restituito quando il pingback LTV è attivo, ma non sono disponibili dati sufficienti.
`GADAdValuePrecisionEstimated`	Il valore di un annuncio stimato a partire da dati aggregati.
`GADAdValuePrecisionPublisherProvided`	Il valore di un annuncio fornito dal publisher, ad esempio i CPM manuali in un gruppo di mediazione.
`GADAdValuePrecisionPrecise`	Il valore esatto pagato per questo annuncio.

Testare le impressioni provenienti dalle origini annuncio per l'asta

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

GADAdValuePrecisionUnknown: 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 GADAdValuePrecisionUnknown 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.