Receita de publicidade no nível da impressão

Quando ocorre uma impressão, o SDK dos anúncios para dispositivos móveis do Google fornece dados de receita de publicidade associados a ela. É possível usar os dados para calcular o valor da vida útil de um usuário ou encaminhar os dados downstream para outros sistemas relevantes.

Este guia destina-se a 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

• Verifique se você ativou o recurso de receita de publicidade no nível da impressão na IU da AdMob.
• Plug-in do Unity 5.0.0 ou mais recente.
• Conclua o curso Começar. Seu app Unity já precisa importar o plug-in dos anúncios para dispositivos móveis do Google para Unity.

• Antes de receber dados de receita de publicidade no nível da impressão, é necessário implementar pelo menos um formato de anúncio:

  • Banner
  • Intersticial
  • Premiado
  • Intersticial premiado
  • Nativo

Como implementar um manipulador de eventos pago

Cada formato de anúncio tem um evento OnPaidEvent. 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 valor ganho.

O código abaixo demonstra como processar eventos pagos de um anúncio premiado:

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

Integração com App Attribution Partners (AAP)

Para detalhes completos sobre o encaminhamento de dados de receita de publicidade 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 depois de criar ou acessar o objeto de anúncio e, sem dúvida, antes de mostrar o anúncio. Isso garante que você não perde nenhum retorno de chamada.
• Envie imediatamente as informações de receita de publicidade no nível da impressão ao seu servidor de análise de preferência no gerenciador OnPaidEvent. Isso garante que você não descarte acidentalmente callbacks e evite discrepâncias de dados.

AdValue

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

Importante: o valor de AdValue é um valor micro que representa o valor de cada anúncio. Por exemplo, um valor de 5.000 indica que o anúncio tem o valor estimado de US $0,005.

AdValue.PrecisionType	Descrição
Unknown	Um valor de anúncio desconhecido. Ele é retornado quando o pingback de LTV está ativado, mas não há dados suficientes disponíveis.
Estimated	Um valor de anúncio estimado a partir de dados agregados.
PublisherProvided	Um editor forneceu um valor de anúncio, 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 ESTIMATEDvalor para as origens de anúncios otimizadas. Para origens de anúncios não otimizadas ou nos casos em que não há dados agregados suficientes para informar uma estimativa significativa, o valor PUBLISHER_PROVIDED é retornado.