A precisão e a atualização dos dados dependem do tipo de integração da atribuição de receita de anúncios, como mostrado na tabela a seguir.

Atenção: Diferentes tipos de integração do SDK exigem a ação de um desenvolvedor. Para a integração S2S, é necessário ter as credenciais de rede corretas.

Antes de começar:

• Solicite que o parceiro integrado de receita de anúncios forneça a você as credenciais da API.

Para ativar a integração da receita de anúncios com a ad network:

1. Na AppsFlyer, no menu lateral, selecione configurações > configurações de receita > receita de anúncios.
2. Em integração de receita de anúncios, clique em nova integração de receita de anúncios.

3. Selecione um parceiro de receita de anúncios e clique em Avançar.

   

   Atenção

   Se a sua solução de mediação não aparecer na lista de parceiros suportados, selecione Mediação personalizada e integre-a através da API do SDK de receita de anúncios da AppsFlyer.

4. Selecione o tipo de dados de receita de anúncios que você deseja receber. Atenção: Nem todas as ad networks oferecem todas as opções listadas abaixo.
   • Receita atribuída. Ou seja, receita com base na fonte de aquisição do usuário. Os relatórios de receita atribuída podem exibir:
     • Nível agregado via API S2S
       • Selecione o evento no qual basear a receita de anúncios. Por exemplo, se você escolher o evento af_app_opened, a receita total de anúncios será dividida entre todos os eventos de abertura do aplicativo, fornecendo a receita de anúncios por abertura do aplicativo.
     • Nível do dispositivo via S2S API.
       • Para Android: Certifique-se de que os desenvolvedores ativem a coleta deapp_set_id, pois algumas mediações podem fornecer apenas esse identificador. Consulte as instruções do desenvolvedor para Coletar AppSet ID.
       • Observação: Se você estiver ativando a API de receita de anúncios device-level para uma plataforma de mediação, deverá desativar as integrações de receita de anúncios das networks de monetização mediadas por ela. Caso contrário, você terá dados duplicados.
     • Nível de impressão via SDK.
       • Peça aos desenvolvedores do seu aplicativo que integrem a ad revenue SDK API da AppsFlyer.
     • Recomendado: Nível de impressão (via SDK) com nível de dispositivo (via API S2S).
       • Peça aos desenvolvedores do seu aplicativo que integrem a ad revenue SDK API da AppsFlyer.
     • Para Android: Certifique-se de que os desenvolvedores ativem a coleta deapp_set_id, pois algumas mediações podem fornecer apenas esse identificador. Consulte as instruções do desenvolvedor para Coletar AppSet ID.
     • Observação: Se você estiver usando uma plataforma de mediação, certifique-se de desativar as integrações de receita de anúncios para parceiros de monetização mediados pela plataforma antes de ativar a integração de receita de anúncios com a plataforma. Caso contrário, você terá dados duplicados.
5. Preencha as credenciais da API ou faça login, conforme exigido pelo parceiro integrado. Essa ação não é relevante para as integrações de SDK.
6. Clique em Salvar.
7. Para verificar se a conexão da API é operacional:
   • Se chave de API verificada aparecer, você concluiu o procedimento com sucesso.
   • Se qualquer outra mensagem for exibida, consulte a tabela Status e testes da integração de receita de anúncios e siga a ação corretiva recomendada. Em seguida, repita o procedimento.
8. A AppsFlyer coleta dados várias vezes por dia. Para mais informações, consulte Atualização de dados.
9. [Opcional] Faça o controle de qualidade e compare os dados de receita publicitária que você vê na AppsFlyer com os dados de receita de anúncios que você vê nos painéis do seu parceiro de mediação e do parceiro de UA. Saiba mais
10. [Opcional] Compartilhe dados de receita de anúncios com seus parceiros via sinais de UA e postbacks de eventos de receita de anúncios.

Atenção: se você mudar de um tipo de integração para outro, essa alteração entrará em vigor às 12h UTC do dia seguinte. 

Para visualizar, editar ou excluir integrações:

1. Na AppsFlyer, no menu lateral, selecione configurações > configurações de receita > receita de anúncios e selecione o seu app.
   Uma lista de todas as suas integrações de parceiros é exibida, juntamente com informações sobre o produto e o tipo de integração, o status da integração e os nomes dos eventos de receita publicitária.
2. Passe o mouse sobre a integração e clique em editar ou excluir conforme necessário.

Quando um aplicativo usa duas plataformas de mediação com tipos de integração de API (nível agregado ou device-level), ambas associadas à mesma network de monetização, pode ocorrer duplicação parcial dos dados de receita de anúncios. Nesses casos, cada plataforma de mediação reporta toda a receita de anúncios gerada por sua network de monetização associada, independentemente de essa receita ter sido gerada enquanto era mediada por apenas uma das plataformas.

Para evitar a duplicação parcial dos dados:

• Se disponíveis, use integrações a nível de impressão via SDK. Os dados em nível de impressão reportados dessa forma não são deduplicados. O SDK reporta cada impressão uma vez, então não há sobreposição a ser removida.
• Para integrações via API, deduplique a receita de anúncios:
  1. Na AppsFlyer, no menu lateral, selecione configurações > configurações de receita > receita de anúncios.

  2. Em Configurações gerais, clique em Desduplicar receita de anúncios quando dois parceiros de mediação fizerem referências cruzadas. Observação: Não marque a caixa se as 2 plataformas de mediação mediarem formatos de anúncio diferentes. Por exemplo, quando a plataforma 1 mostra Banner e Intersticial, e a plataforma 2 mostra AppOpen e anúncios nativos.

      Importante!

     A configuração é sempre ignorada para:

     • Integrações no nível de impressão (SDK) — todos os Parceiros.
     • Integrações no nível do dispositivo (API) - para AppLovin MAX ou ironSource (Unity LevelPlay)

     Elas já não contêm dados duplicados, então não há nada para desduplicar.

A granularidade agregada das receitas de anúncios funciona da seguinte forma:

• A rede integrada relata a receita diária total, detalhada por geo.
• A AppsFlyer obtém a receita efetiva por ação (eRPA) através da divisão da receita de anúncios pelo número de instâncias de um evento de disparo.
• A AppsFlyer cria um evento _monetized que inclui o eRPA total para cada dispositivo atribuído. Por exemplo, ad_matched_monetized.
• Usando o eRPA, a receita é atribuída às fontes de mídia.
• Você pode usar um dos seguintes tipos de eventos:
  • Evento in-app exclusivo de monetização, que requer modificações no aplicativo.
  • Evento af_app_opened disponível por padrão.
• Não informe os valores de receita em eventos in-app em paralelo a uma integração de receita de anúncios. Isso faz com que a receita de anúncios seja duplicada no dashboard, pois a AppsFlyer obtém os dados de receita da network de monetização por meio da integração. 

Receita de anúncios agregada usando eventos

Comparação de métodos de eventos in-app

O status operacional da integração da receita de anúncios é disponibilizado da seguinte forma:

• Dashboard do status da integração: Lista de parceiros com os quais a integração da receitas de anúncios está ativada para um ou mais aplicativos da sua conta.
• Botão Testar conexão: Disponível quando você adiciona ou edita uma integração de receita de anúncios. Use-o para verificar se a integração está operacional.

Para verificar se a integração está funcionando:

1. Para verificar se a conexão da API é operacional:
2. Uma mensagem informando que a chave da API foi verificada é exibida. Se qualquer outra mensagem aparecer, siga as orientações de ação corretiva na tabela abaixo.

A receita de anúncios mostra a qualidade dos usuários obtidos de diferentes fontes ao longo do tempo. À medida que os usuários continuam abrindo o aplicativo e interagindo com anúncios, o LTV deles aumenta.

Atenção: pode haver discrepâncias entre os dados de receita de anúncios em diferentes dashboards e relatórios.

A atribuição de receita de anúncios está disponível da seguinte forma:

• Baseado em LTV:
  • Nos dashboards: visão geral, eventos
  • Relatórios de LTV
  • Dashboard e relatórios de cohort
  • Master API
• Baseado em atividades:
  • Dashboard: atividades
  • Dados brutos de receita de anúncios

Dashboard de visão geral - relatório de performance agregada

No dashboard de visão geral:

• Os valores, incluindo a 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 (canal de mídia, campanha, conjunto de anúncios, geolocalização) para visualizar os eventos monetized no relatório.

Painel de eventos

No dashboard de atividades:

• Os valores, incluindo a receita, são baseados na data da 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 exibidos no aplicativo. 

Exemplos

Três usuários instalaram um aplicativo em 31 de dezembro de 2017. Eles são atribuídos da seguinte forma:

• Usuário A: Network A
• Usuário B Network B
• Usuário C: Orgânico

O aplicativo está integrado a cinco plataformas de monetização diferentes. Cada plataforma usa um evento in-app exclusivo no SDK da AppsFlyer:

• Meta Audience Network: fb_ad_view
• Chartboost: chartboost_ad_view
• Admob: admob_ad_view
• Applovin: applovin_ad_view
• IronSource: is_ad_view 

Quatro dias após a instalação, os usuários visualizam os anúncios da seguinte forma:

Olhando para os dados, podemos resumir a receita coletada por usuário, por dia (e por evento in-app):

Entendendo os relatórios:

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 com a receita é agregada até a hora e o dia atuais. Vamos analisar um relatório com duas seleções de datas diferentes:

Relatório agregado: Datas selecionadas: 2017-12-31-2018-01-05

Nesse caso, o cohort é composto por usuários que instalaram o aplicativo entre 2017-12-31 e o dia atual, 2018-01-05. Toda a receita gerada por esses usuários está vinculada à fonte de aquisição e refletida no LTV do usuário.

Os relatórios de dados brutos de receita de anúncios contêm dados de networks de monetização com integração device-level ou impression-level com a AppsFlyer. 

Princípios dos dados brutos de receita de anúncios

• Os dados são agregados pelo número de impressões exclusivas por usuário. As impressões exclusivas são derivadas da combinação da network de monetização de anúncios, da unidade de anúncio e do posicionamento.
• Os dados brutos a nível de impressão são:
  • Agregados ao nível device-level e disponíveis em relatórios device-level.
  • Disponíveis como relatórios impression-level no Data Locker.

Características e campos dos dados

Os campos nos relatórios de receita de anúncios são preenchidos:

• Pelo próprio evento de receita de anúncios e listado na tabela a seguir. Esses campos são divididos em:
  • Específicos: 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.
  • Contextuais: campos com um significado parecido em outros relatórios de dados brutos. Por exemplo, nome do evento, valor do evento e 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, canal de mídia e uma campanha. Esses campos não estão listados na tabela a abaixo. 

Campos preenchidos pela receita de anúncios

Campos por rede

A atualização dos dados depende do tipo de integração e do método de relatório.

Para integrações da S2S API, a data mais recente de disponibilização dos dados varia:

• Em dashboards e relatórios de dados brutos (via Data Locker), disponibilizados a partir do Dia X+1, 12 AM UTC, aproximadamente 4 vezes por dia, de 6 em 6 horas. E nos dias 2, 3, 7 e 14, uma vez por dia.

Para integrações de SDK em nível de impressão, a data mais recente de disponibilização dos dados varia:

• Dashboards (métricas de atividade e cohort): contínua (15 a 60 minutos após a ocorrência do evento)

• Na melhor das hipóteses, os dados são disponibilizados nos dashboards e relatórios de dados brutos (via Data Locker), no Dia X a partir das 5h UTC, atualizados aproximadamente 6 vezes por dia, a cada 4 horas.

• Relatórios de dados brutos de nível de impressão (via Data Locker) no dia X a partir da 1h UTC, atualizados a cada hora.

Para nível de impressão (via SDK) com nível de dispositivo (via S2S API), você obtém a atualização dos dados para o Dia X com a precisão dos dados para os Dias X+1, da seguinte forma:

• Para dados no nível da impressão que chegam via SDK:

  • Dashboards (métricas de atividade e cohort): contínua (15 a 60 minutos após a ocorrência do evento)

  • Na melhor das hipóteses, os dados são disponibilizados nos dashboards e relatórios de dados brutos (via Data Locker), no Dia X a partir das 5h UTC, atualizados aproximadamente 6 vezes por dia, a cada 4 horas.

  • Relatórios de dados brutos de nível de impressão (via Data Locker) no dia X a partir da 1h UTC, atualizados a cada hora.

• Para dados no nível do dispositivo que chegam via API S2S:

  • Em dashboards e relatórios de dados brutos (via Data Locker), disponibilizados a partir do Dia X+1, 12 AM UTC, aproximadamente 4 vezes por dia, de 6 em 6 horas. E nos dias 2, 3, 7 e 14, uma vez por dia.

Para a Exportação de dados brutos e Pull API, independentemente do tipo de integração ou pacote ROI360 (Advanced ou Standard), os dados de um determinado dia ficam disponíveis no dia seguinte, às 6 PM UTC no Dia X+1. Os dados não são atualizados após esse horário para essas ferramentas.

Atenção: A disponibilidade de dados intradiários em dashboards requer uma assinatura ROI360 Advanced.

Veja também:

• Relatórios de Revenue ETL

Lembre-se do seguinte ao migrar da granularidade agregada para a granularidade device-level:

• 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 várias vezes ao dia, a partir das 03:00 UTC, usando as opções de granularidade selecionadas naquele momento.
• A granularidade no nível do dispositivo não exige que você defina eventos in-app (como você faz para relatórios no nível agregado). Você pode continuar enviando esses eventos, mas eles não afetam o relatório de granularidade no nível do dispositivo.