Ingresos publicitarios a nivel de las impresiones

Cuando se produce una impresión, el SDK de anuncios de Google para dispositivos móviles proporciona datos de ingresos publicitarios asociados con esa impresión. Puedes usar los datos para calcular el valor del ciclo de vida de un usuario o reenviar los datos a otros sistemas relevantes.

El objetivo de esta guía es ayudarte a implementar la captura de datos de ingresos publicitarios a nivel de las impresiones en tu proyecto de Unity.

Requisitos previos

Implementa un controlador de eventos pagados

Cada formato de anuncio tiene un evento OnPaidEvent. 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.

En el siguiente código, se muestra cómo controlar los eventos pagados de un anuncio recompensado:


RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

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

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

Para obtener todos los detalles sobre cómo reenviar datos de ingresos publicitarios a 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 evento OnPaidEvent 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.
  • Envía la información de los ingresos publicitarios a nivel de las impresiones a tu servidor de estadísticas preferido de inmediato en tu controlador OnPaidEvent. Esto garantiza que no pierdas ninguna devolución de llamada por accidente y evita discrepancias de datos.

AdValue

AdValue 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.

AdValue.PrecisionType Descripción
Unknown Un valor de anuncio desconocido. Se muestra cuando el pingback de LTV está habilitado, pero no hay suficientes datos disponibles.
Estimated Es un valor estimado del anuncio calculado a partir de los datos agregados.
PublisherProvided Un valor del anuncio proporcionado por el publicador, como los CPM manuales en un grupo de mediación
Precise Es el valor exacto de este anuncio.

En el caso de la mediación, Ad Manager intenta proporcionar un valor ESTIMATED para las fuentes de anuncios que tienen activada la recopilación automática de datos. Para obtener más información, consulta Recopilación automática de datos. En el caso de las fuentes de anuncios que no tienen activada la recopilación automática de datos o en los casos en que no hay suficientes datos agregados para informar una estimación significativa, se muestra el valor PUBLISHER_PROVIDED.

Prueba las impresiones de Open Bidding

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

  • Unknown: 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 Unknown 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.