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 brinda datos sobre los ingresos publicitarios asociados a esa impresión. Puedes usar estos datos para calcular el valor del ciclo de vida de un usuario o reenviarlos a otros sistemas downstream pertinentes.

Esta guía tiene como objetivo ayudarte a implementar la captura de datos de ingresos publicitarios a nivel de impresión en tu app para Android.

Requisitos previos

  • Importar el SDK de anuncios de Google para dispositivos móviles 21.1.0 o posterior

Cada formato de anuncio tiene un objeto OnPaidEventListener. 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.

En el siguiente ejemplo, se controlan los eventos pagados de un anuncio recompensado:

Java

private void setOnPaidEventListener(RewardedAd ad) {
  ad.setOnPaidEventListener(
      new OnPaidEventListener() {
        @Override
        public void onPaidEvent(@NonNull AdValue adValue) {
          // Extract the impression-level ad revenue data.
          long valueMicros = adValue.getValueMicros();
          String currencyCode = adValue.getCurrencyCode();
          int precision = adValue.getPrecisionType();

          // Get the ad unit ID.
          String adUnitId = ad.getAdUnitId();

          // Extract ad response information.
          AdapterResponseInfo loadedAdapterResponseInfo =
              ad.getResponseInfo().getLoadedAdapterResponseInfo();
          if (loadedAdapterResponseInfo != null) {
            String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
            String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
            String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
            String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();

            Bundle extras = ad.getResponseInfo().getResponseExtras();
            String mediationGroupName = extras.getString("mediation_group_name");
            String mediationABTestName = extras.getString("mediation_ab_test_name");
            String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
          }
        }
      });
}
ImpressionLevelAdRevenueSnippets.java

Kotlin

private fun setOnPaidEventListener(ad: RewardedAd) {
  ad.onPaidEventListener = OnPaidEventListener { adValue ->
    // Extract the impression-level ad revenue data.
    val valueMicros = adValue.valueMicros
    val currencyCode = adValue.currencyCode
    val precision = adValue.precisionType

    // Get the ad unit ID.
    val adUnitId = ad.adUnitId

    // Extract ad response information.
    val loadedAdapterResponseInfo = ad.responseInfo.loadedAdapterResponseInfo
    val adSourceName = loadedAdapterResponseInfo?.adSourceName
    val adSourceId = loadedAdapterResponseInfo?.adSourceId
    val adSourceInstanceName = loadedAdapterResponseInfo?.adSourceInstanceName
    val adSourceInstanceId = loadedAdapterResponseInfo?.adSourceInstanceId
    val extras = ad.responseInfo.responseExtras
    val mediationGroupName = extras.getString("mediation_group_name")
    val mediationABTestName = extras.getString("mediation_ab_test_name")
    val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
  }
}
ImpressionLevelAdRevenueSnippets.kt

Cómo identificar un nombre de fuente de anuncios de un evento personalizado

En el caso de las fuentes de anuncios de eventos personalizados, el método getAdSourceName() devuelve el nombre de la fuente de anuncios Custom event. Si usas varios eventos personalizados, el nombre de la fuente de anuncios no es lo suficientemente detallado como para distinguirlos. Para ubicar un evento personalizado específico, haz lo siguiente:

  1. Llama al método getAdSourceName().
  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:

Java

private String getUniqueAdSourceName(@NonNull AdapterResponseInfo loadedAdapterResponseInfo) {

  String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
  if (adSourceName.equals("Custom Event")) {
    if (loadedAdapterResponseInfo
        .getAdapterClassName()
        .equals("com.google.ads.mediation.sample.customevent.SampleCustomEvent")) {
      adSourceName = "Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}

ResponseInfoSnippets.java

Kotlin

private fun getUniqueAdSourceName(loadedAdapterResponseInfo: AdapterResponseInfo): String {

  var adSourceName = loadedAdapterResponseInfo.adSourceName
  if (adSourceName == "Custom Event") {
    if (
      loadedAdapterResponseInfo.adapterClassName ==
        "com.google.ads.mediation.sample.customevent.SampleCustomEvent"
    ) {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

ResponseInfoSnippets.kt

Para obtener más información sobre la fuente de anuncios ganadora, consulta Recupera la información sobre la respuesta de solicitud de anuncio.

Integración de 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 objeto de escucha 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 de los ingresos publicitarios a nivel de la impresión al servidor de análisis que prefieras en el momento preciso en que se invoca la devolución de llamada del evento pagado. Esto garantiza que no se descarten devoluciones de llamada por accidente y evita las discrepancias en los datos.

AdValue

AdValue 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 codifican de la siguiente manera.

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

En el caso de la Mediación de AdMob, AdMob intenta proporcionar un valor de ESTIMATED para las fuentes de anuncios optimizadas. En el caso de las fuentes de anuncios no optimizadas o cuando no hay suficientes datos agregados para generar una estimación significativa, se devuelve el valor PUBLISHER_PROVIDED.

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:

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

Anteriormente, es posible que el tipo de precisión se haya indicado como un valor distinto de UNKNOWN y un valor del anuncio superior a 0.

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