Receita de publicidade no nível da impressão

Quando uma impressão ocorre, o SDK dos anúncios para dispositivos móveis do Google fornece dados de receita de publicidade associados a essa impressão. Você pode usar os dados para calcular o valor vitalício de um usuário ou encaminhar os dados para outros sistemas relevantes.

Este guia tem como objetivo ajudar você a implementar a captura de dados de receita de publicidade no nível da impressão no seu projeto do Unity.

Pré-requisitos

Implementar um manipulador de eventos pagos

Cada formato de anúncio tem um evento OnAdPaid. Durante o ciclo de vida de um evento de anúncio, o SDK dos anúncios para dispositivos móveis do Google monitora eventos de impressão e invoca o gerenciador com um AdValue que representa o valor ganho.

O exemplo a seguir processa eventos pagos para um anúncio premiado:

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    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 mais informações sobre a origem de anúncio vencedora, consulte Como recuperar informações sobre a resposta do anúncio.

Integrar com parceiros de atribuição de app (AAPs)

Para conferir todos os detalhes sobre o encaminhamento de dados de receita de anúncios para plataformas de análise, consulte o guia do parceiro:

SDK do parceiro
Adjust (link em inglês)
AppsFlyer
Singular
Tenjin (link em inglês)

Práticas recomendadas de implementação

  • Defina o evento OnPaidEvent imediatamente após criar ou ter acesso ao objeto de anúncio e, definitivamente, antes de mostrar o anúncio. Isso garante que você não perca nenhum callback.
  • Envie as informações de receita de publicidade no nível da impressão para o servidor de análise preferido imediatamente no gerenciador OnPaidEvent. Isso garante que você não abandone acidentalmente os callbacks e evita discrepâncias de dados.

AdValue

AdValue é uma classe que representa o valor monetário ganho com um anúncio, incluindo o código de moeda do valor e o tipo de precisão codificado conforme abaixo.

AdValue.PrecisionType Descrição
Unknown Um valor de anúncio desconhecido. Isso é retornado quando o pingback de LTV está ativado, mas não há dados suficientes disponíveis.
Estimated É um valor de anúncio estimado com base nos dados agregados.
PublisherProvided Um valor de anúncio fornecido pelo editor, como CPMs manuais em um grupo de mediação.
Precise O valor exato deste anúncio.

No caso da mediação, a AdMob tenta fornecer um valor Estimated para origens de anúncios que são otimizadas. Para origens de anúncios não otimizadas ou em casos em que não há dados agregados suficientes para informar uma estimativa significativa, o valor PublisherProvided é retornado.

Testar impressões de origens de anúncios dos lances

Depois que um evento de receita de publicidade no nível da impressão ocorre para uma origem de anúncios de lances por uma solicitação de teste, você recebe apenas os seguintes valores:

  • Unknown: indica o tipo de precisão.
  • 0: indica o valor do anúncio.

Anteriormente, o tipo de precisão era um valor diferente de Unknown e um valor de anúncio maior que 0.

Para saber mais sobre como enviar uma solicitação de anúncio de teste, consulte Ativar dispositivos de teste.