Guia ROI360 - atribuição de receita de anúncios

A precisão e a atualização dos dados dependem do tipo de integração da atribuição de receita de anúncios, conforme a 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:

• Peça ao parceiro integrado que ele forneça 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 adicionar um parceiro de receita e clique em avançar.
   
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 será dividida entre todos os eventos abertos pelo aplicativo, resultando na receita de anúncios por abertura do aplicativo.  
     • Nível do dispositivo via S2S API.
       • Para Android: Certifique-se de que os desenvolvedores ativaram a coleta de app_set_id, pois algumas mediações podem fornecer apenas esse identificador. Consulte as instruções do desenvolvedor para Coletar AppSet ID.
       • Atenção: se você ativar a API de receita de anúncios no nível do dispositivo para uma plataforma de mediação, você deve desativar as integrações de receita das redes 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 ativaram a coleta de app_set_id, pois algumas mediações podem fornecer apenas esse identificador. Consulte as instruções do desenvolvedor para Coletar AppSet ID.
     • Atenção: Se você estiver usando uma plataforma de mediação, desative as integrações de receita de anúncios 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 nessa rede. 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. 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 o procedimento com sucesso. 
   • Se qualquer outra mensagem aparecer, consulte Status e teste da API de receita de anúncios e repita o procedimento.
8. Se não houver a opção de testar conexão, o procedimento está concluído.
   A AppsFlyer coleta dados do parceiro várias vezes por dia.
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 diferentes tipos de integração de API (nível agregado ou nível do dispositivo), sendo que ambas estão associadas à mesma rede de monetização, pode ocorrer uma duplicação parcial dos dados de receita de anúncios. Nesses casos, cada plataforma de mediação relata toda a receita gerada por sua rede de monetização associada, mesmo que essa receita tenha sido gerada sendo mediada por apenas uma das plataformas.

Para evitar a duplicação parcial dos dados:

1. Se disponíveis, use integrações a nível de impressão via SDK.
   • Os dados não serão duplicados se ambas as plataformas de mediação usarem integrações a nível de impressão via SDK.
   • Se você tiver várias integrações, e uma delas for o SDK, recomendamos que você também faça suas outras integrações por meio do SDK.
2. Para integrações via API, desduplique 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. Atenção: Não marque a caixa se as 2 plataformas de mediação:
      • Fazem a mediação de diferentes formatos de anúncios. Por exemplo, quando a plataforma 1 mostra Banner e Intersticial, e a plataforma 2 mostra AppOpen e anúncios nativos. 
      • Têm integrações a nível de impressão via SDK.

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

• A rede integrada relata a receita total por dia, detalhada por geolocalização.
• 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, que está 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 rede de monetização através 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.
  • Alguns parceiros permitem que você teste a conexão da API. Nesse caso, o botão de testar conexão é exibido. 
  • Para verificar se a conexão da API é operacional:
  • Clique em testar conexão.
    Uma mensagem informando que a chave da API foi verificada é exibida. Se esse não for o caso, siga as orientações de ação corretiva na tabela a seguir.  

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 engajando com anúncios, o LTV aumenta.

Atençã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:
  • 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 (fonte de mídia, campanha, conjunto de anúncios, geolocalização) para visualizar os eventos monetizados no relatório.

Dashboard de eventos

No dashboard de atividades:

• 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 exibidos no aplicativo.  

Os relatórios de dados brutos de receita de anúncios contêm dados fornecidos por redes de monetização com integração no nível do dispositivo ou no nível da impressão.  

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. Impressões exclusivas são derivadas da combinação entre a rede de monetização de anúncios, bloco de anúncios e posicionamento. 
• Os dados brutos a nível de impressão são:
  • Agregados no nível do dispositivo e estão disponíveis em relatórios no nível do dispositivo.
  • Disponíveis da mesma forma que ocorre nos relatórios no nível de impressão no Data Locker.
  • A atualização dos dados brutos é idêntica à da receita de anúncios no nível do dispositivo no dashboard de atividades.

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, listado na tabela abaixo. 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, 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 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 (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 que os dados ficam disponíveis é:

• No melhor cenário, os dados são disponibilizados nos dashboards e relatórios (via Data Locker) começando no Dia X a partir das 5 AM UTC, atualizados aproximadamente 6 vezes por dia, a cada 4 horas.
• Em relatórios de dados brutos no nível de impressão (via Data Locker), no dia X a partir da 1 AM UTC, atualizados a cada hora.

Para o nível de impressão (via SDK) com nível de dispositivo (via API S2S), os dados são atualizados para o Dia X, com a precisão dos Dias X+1, da seguinte forma:

• Para dados no nível de impressão coletados via SDK:
  • No melhor cenário, os dados são disponibilizados nos dashboards e relatórios (via Data Locker) começando no Dia X a partir das 5 AM UTC, atualizados aproximadamente 6 vezes por dia, a cada 4 horas.
  • Em relatórios de dados brutos no nível de impressão (via Data Locker), no dia X a partir da 1 AM UTC, atualizados a cada hora.
• Para dados no nível do dispositivo que chegam via API S2S:
  • Em dashboards e relatórios (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.

Atenção: ao alterar o tipo de integração, os dados recebidos por meio da integração antiga em datas passadas não serão preenchidos pela nova integração. Por exemplo, se no dia X o tipo de integração foi alterado de SDK para S2S, os dados serão extraídos do dia X+1 em diante e não serão extraídos dos dias anteriores ao dia X.

• 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 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.