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 ela. É possível usar os dados para calcular o valor da vida útil de um usuário ou encaminhar os dados para outros sistemas relevantes.

Este guia foi criado para 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&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 mais informações sobre a origem do anúncio vencedor, consulte Recuperar informações sobre a resposta do anúncio.

Integração com parceiros de atribuição de app (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 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 imediatamente para o servidor de análise de sua preferência no manipulador OnPaidEvent. Isso garante que você não solte acidentalmente nenhum callback e evita discrepâncias nos dados.

AdValue

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

AdValue.PrecisionType Descrição
Unknown É um valor de anúncio desconhecido. 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 publisher, 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 automática de dados 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 nos 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úncio do Open Bidding 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.

Antes, o tipo de precisão podia aparecer como um valor diferente de Unknown e um valor de anúncio maior que 0.

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