Ingresos publicitarios a nivel de impresión

Selecciona la plataforma: Android iOS Unity

Cuando se genera una impresión, el SDK de 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 de un usuario o reenviarlos a otros sistemas downstream pertinentes.

El objetivo de esta guía es ayudarte a implementar la captación de datos del 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 e invoca al controlador con un valor ganado.

Swift

class ViewController: UIViewController, FullScreenContentDelegate {
  var rewardedAd: RewardedAd?
  func requestRewardedAd() {
    RewardedAd.load(
      with: "AD_UNIT_ID", request: Request()
    ) { (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?.extras["mediation_group_name"]
          let mediationABTestName = responseInfo?.extras["mediation_ab_test_name"]
          let mediationABTestVariant = responseInfo?.extras["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"];
    };
  ]};
}

Forma de identificar el nombre de fuente de anuncios de un evento personalizado

Para las fuentes de anuncios de eventos personalizados, la propiedad adSourceName proporciona el nombre de fuente de anuncios Custom event. Si usas varios eventos personalizados, el nombre de fuente de anuncios no es lo suficientemente detallado como para distinguir esos eventos. Para identificar un evento personalizado específico, sigue estos pasos:

  1. Obtén la propiedad adNetworkClassName.
  2. Establece un nombre único para la fuente de anuncios.

En el siguiente ejemplo, se establece un nombre de fuente de anuncios único para un evento personalizado:

Swift

func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
  var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
  if adSourceName == "Custom Event" {
    if loadedAdNetworkResponseInfo.adNetworkClassName
      == "MediationExample.SampleCustomEventSwift"
    {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}
ResponseInfoSnippets.swift

Objective-C

- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
    (GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
  NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
  if ([adSourceName isEqualToString:@"Custom Event"]) {
    if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
      adSourceName = @"Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}
ResponseInfoSnippets.m

Para conocer otros detalles sobre la fuente de anuncios ganadora, consulta Recupera información sobre la respuesta de solicitud de anuncio.

Integración con socios de atribución en aplicaciones (AAP)

Para obtener detalles completos sobre el reenvío de datos de ingresos publicitarios a las plataformas de análisis, consulta la guía del socio:

SDK de socio
Adjust
AppsFlyer
Singular
Tenjin

Prácticas recomendadas para la implementación

  • Configura 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 análisis preferido inmediatamente después de que se llame al método paidEventHandler. Esto garantiza que no se descarten devoluciones de llamada por accidente y evita las discrepancias en los datos.

GADAdValue

GADAdValue es una clase que representa el valor monetario obtenido por un anuncio, incluido el código de moneda del valor y su tipo de precisión, que se codifica de la forma que se muestra a continuación.

GADAdValuePrecision Descripción
GADAdValuePrecisionUnknown Es un valor desconocido del anuncio. Se devuelve cuando el pingback del LTV está habilitado, pero no hay suficientes datos disponibles.
GADAdValuePrecisionEstimated Es un valor de anuncio estimado que se obtiene de datos agregados.
GADAdValuePrecisionPublisherProvided Es un valor de anuncio proporcionado por el publicador, como los CPM manuales en un grupo de mediación.
GADAdValuePrecisionPrecise Es el valor preciso que se pagó por este anuncio.

Impresiones de prueba de fuentes de anuncios de licitación

Cuando se produce un evento de ingresos publicitarios a nivel de impresión para una fuente de anuncios de licitación 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 indicado como un valor distinto de GADAdValuePrecisionUnknown, además de un valor del anuncio superior a 0.

Para obtener detalles sobre cómo enviar una solicitud de anuncio de prueba, consulta Habilita dispositivos de prueba.