Ingresos publicitarios a nivel de impresión

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 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 e invoca al controlador con un valor ganado.

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&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary&ltstring, 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 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
Ajustar
AppsFlyer
Singular
Tenjin

Prácticas recomendadas para la implementación

  • Configura 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 la impresión al servidor de análisis que prefieras inmediatamente en tu controlador OnPaidEvent. Esto garantiza que no se descarten devoluciones de llamada por accidente y evita 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 codifica como se indica más abajo.

AdValue.PrecisionType Descripción
Unknown Se desconoce el valor 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 a partir de datos agregados.
PublisherProvided Es un valor de anuncio proporcionado por el publicador, como los CPM manuales en un grupo de mediación.
Precise Es el valor preciso 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 los casos en que las fuentes de anuncios no tienen activada la recopilación automática de datos o no hay suficientes datos agregados para generar una estimación significativa, se devuelve el valor PUBLISHER_PROVIDED.

Impresiones de prueba de Open Bidding

Después de que se produce un evento de ingresos publicitarios a nivel de impresión para una fuente de anuncios de Open Bidding 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 dispositivos de prueba.