Ingresos publicitarios a nivel de las impresiones

Cuando se produce una impresión, el SDK de los anuncios de Google para dispositivos móviles llama al controlador de eventos pagados con sus datos de ingresos asociados. Si implementas este controlador, puedes usar los datos para calcular el valor del ciclo de vida del usuario o reenviar los datos descendentes a otros sistemas relevantes.

El objetivo de esta guía es ayudarte a implementar la captura de datos de LTV en tu app para iOS.

Requisitos previos

Implementa un controlador de eventos pagados

Cada formato de anuncio tiene una propiedad paidEventHandler de tipo GADPaidEventHandler. Durante el ciclo de vida de un evento de anuncio, el SDK de anuncios de Google para dispositivos móviles supervisa los eventos de impresión y, luego, invoca al controlador con un valor obtenido.

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<NSString *, id> *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"];
    };
  ]};
}

Para obtener más información sobre la fuente del anuncio ganadora, consulta Cómo recuperar información sobre la respuesta del anuncio.

Realiza la integración con socios de atribución en aplicaciones (AAP)

Para obtener detalles completos sobre cómo reenviar datos de ingresos publicitarios a las plataformas de estadísticas, consulta la guía para socios:

SDK de socios
Ajustar
AppsFlyer
Singular
Tenjin

Prácticas recomendadas para la implementación

  • Establece el controlador inmediatamente después de crear el objeto de anuncio o de obtener acceso a él, y definitivamente antes de mostrar el anuncio. Esto garantiza que no te pierdas ninguna devolución de llamada de eventos pagados.
  • Envía la información del evento pagado a tu servidor de estadísticas preferido inmediatamente en el momento en que se llame al método paidEventHandler. Esto te garantiza que no pierdas accidentalmente ninguna devolución de llamada y evita discrepancias de datos.

GADAdValue

GADAdValue es una clase que representa el valor monetario que se obtuvo por un anuncio, incluido el código de moneda del valor y su tipo de precisión codificado como se indica a continuación.

GADAdValuePrecision Descripción
GADAdValuePrecisionUnknown Un valor de anuncio desconocido. Se muestra cuando se habilita el pingback del LTV, pero no hay suficientes datos disponibles.
GADAdValuePrecisionEstimated Es un valor estimado del anuncio calculado a partir de los datos agregados.
GADAdValuePrecisionPublisherProvided Un valor del anuncio proporcionado por el publicador, como los CPM manuales en un grupo de mediación
GADAdValuePrecisionPrecise Es el valor exacto que se pagó por este anuncio.

Prueba las impresiones de las fuentes de anuncios de licitación

Después de que se produce un evento de ingresos publicitarios a nivel de la impresión para una fuente de anuncios de ofertas a través de una solicitud de prueba, solo recibes los siguientes valores:

  • GADAdValuePrecisionUnknown: Indica el tipo de precisión.
  • 0: Indica el valor del anuncio.

Anteriormente, es posible que hayas visto el tipo de precisión como un valor diferente de GADAdValuePrecisionUnknown y un valor del anuncio superior a 0.

Para obtener más información sobre cómo enviar una solicitud de anuncio de prueba, consulta Cómo habilitar dispositivos de prueba.