Visão geral: atribua a receita de anúncios para concluir a visualização de performance de LTV.
Atribuição de receita de anúncios
- Os anúncios aparecem no aplicativo em banners, mural de ofertas, intersticiais etc. e geram receita publicitária. Integre SDKs da rede de monetização de anúncios no aplicativo para exibir anúncios aos seus usuários e gerar receita publicitária.
- Receitas de anúncios, compras in-app e receita de assinatura combinadas oferecem a você a imagem completa do LTV do usuário. Ao fazer a correspondência entre o LTV do usuário e a campanha de gastos de mídia, o ROI é definido e fica disponível para análise posterior na Plataforma.
Dados de receita de anúncios:
- É adquirido das redes de mediação e/ou monetização de anúncios por meio de APIs de servidor ou por SDK de relatórios incorporados ao aplicativo (incluindo iOS 14).
- São atribuídos à fonte de mídia que originalmente trouxe o usuário.
- A granularidade dos relatórios depende da integração da rede de monetização:
- Granularidade agregada: detalhada por país/geolocalização.
- Granularidade a nível do usuário: permite a análise detalhada da hierarquia dos anúncios até o nível do dispositivo. Você pode analisar com maior precisão o valor do usuário usando os relatórios de dados brutos de receita de anúncios.
Granularidade a nível do usuário vs. a nível agregado
A atribuição da receita de anúncios é compatível com diferentes métodos de granularidade. A granularidade depende da rede de monetização.
-
Granularidade agregada:
- A AppsFlyer obtém a receita diária dividida por localização.
- A receita efetiva por ação (eRPA) é obtida através da divisão da receita pelo número de instâncias de um evento trigger.
- Os eventos de gatilho são eventos abertos ou eventos in-app específicos definidos no aplicativo.
-
Granularidade a nível do usuário (também conhecida como granularidade a nível de impressão) [prática recomendada]:
- A rede de monetização relata a receita por usuário a nível de impressão. Nem todas as redes de monetização são compatíveis com a granularidade a nível do usuário.
- Essa receita é atribuída à fonte de mídia que trouxe o usuário. Ou seja, a atribuição da receita publicitária da AppsFlyer segue as regras de atribuição encontradas na plataforma, incluindo regras de atribuição de retargeting.
Observação: se você estiver usando uma rede de mediação, desative as APIs de receita publicitária para parceiros de monetização que fazem a mediação por meio da rede de mediação antes de ativar a API de granularidade a nível do usuário. Caso contrário, você terá dados duplicados.
Receita atribuída vs. API de receita de monetização
A AppsFlyer fornece vários tipos de dados de receita de anúncios. Observação: nem todas as ad networks oferecem todas as opções listadas abaixo.
Receita atribuída: receita de anúncios com base na fonte de aquisição de usuários, disponível tanto a nível agregado quanto a nível do usuário. Por exemplo:
- O usuário vê um anúncio da Rede A e faz download do seu aplicativo.
- O anúncio é exibido dentro do aplicativo.
- A receita de anúncios é atribuída à Rede A (responsável pela aquisição do usuário), independentemente de quem publicou o anúncio.
API de receita de monetização: receita baseada na fonte dos anúncios, não na fonte de aquisição de usuários. Por exemplo:
- O usuário vê um anúncio da Rede A e faz download do seu aplicativo.
- O anúncio da Rede B é exibido dentro do aplicativo.
- A receita de anúncios é atribuída à Rede B.
Implementação
As seções a seguir descrevem os tipos de atribuição de receita de anúncios disponíveis, bem como os fluxos de trabalho e as etapas necessárias para implementação e manutenção.
Fluxos de trabalho de atribuição de receita de anúncios da API
Para implementar a atribuição de receita de anúncios da API, siga um dos fluxos de trabalho para o método de granularidade adequado na tabela a seguir.
Etapa | Granularidade agregada | Granularidade a nível do usuário (nível de impressão) |
---|---|---|
1 | Não aplicável | |
2 |
No aplicativo implemente:
|
No aplicativo implemente:
|
3 | Conecte-se ao parceiro de rede de monetização da AppsFlyer |
Conecte-se a uma rede de monetização de anúncios a nível do usuário: |
4 | Gere e atribua receita de anúncios | Gere e atribua receita de anúncios |
Agregar granularidade usando a abertura de aplicativo ou eventos in-app
Implementação de granularidade agregada:
- A rede integrada relata a receita total por dia detalhada por geolocalização.
- A AppsFlyer deriva a receita efetiva por ação (eRPA) dividindo a receita de anúncios pelo número de instâncias de um evento de gatilho.
- Cada vez que ocorre um evento de gatilho, a AppsFlyer cria um evento _monetized, que inclui o eRPA. Por exemplo, ad_matched_monetized.
- O uso da receita de eRPA é atribuído a fontes de mídia.
- Não relate a receita publicitária em eventos in-app. Isso faz com que a receita publicitária duplicada no Dashboard, pois a AppsFlyer obtém os dados de receita da rede de monetização por integração.
- Se você estiver usando uma rede de mediação, desative as integrações de receita publicitária para parceiros de monetização que fazem a mediação por meio da rede de mediação antes de ativar a integração de receita publicitaria com a rede de mediação. Caso contrário, você terá dados duplicados.
- Você pode usar um dos seguintes tipos de eventos:
- Evento in-app exclusivo de monetização requer modificações no aplicativo.
- evento af_app_opened que está disponível por padrão.
Método de evento | Como é implementado | considerações |
---|---|---|
Evento in-app exclusivo de monetização |
|
|
af_app_opened event |
|
|
Método | Prós | Contras | considerações |
---|---|---|---|
Use o mesmo evento para todas as redes. Por exemplo, ad_watched. Isso gera automaticamente o evento ad_watched_monetized contendo os detalhes da monetização | Implementação mais simples | Sem informações de qualidade, como o número de cliques e a receita de anúncios por rede |
|
(prática recomendada) Cada rede recebe um evento exclusivo para visualização de anúncios. Exemplo: ad_watch_admob, ad_watch_vungle. |
Visibilidade total e capacidade de comparar as redes de monetização no dashboard, além dos dados brutos. | A receita de anúncios não é acumulada em um único evento. O número de eventos é equivalente ao número de redes | Permite a comparação de redes de monetização no dashboard. A receita de anúncios é separada por rede usando um evento in-app por rede. |
Granularidade a nível do usuário com a API de receita de anúncios
Implementação de granularidade a nível do usuário (nível de impressão):
Esse método é a melhor prática. Ele fornece o maior nível de granularidade e a receita de anúncios é atribuída sem a necessidade de modificar o aplicativo. A receita de anúncios é atribuída com precisão à fonte de UA.
Dados de receita de anúncios a nível de usuário: a atribuição fica disponível nos relatórios de dados brutos. Não enviamos postbacks de dados a nível de usuário para parceiros integrados
A receita de usuários de aplicativos para os quais não há registro de atribuição na AppsFlyer é atribuída como orgânica, com a data de instalação como o dia em que a receita publicitária é relatada. Isso pode ocorrer, por exemplo, depois da exclusão de dados a nível do usuário do Facebook.
Atenção
Se você estiver usando uma rede de mediação, desative as integrações de receita publicitária para parceiros de monetização que fazem a mediação por meio da rede de mediação antes de ativar a integração de receita publicitaria com a rede de mediação. Caso contrário, você terá dados duplicados.
Método | Como é implementado | considerações |
---|---|---|
Dados a nível do usuário que usam a API de receita de anúncios |
|
N/D |
Migrando da granularidade agregada para notas de implementação de granularidade a nível do usuário
- A migração não afeta os dados históricos de receita de anúncios. Esses dados permanecem inalterados.
- Os dados de receita de anúncios são extraídos uma vez por dia às 14:00 UTC usando as opções de granularidade selecionadas nesse momento.
- A granularidade a nível do usuário não exige que você defina eventos in-app (como você faz para relatórios a nível agregado). Você pode continuar enviando esses eventos, mas eles não afetam os relatórios de granularidade a nível do usuário na AppsFlyer.
Conectando-se a parceiros integrados de receita publicitária

Antes de começar:
- Solicite que o parceiro integrado de receita de anúncios forneça as credenciais da API.
Para habilitar a integração da receita de anúncios com a rede de receita de anúncios:
-
Na AppsFlyer, acesse Configuração > Parceiros Integrados.
A janela de Parceiro Integrado é aberta. -
Selecione um parceiro. Dica: selecione Ativo e Receita de anúncios para exibir seus parceiros existentes que possuem recursos de receita de anúncios.
A janela de configuração do parceiro integrado será aberta. - Acesse a aba de Receita de anúncios e habilite Obter dados de receita de anúncios.
-
Selecione o tipo de dados de receita de anúncios que você deseja receber. Observação: nem todas as ad networks oferecem todas as opções listadas abaixo. Se a receita atribuída não incluir a opção a nível do usuário, isso significa que apenas dados agregados estão disponíveis.
- Receita atribuída. Ou seja, receita com base na fonte de aquisição do usuário. Os relatórios de receita atribuídos podem ser:
- Nível agregado. Para o nível agregado, você também precisa selecionar o evento no qual basear a receita de anúncios. Por exemplo, se você escolher o evento af_app_opened, a receita total do anúncio será dividida entre todos os eventos abertos pelo aplicativo, o que lhe dará a receita de anúncios por abertura do aplicativo.
- Nível do SDK
- Observação: se você estiver usando uma rede de mediação, desative as integrações de receita publicitária para parceiros de monetização que fazem a mediação por meio da rede de mediação antes de ativar a integração de receita publicitaria com a rede de mediação. Caso contrário, você terá dados duplicados.
- API de receita de monetização. Ou seja, receita com base na fonte do anúncio, não na fonte de UA.
- Receita atribuída. Ou seja, receita com base na fonte de aquisição do usuário. Os relatórios de receita atribuídos podem ser:
- Preencha as credenciais da API ou faça login, conforme exigido pelo parceiro integrado. Isso não é relevante para a integração no nível do SDK.
- Clique em Salvar receita de anúncios.
-
Se o botão Testar conexão for exibido, como na imagem acima, clique em Testar conexão.
- Se chave de API verificada aparecer, você concluiu com sucesso o procedimento.
- Se qualquer outra mensagem aparecer, consulte Status e teste da API de receita de anúncios e repita o procedimento.
-
Se o botãoTestar Conexão não aparecer, você concluiu o procedimento.
A AppsFlyer coleta os dados do parceiro várias vezes por dia.
Status e teste da API de receita de anúncios
-
O status operacional da integração da receita de anúncios fica disponível da seguinte forma:
- Dashboard de controle de status da integração de receita de anúncios e custos: lista centralizada de parceiros para os quais a integração de receita de anúncios está habilitada para um ou mais aplicativos hospedados em sua conta.
- Alguns parceiros permitem que você teste a conexão da API. Quando disponível, um botão Testar conexão é exibido.
- Para verificar se a conexão da API é operacional:
- Clique em Testar conexão.
A mensagem "Chave da API verificada" é exibida. Se esse não for o caso, siga as orientações de ação corretiva na tabela a seguir.
Status | Significado | Observações/ação necessária |
---|---|---|
Chave de API verificada |
|
Nenhuma |
Credenciais inválidas. |
Uma ou mais credenciais fornecidas estão incorretas. |
Obtenha as credenciais corretas do parceiro de receita de anúncios |
Detalhes de configuração ausentes | Um ou mais campos de credenciais estão incompletos | Recupere as credenciais no dashboard do parceiro de receita de anúncios ou entre em contato com o parceiro e solicite as credenciais. |
Dados de receita de anúncios
Os dados de receita publicitária estão disponíveis por meio dos painéis da AppsFlyer e relatórios.
Receita de anúncios no dashboard
A receita de anúncios mostra a qualidade dos usuários de diferentes fontes ao longo do tempo. À medida que os usuários continuam lançando o aplicativo e engajando com anúncios, o LTV aumenta.
Observação: pode haver discrepâncias entre os dados de receita de anúncios em diferentes dashboards e relatórios. Saiba mais.
A atribuição de receita de anúncios está disponível da seguinte forma:
- Baseado em LTV:
- Dashboards: visão geral, eventos,
- Análise da coorte
- Master API
- Com base na atividade:
- Dashboard: Atividade
- Dados brutos de receita publicitária
Dashboard de visão geral - relatório de performance agregada

No dashboard de Visão geral:
- Os valores, incluindo receita, são LTV. Consulte LTV vs. dados de atividade.
- A coluna Receita inclui toda a receita, inclusive a receita de anúncios e de compras in-app.
- Faça uma análise detalhada da hierarquia de anúncios (fonte de mídia, campanha, conjunto de anúncios, geolocalização) para visualizar os eventos monetizados no relatório.

No dashboard de Atividade:
- Os valores, inclusive a receita, são baseados em dados de atividade. Consulte LTV vs. dados de atividade.
- A média de ações por usuário indica a tendência dos usuários de interagir com os anúncios apresentados no aplicativo.
Exemplos
Três usuários instalam um aplicativo em 31 de dezembro de 2017. Eles são atribuídos da seguinte forma:
- Usuário A: rede A
- Usuário B: rede B
- Usuário C: orgânico
O aplicativo é integrado com cinco plataformas de monetização diferentes. Cada plataforma usa um evento in-app único no SDK da AppsFlyer, segundo mostram os dados abaixo:
- Facebook Audience Network: fb_ad_view
- Chartboost: chartboost_ad_view
- Admob: admob_ad_view
- Applovin: applovin_ad_view
- IronSource: is_ad_view
Os usuários recebem anúncios quatro dias após a instalação, da seguinte forma:
Usuário |
Rede de UA |
fb_ |
chartboost_ |
admob_ |
applovin_ |
is_ad_view |
Total |
---|---|---|---|---|---|---|---|
A |
Rede A 31/12/2017 |
01/01/2018 US$1 |
02/01/2018 US$1 |
03/01/2018 US$1 |
04/01/2018 US$1 |
|
US$4 |
B |
Rede B 31/12/2017 |
02/01/2018 US$1 |
|
04/01/2018 US$1 |
|
US$2 | |
C |
Orgânico 31/12/2017 |
01/01/2018 US$1 |
02/01/2018 US$1 |
US$2 |
Olhando para os dados, agora podemos resumir a receita coletada por usuário, por dia (e por evento in-app):
Usuário |
01/01/2018 |
02/01/2018 |
03/01/2018 |
04/01/2018 |
LTV total |
---|---|---|---|---|---|
A |
US$1 |
US$1 |
US$1 |
US$1 |
US$4 |
B | US$1 | US$1 | US$2 | ||
C | US$1 | US$1 | US$2 | ||
Total | US$2 | US$3 | US$1 | US$2 | US$8 |
Entendendo os relatórios:
Conforme mencionado, a receita de anúncios está vinculada ao LTV do usuário. Portanto, o período de tempo selecionado no dashboard representa o cohort de instalações para os quais a receita é agregada até a hora e o dia atuais. Vamos examinar um relatório com duas seleções de datas diferentes:
Relatório agregado: datas selecionadas: 31/12/2017-05/01/2018
Rede |
Receita do LTV |
---|---|
Orgânico |
US$2 |
Rede A |
US$4 |
Rede B |
US$2 |
Rede C |
US$2 |
Nesse caso, o cohort são os usuários que instalaram o aplicativo de 31/12/2017 até o dia em questão, 05/01/2018. Toda a receita gerada por esses usuários está vinculada à fonte de aquisição e representada sob o LTV do usuário.
Dados brutos de receita publicitária
Os relatórios de dados brutos de receita de anúncios contêm dados fornecidos por redes de monetização com integração a nível do usuário com a AppsFlyer.
Princípios de dados brutos de receita de anúncios
- Os dados são agregados pelo número de impressões exclusivas por usuário. Impressões exclusivas são derivadas da combinação de rede de monetização de anúncios, bloco de anúncios e posicionamento.
- Atualização de dados brutos é idêntica à da receita de anúncios a nível de usuário no dashboard de Atividade.
Relatório |
Página de dados de exportação |
Pull API | Data Locker |
---|---|---|---|
Receita de anúncios atribuída (não-orgânica) | ✓ | ✓ | ✓ |
Receita publicitária orgânica | ✓ | ✓ | ✓ |
Receita de anúncios de retargeting | ✓ | ✓ | ✓ |
Características e campos de dados
Os campos nos relatórios de receita de anúncios são preenchidos:
- Pelo próprio evento de receita de anúncios, listado na tabela abaixo. Esses campos são divididos em:
- Específico: campos específicos para a receita de anúncios. Por exemplo, impressões e posicionamento. Atenção! Os campos preenchidos diferem por parceiro de monetização, conforme mostrado na tabela Campos por rede nesta seção.
- Contexto: campos com um significado semelhante em outros relatórios de dados brutos. Por exemplo, nome do evento, valor do evento, moeda.
- Como resultado da atribuição do evento à fonte de mídia que trouxe o usuário. Isso significa que esses campos são copiados do evento de conversão que trouxe o usuário. Por exemplo, fonte de mídia e campanha. Esses campos não estão listados na tabela a seguir.
api_name | Nome do campo | Tipo de campo | Descrição |
---|---|---|---|
event_time | Data/hora do evento | Contexto |
A data à qual a receita é atribuída |
event_name | Nome do evento | Contexto |
Sempre definido como af_ad_revenue |
event_revenue | Moeda da receita do evento | Contexto |
|
event_revenue_currency | Moeda do evento | Contexto |
Moeda da receita do evento |
event_revenue_XXX | Receita do evento XXX | Contexto |
|
país | País |
|
País de instalação da conversão de instalação |
ad_unit |
Unidade do anúncio |
Específico |
Tipo de anúncio |
segment | Segment | Específico | Nome do posicionamento do anúncio |
monetization_network | Monetization network | Específico | Rede que envia o anúncio |
Impressões | Impressões | Específico | Número de vezes que o usuário viu o anúncio |
mediation_network | Mediation network | Específico | Rede de mediação que reporta o evento para a AppsFlyer |
Nome para exibição | Admob | ironSource | AppLovin MAX | Appodeal | Fyber |
---|---|---|---|---|---|
Ad unit | ✓ | ✓ | ✓ | ✓ | ✓ |
Segment | - | (1) | - | - | - |
Posicionamento | - | ✓ | ✓ | ✓ | ✓ |
Monetization network | ✓ | ✓ | - | ✓ | - |
Impressões | - | - | ✓ | ✓ | - |
Mediation network | - | ✓ | ✓ | ✓ | - |
(1) O anunciante precisa configurar isso no ironSource |
Informações adicionais
FAQ
Como posso obter a receita total de anúncios de cada plataforma?
- A atribuição de receita de anúncios é vinculada e exibida em relação à fonte de aquisição de usuários.
- Isso fornece a visão do LTV do seu ROI e KPIs.
- Para visualizar a receita total de cada plataforma de monetização, use um evento in-app diferente para cada rede e siga o seguinte procedimento:
- No dashboard de Visão geral, acesse a tabela de relatório de performance agregada.
- Selecione até quatro eventos monetizados que representam as plataformas que você deseja consultar.
-
Faça o download do relatório, clique em Exportar CSV.
- Resuma a coluna Receita do evento monetizado da plataforma solicitada
- Observe que essa receita de anúncios total são dados de LTV, ou seja, é toda a receita gerada por uma rede de monetização para o seu aplicativo vinda de usuários, que instalaram durante o período específico.
A receita de anúncios está disponível na página de atividades?
Sim!
A página de Atividade relata a receita combinada de compras in-app e receita de anúncios. Observação: os dados de receita de anúncios são enviados à AppsFlyer diariamente, no dia seguinte ao evento.
Preciso ativar o parceiro na aba de Integração?
- Se você engaja com o parceiro apenas para monetização de anúncios (receita de anúncios): não ative a opção Ativar parceiro na aba Integração.
- Ative somente dados de Obter receita de anúncios na aba Receita de anúncios.
Como a receita de anúncios a nível do usuário é atribuída se um usuário tiver uma versão do aplicativo sem o SDK da AppsFlyer?
- A receita de anúncios é atribuída como orgânica.
Há uma discrepância entre os dados de receita de anúncios em diferentes dashboards e relatórios?
Podem haver discrepâncias entre os dados de receita de anúncios no dashboard de Visão geral e nos relatórios de dados brutos, além dos dashboards de Atividade e de Cohort. Isso ocorre porque:
- Os dados de receita publicitária nos painéis Coorte e Atividade, assim como os dados via Master API e Coorte API, são atualizados retroativamente; no painel Visão geral, e por meio da exportação de dados brutos e da Pull API, não é.
- Às vezes, os dados são exibidos nos dashboards de Atividade e de Cohort antes de aparecerem no dashboard de Visão geral.
- Os painéis incluem eventos marcados como
af_ad_revenue
e_monetized
, enquanto os dados brutos incluem apenas eventosaf_ad_revenue
. - Dispositivos desconhecidos podem estar levando a um aumento na receita do Dia 0 relatada nos painéis e relatórios de Coorte e LTV.
Características e limitações
Característica | Observações |
---|---|
Acesso da ad network | Não é possível acessar relatórios de Cohort |
Acesso das agências |
Agências:
|
Transparência da agência | Não suportado |
Fuso horário |
A receita de anúncios é processada diariamente. Em dados brutos, há um carimbo de data/hora baseado em 00:00:00 UTC, mas alinhado ao fuso horário do aplicativo. Isso significa que, para um evento em 2 de julho de 2021 UTC, para aplicativos em:
|
Moeda |
Na AppsFlyer:
|
Limitações |
Os eventos de receita de anúncios não estão disponíveis para:
Limitações de granularidade a nível do usuário:
|
Tipo de dados | Dados orgânicos e não-orgânicos são compatíveis. |
Atualização de dados | Receita de anúncios |
Dados históricos/retroativos |
|
Acesso do usuário da conta | Suportado |
SKAN | Compatível com a Admob e a conexão genérica do SDK por meio do evento af_ad_revenue. |
Dispositivos desconhecidos |
Quando não há dados de atribuição disponíveis para corresponder o evento de receita publicitária a (uma ocorrência comum para campanhas de retargeting):
|
Geolocalização/país |
No painel de Cooorte, quando a geolocalização é desconhecida (N/A), os dados marcados como N/A não são exibidos quando agregados pela geolocalização. |
Lista de parceiros integrados de receita de anúncios
parceira | Logotipo | Parâmetros de credenciais necessários | Granularidade de dados |
---|---|---|---|
![]() |
|
Nível agregado com geolocalização | |
Admost |
![]() |
|
Nível do usuário com geolocalização |
![]() |
|
Nível agregado com geolocalização | |
![]() |
|
Nível do usuário com geolocalização | |
![]() |
|
|
|
Bytedance Ads - tráfego na China | ![]() |
|
Nível agregado com geolocalização |
Chartboost | ![]() |
|
Nível agregado com geolocalização |
![]() |
|
Nível agregado com geolocalização | |
Fyber | ![]() |
|
Nível de usuário com geolocalização |
Google Marketing Platform - DV360/CM (DoubleClick) | ![]() |
|
Nível agregado com geolocalização |
Google Admob | ![]() |
|
Nível agregado com geolocalização |
Google Ads | ![]() |
|
Nível agregado com geolocalização |
IronSource | ![]() |
|
|
Mintegral |
![]() |
|
Nível agregado com geolocalização |
Tapjoy |
![]() |
|
Nível do usuário com geolocalização |
![]() |
|
Nível agregado com geolocalização |
|
TopOn |
![]() |
|
Nível do usuário com geolocalização |
Mediação Tradplus |
![]() |
|
Nível do usuário com geolocalização |
|
![]() |
|
Nível agregado com geolocalização |
Voodoo Ads | ![]() |
|
Nível agregado com geolocalização |
![]() |
|
Nível agregado com geolocalização |