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

Como fazer a integração com parceiros de atribuição de app (AAPs)

Para detalhes completos sobre como encaminhar 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, o Ad Manager tenta fornecer um valor ESTIMATED para origens de anúncios com a coleta de dados automática ativada. Para mais informações, consulte Coleta automática de dados. Para origens de anúncios que não têm a coleta automática de dados ativada ou em casos em que não há dados agregados suficientes para informar uma estimativa significativa, o valor PUBLISHER_PROVIDED é retornado.

Testar impressões do Open Bidding

Depois que um evento de receita de publicidade no nível da impressão ocorre para uma origem de anúncios do Open Bidding por meio de 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.