Receita de publicidade no nível da impressão

Quando uma impressão ocorre, o Google Mobile Ads SDK for React Native fornece dados de receita de publicidade associados a ela. Use esses dados para calcular o valor da vida útil (LTV) de um usuário ou encaminhe-os para plataformas de análise ou parceiros de atribuição terceirizados.

Este guia aborda a implementação da captura de dados de receita de publicidade no nível da impressão no seu app React Native.

Pré-requisitos

Antes de continuar, faça o seguinte:

Cada formato de anúncio é compatível com um callback de evento onAdPaid. Durante o ciclo de vida de um anúncio, o Google Mobile Ads SDK for React Native monitora eventos de impressão e invoca o gerenciador com um payload AdValue ganho.

O exemplo a seguir registra um listener de eventos pagos em um anúncio premiado, registra os dados de receita de publicidade gerada e mostra o anúncio:

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

Recomendamos o seguinte:

  • Para anúncios de tela cheia, defina o listener no objeto de anúncio depois de carregar e antes de mostrar o anúncio. Para anúncios nativos e de banner, transmita o callback onAdPaid como uma propriedade para o componente <BannerAdView /> ou <NativeAdView />. Esse processo garante que você não perca nenhum callback de evento pago.

  • Envie as informações de receita de publicidade no nível da impressão para o servidor de análise de sua preferência quando Google Mobile Ads SDK for React Native chamar o callback onAdPaid. Esse processo garante que você não perca callbacks e mantém seus dados consistentes.

Saiba mais sobre a integração com o AAP

Para detalhes sobre o encaminhamento de dados de receita de publicidade para plataformas de análise, consulte os seguintes guias de parceiros de atribuição de app (AAP):

Entender o objeto AdValue

Um objeto AdValue representa o valor monetário ganho com um anúncio, incluindo o código da moeda e o tipo de precisão. A tabela a seguir lista as propriedades do objeto AdValue:

Propriedade Descrição
amountMicros A receita de publicidade em microunidades, em que 1000000 micros equivalem a uma unidade monetária, como US$1,00 ou € 1,00.
currencyCode O código de moeda ISO 4217 do valor do anúncio, por exemplo, USD ou EUR.
precision O nível de precisão do valor agregado do anúncio. A lista a seguir detalha cada nível de precisão:
  • UNKNOWN: um valor de anúncio desconhecido. Esse valor é retornado quando o pingback de LTV está ativado sem dados suficientes.
  • ESTIMATED: é um valor de anúncio estimado com base nos dados agregados.
  • PUBLISHER_PROVIDED: um valor de anúncio fornecido pelo publisher, como CPMs manuais em um grupo de mediação.
  • PRECISE: o valor exato pago por um anúncio.

Na Mediação da AdMob, a AdMob tenta fornecer um valor ESTIMATED para origens de anúncios otimizadas. Para mais detalhes, consulte Otimizar as origens de anúncios em hierarquia na mediação. Se uma origem de anúncios não for otimizada ou não tiver dados agregados suficientes para uma estimativa, Google Mobile Ads SDK for React Native vai retornar o tipo de precisão PUBLISHER_PROVIDED.

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úncio dos lances por uma solicitação de teste, você recebe apenas os seguintes valores:

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

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