Ingresos publicitarios a nivel de impresión

Cuando se genera una impresión, el Google Mobile Ads SDK for React Native brinda datos sobre los ingresos publicitarios asociados a esa impresión. Usa estos datos para calcular el valor del ciclo de vida (LTV) de un usuario o reenvíalos a plataformas de estadísticas o socios de atribución externos.

En esta guía, se explica cómo implementar la captura de datos de ingresos publicitarios a nivel de impresión en tu app de React Native.

Requisitos previos

Antes de continuar, haz lo siguiente:

Cada formato de anuncio admite una devolución de llamada de evento onAdPaid. Durante el ciclo de vida de un anuncio, el Google Mobile Ads SDK for React Native supervisa los eventos de impresión y, luego, invoca al controlador con una carga útil de AdValue ganada.

En el siguiente ejemplo, se registra un objeto de escucha de eventos pagados en un anuncio recompensado, se registran los datos de ingresos publicitarios obtenidos y se muestra el anuncio:

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

Te recomendamos que hagas lo siguiente:

  • En el caso de los anuncios de pantalla completa, configura el objeto de escucha en el objeto de anuncio después de cargarlo y antes de mostrarlo. En el caso de los anuncios nativos y de banner, pasa la devolución de llamada onAdPaid como un prop al componente <BannerAdView /> o <NativeAdView />. Este proceso 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 impresión al servidor de estadísticas que prefieras cuando Google Mobile Ads SDK for React Native invoque la devolución de llamada onAdPaid. Este proceso garantiza que no te pierdas las devoluciones de llamada y mantiene la coherencia de tus datos.

Más información sobre la integración de AAP

Para obtener detalles sobre el reenvío de datos de ingresos publicitarios a las plataformas de análisis, consulta las siguientes guías de los socios de atribución en aplicaciones (AAP):

Comprende el objeto AdValue

Un objeto AdValue representa el valor monetario obtenido por un anuncio, incluidos el código de moneda y el tipo de precisión. En la siguiente tabla, se enumeran las propiedades del objeto AdValue:

Propiedad Descripción
amountMicros Son los ingresos publicitarios en microunidades, en las que 1000000 micros equivalen a una unidad de moneda, como USD 1.00 o EUR 1.00.
currencyCode Es el código de moneda ISO 4217 del valor del anuncio, por ejemplo, USD o EUR.
precision Es el nivel de precisión del valor del anuncio. En la siguiente lista, se detalla cada nivel de precisión:
  • UNKNOWN: Es un valor de anuncio desconocido. Este valor se devuelve cuando el pingback del LTV está habilitado, pero no hay suficientes datos disponibles.
  • ESTIMATED: Es un valor estimado del anuncio calculado a partir de los 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 un anuncio.

En la Mediación de AdMob, AdMob intenta proporcionar un valor de ESTIMATED para las fuentes de anuncios que están optimizadas. Para obtener más detalles, consulta Cómo optimizar las fuentes de anuncios en cascada en la mediación. Si una fuente de anuncios no está optimizada o no tiene suficientes datos agregados para una estimación, Google Mobile Ads SDK for React Native devuelve el tipo de precisión 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.

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