Relatórios de dados brutos

Visão geral: Os dados a nível de linha (também conhecidos como dados brutos) descrevem eventos de usuários, como instalações, eventos in-app, visitas ao site, instalações bloqueadas pelo Protect360, receitas de anúncios e postbacks associados ao usuário enviados aos parceiros. Os dados brutos estão disponíveis por download, API e Data Locker.

Relatórios de dados brutos – ferramentas e relatórios

Os relatórios de dados brutos permitem analisar o comportamento e as jornadas do usuário, reconciliar contas de ad network e enriquecer seus sistemas de CRM e BI. Ao usar dados brutos, você aumenta sua capacidade de analisar, otimizar e melhorar a performance do aplicativo.  

Os relatórios são disponibilizados por ferramentas de relatórios. As ferramentas possuem características distintas, adequadas a diferentes casos de uso. Por exemplo, para reconciliar uma determinada conta de ad network, faça o download do relatório conforme necessário por meio da página Exportar dados. Para fazer com que os dados de performance do usuário sejam enviados aos seus sistemas de BI, obtenha os dados de forma programática usando o Data Locker ou a Pull API.

Dica

Quer entender mais sobre seus dados brutos? Confira nosso  curso rápido e informativo no portal de aprendizado da AppsFlyer.

Ferramentas de relatórios—características e recursos

Os relatórios são disponibilizados usando as ferramentas de relatório listadas nesta seção.

Considerações:

  • O intervalo de datas do relatório está relacionado à data da atividade (real) em que o evento ocorreu. Isso contrasta com os relatórios agregados em que o intervalo de datas é baseado em LTV.
  • Descrições dos campos — consulte o dicionário de campos de dados.

Ferramentas de relatório

Ferramenta Descrição Vários / um único app (1) Capacidade de atualização de dados (2) Incorporar em scripts Fuso horário Moeda
Página de exportação de dados em bruto
  • Baixe o relatório usando a interface do usuário
  • Formato: Arquivo CSV
Único Atualizado continuamente x

Específico do aplicativo

Específico do aplicativo
Pull API*
  • Transfira o relatório usando chamadas API.
  • Formato: Arquivos CSV
Único Atualizado continuamente
  • Selecionável
  • Predefinição: UTC
  • Selecionável
  • Predefinição: USD
Data Locker P
  • Dados transmitidos para um bucket na nuvem
  • Sem limitações de volume
  • Janela de disponibilidade de dados: 14 dias.
  • Formato: CSV ou parquet
Múltiplos Atualizado continuamente com um atraso de várias horas UTC USD 
Push API P
  • Dados da jornada do usuário (instalações, eventos in-app, retargeting, SKAN) enviados para seus servidores em tempo real.
  • Formato: JSON ou parâmetros de query
Pode usar o mesmo endpoint Minutos após o evento ser registrado na AppsFlyer UTC + específico do app USD + específico do app
Dados de conversão do SDK (3)
  • Obtenha dados de conversão de atribuição no aplicativo.
  • Formato: JSON
N/A  Tempo real <5 segundos   UTC N/A

Notas e abreviaturas:
(1) Suporte para vários apps
(2) A atualização real dos dados depende do relatório em si, pois alguns relatórios são diários.
(3) Os dados de conversão do SDK recuperam dados de atribuição do usuário em menos de 5 segundos a partir da primeira inicialização do aplicativo e, portanto, é o método menos preciso.
(P) Funcionalidade premium
(*) Aplicam-se quotas de geração de relatórios

Limitações da ferramenta

Limitação  Pull API (*) Push API Data Locker SDK
Dados de conversão
Limite de dados 1 milhão de linhas por chamada N/A N/A N/A
Opções de seleção de dados Selecione os tipos de dados. Opções limitadas para seleção de campos Selecione os tipos de dados, campos e eventos in-apps Selecione os tipos de dados, campos e eventos in-apps Não
Janela de disponibilidade de dados 90 dias N/A 14 dias  Vitalício (disponível no SDK)

(*) Aplicam-se quotas de geração de relatórios

Considerações de integração

Consideração  Pull API Push API Data Locker SDK
Dados de conversão
Desenvolvimento do lado do servidor Opcional Obrigatório Opcional Opcional
Requer processamento de dados Opcional Obrigatório Opcional Opcional
Risco de perda de dados Não Sim, se os servidores de recepção estiverem inativos Não Pequeno, se houver atrasos na resposta da ad network
Custos de processamento cliente-servidor Nenhum Alto Baixo Nenhum (a menos que os dados sejam enviados para os servidores)
Manutenção cliente-servidor Nenhum Alto Baixo Nenhum (a menos que os dados sejam enviados para os servidores)
Formato de dados Arquivo CSV JSON ou parâmetros de query CSV ou parquet JSON

Os registros de dados brutos que ocorrem em um determinado contexto são agrupados em relatórios. Por exemplo, instalações não orgânicas, eventos in-app orgânicos. Para facilitar a explicação, os relatórios são agrupados da seguinte forma:

  • Jornada do usuário: use para rastrear a jornada e o engajamento de um usuário com o aplicativo.
    Por exemplo: clique > instalação > evento in-app > desinstalação.
  • Funcionalidade: relacionada a uma determinada funcionalidade da AppsFlyer, mas não faz parte da jornada principal do usuário. Por exemplo, postbacks para ad networks, relatórios de fraude e de regras de validação e relatórios de receita publicitária no nível do usuário.

Campos de relatório

O dicionário de campo de dados brutos contém campos relevantes para relatórios de jornada do usuário e alguns campos do relatório de recurso. Os princípios são os seguintes:

  • Jornada do usuário:
    • conjunto comum de campos.
    • O preenchimento do campo depende do contexto da jornada.  Por exemplo, relatórios não orgânicos contêm a fonte de mídia creditada por trazer o usuário.  Os campos de atribuição em relatórios orgânicos não são preenchidos porque não há fonte de mídia.  
  • Funcionalidade: têm um conjunto exclusivo de campos ou contêm campos de jornada do usuário e campos adicionais relevantes para a funcionalidade específica. Por exemplo, os relatórios da SKAdNetwork têm uma lista exclusiva de campos, já os relatórios de postback contêm os campos de jornada do usuário e campos adicionais relacionados ao envio de postback aos parceiros.  

Dica! A melhor forma de se familiarizar com os relatórios é visualizá-los. Você pode fazer o download dos seus relatórios na página Exportar dados.  

Para facilitar a compreensão, os campos de jornada do usuário são divididos em grupos com base no contexto.

Grupos de campos de dados brutos da jornada do usuário

Grupo de campos Relevante para usuários orgânicos Exemplos de campos
Aplicativo Sim App ID, nome do app, versão do app, versão do SDK, ATT
Atribuição

Não, exceto para a hora da instalação

Hora da instalação, hora do toque atribuído, fonte de mídia, campanha, adset, anúncio, parceiro, tipo de conversão de retargeting

Atribuição de colaboradores Não Parceiro colaborador, tipo de correspondência
Informação do dispositivo Sim Advertising ID, GAID, OAID, tipo de dispositivo, customer user ID
Localização do dispositivo Sim Endereço IP, cidade, país
Evento

Sim

Preenchido nos relatórios de eventos in-app:

Nome do evento, valor do evento, receita do evento

Relatórios de jornada do usuário

Raw_data_-_User_acquisition_.png

Noções básicas da jornada do usuário

Os relatórios de jornada do usuário contêm dados coletados para eventos que ocorrem durante a vida útil de um usuário. Os dados são divididos em relatórios de acordo com:

  • Fonte do usuário: orgânica ou não orgânica
  • Contexto da jornada:
    • Engajamento com anúncios antes da instalação do aplicativo (impressões e cliques)
    • Aquisição
    • Retargeting

Relatórios de aquisição de usuários (UA)contêm:

  • As impressões e cliques que ocorrem antes da instalação feita por qualquer usuário potencial que engaja com um anúncio.
  • Evento de instalação.
  • Eventos in-app subsequentes realizados pelo usuário.

Os relatórios de retargeting incluem:

  • As impressões e cliques que ocorrem quando o usuário é redirecionado.
  • Eventos de conversão: Reengajamento ou reatribuição
  • Eventos in-app subsequentes realizados como parte do reengajamento. Considere:
    • Os dados de retargeting são sempre de origem não orgânica.
    • Os eventos in-app de retargeting estão nos relatórios tanto de UA quanto de eventos in-app de retargeting. Consulte a metodologia de atribuição dupla de retargeting.

      Raw_data_-_Retargeting.png

Para seguir uma jornada do usuário, combine os relatórios relacionados à parte da jornada que lhe interessa, por exemplo, instalações e eventos in-app. Depois isso, classifique o relatório usando o AppsFlyer ID, o horário do evento e o tipo de relatório. O resultado são os eventos de um determinado usuário ao longo do tempo, ou seja, a jornada do usuário. 

Disponibilidade do relatório da jornada do usuário

  • A disponibilidade do relatório depende do seu plano de assinatura.
  • Os relatórios podem incluir usuários orgânicos, usuários não orgânicos ou ambos, conforme indicado.
  • As políticas de retenção se aplicam aos relatórios de dados brutos históricos, dependendo da ferramenta de relatório e da origem dos dados brutos. Em geral, os dados estão disponíveis para os 90 dias anteriores. Atenção! As políticas de retenção não se aplicam a dados agregados. 

Relatórios de jornada do usuário

Categoria Exclusivo para Data Locker Tópico do relatório Orgânico Não orgânico
Aquisição de usuários Cliques N/A
Retargeting Cliques de campanhas de retargeting  Retargeting sempre não orgânico
Aquisição de usuários Impressões N/A
Retargeting Impressões de campanhas de retargeting Retargeting sempre não orgânico
Aquisição de usuários - Instalações 
Aquisição de usuários - Eventos in-app 
Aquisição de usuários - Receita de anúncios atribuída -
Aquisição de usuários - Receita publicitária orgânica -
Retargeting - Receita publicitária de retargeting Retargeting sempre não orgânico
Retargeting - Conversões de retargeting (reengajamentos e reatribuições) Retargeting sempre não orgânico
Retargeting - Retargeting de eventos in-app (reengajamentos e reatribuições) Retargeting sempre não orgânico
Retargeting   Sessões de retargeting (reengajamentos e reatribuições) Retargeting sempre não orgânico
Aquisição de usuários   Sessões
Aquisição de usuários - Desinstalações não orgânicas  -
Aquisição de usuários - Desinstalações orgânicas -
Aquisição de usuários Engajamento entre plataformas

Descrições do relatório de jornada do usuário

Cliques e impressões

Relatório Características
Contexto Um usuário engaja com uma campanha e clica ou visualiza um anúncio.
Características Os relatórios contêm um registro do link de atribuição e cabeçalhos HTTP presentes quando um usuário clica ou visualiza um anúncio.
Caso de uso
  • Otimize campanhas que não levam a um aplicativo aberto (instalação, reatribuição, reengajamento).
  • Faça o retargeting desses usuários usando campanhas diferentes.
Exemplo de relatório Cliques
Observações

Dados de SRN não disponíveis.

Usuários restritos Em alguns casos, devido a regras de privacidade, os dados de impressão e cliques são restritos (não têm identificadores de usuário) ou não estão disponíveis. A disponibilidade depende da fonte de mídia e da plataforma.  

Instalações e conversões de retargeting

Nome do relatório 

Aquisição de usuários: Instalações

Retargeting: Conversões
Contexto

Quando um usuário abre um aplicativo pela primeira vez.

Depois que um usuário engaja com um anúncio de retargeting e, em seguida, abre o aplicativo. Uma conversão de retargeting é um reengajamento ou reatribuição.

Consulte o Guia de atribuição de retargeting. 
Casos de uso
  • Gerar relatórios agregados usando campos não disponíveis através das ferramentas de análise da AppsFlyer.
  • Combine-os com outros relatórios para realizar análises avançadas e transversais.
  • Analise a performance em diferentes dimensões, como cidades, áreas metropolitanas e outros.  
  • Segmente utilizadores conforme o país, cidade e idioma para fins de direcionamento.
  • Obtenha IDs de dispositivo do usuário para fins de retargeting.
Semelhante às instalações.
Orgânico vs. não orgânico
  • Não orgânico: Os grupos de campos de atribuição e contribuição são preenchidos
  • Orgânico: O campo da fonte de mídia está em branco, nulo, ou orgânico. Lembre-se disso ao carregar dados em seus sistemas.  
Não aplicável
Exemplo de relatório Instalações O relatório de conversões de retargeting tem a mesma estrutura que o relatório de instalações. Alguns campos são preenchidos no contexto do retargeting. Consulte os dados brutos de retargeting

Eventos in-app

Relatório Características

Contexto do relatório

Lista cronológica das ações realizadas pelos usuários após a atribuição (instalação, reatribuição ou reengajamento)

Características

  • A estrutura do relatório e os campos são semelhantes aos dos relatórios de instalação.
  • Campos dedicados descrevem o evento. Isso inclui o nome, o valor, a receita e o horário do evento.  

Caso de uso

Use o relatório para:

  • Obter insights ao observar a jornada do usuário durante a vida útil do usuário

  • Combine os dados brutos de instalação e evento in-app-para seguir a jornada completa do usuário. 

Valores dos eventos

Campo valor do evento

O campo valor do evento contém todos os dados relacionados ao evento em um JSON. Você pode enviá-lo ao seu sistema de BI para análises mais aprofundadas.

Dica! Você pode usar o Power Query no Microsoft Excel para analisar os parâmetros de evento das strings JSON.


{"af_level":"10","af_user_journey":"3387","arena":"7","char_type":"paladin"}

Relatórios de receita

Os dados de receita e ROI na AppsFlyer são derivados do af_revenue enviado em eventos.  

Quando o parâmetro af_revenue é enviado em um evento in-app, a AppsFlyer usa isso para preencher o campo de receita do evento. É esse campo que a AppsFlyer usa para atualizar o dashboard e os relatórios agregados.  

Atenção! Use o parâmetro af_revenue apenas com eventos in-app que descrevem a receita real gerada.  Para outros eventos que envolvem receita, mas não são finais, por exemplo, add_to_cart, use parâmetros diferentes, como af_price

Exemplo de relatório

Eventos in-app

Observações

  • Os eventos in-app de retargeting são gravados duplamente nos relatórios de UA e de dados brutos de eventos in-app de retargeting. 
  • Os eventos in-app não incluem o evento de inicialização (af_app_opened). Isso está disponível no relatório de dados brutos das sessões
  • Localização geográfica: é derivado usando o endereço IP do usuário no momento em que o evento é executado. 

Sessões

Relatório Características
Contexto Quando o usuário abre o aplicativo, um evento de sessão é enviado para a AppsFlyer. O evento é registrado se o tempo mínimo entre o limite de sessões for excedido.  
Características

A estrutura do relatório é a mesma dos relatórios de eventos in-app. As sessões (eventos de sessão) estão em um relatório separado devido ao grande número desses eventos.

Caso de uso Entender o engajamento do usuário com o aplicativo.
Exemplo de relatório O relatório de sessões é semelhante ao relatório de eventos in-app. Atenção: em dados brutos, as sessões têm o nome do evento abertura.  

Desinstalações

Relatório Características
Contexto Registro de usuários que desinstalam o aplicativo.  
Características
  • Esse relatório é atualizado diariamente e não continuamente, como é o caso de outros relatórios da jornada do usuário.  
  • No relatório, o horário do evento representa o horário em que a AppsFlyer determina que o aplicativo foi desinstalado e não a desinstalação real em si. Consulte Métrica de desinstalação.
Campos disponíveis
  • Se o usuário vier de uma fonte de mídia não orgânica, os campos da fonte de mídia serão preenchidos.  
  • Considere que o evento de desinstalação é gerado pelos servidores da AppsFlyer depois de determinar que o usuário foi desinstalado. Consequentemente, muitos campos não são preenchidos.  
  • Os identificadores de usuário disponíveis são aqueles registrados no momento da instalação. O CUID nunca está disponível. 
  • Os campos relacionados à área geográfica são preenchidos com a localização do usuário no momento do engajamento com a fonte de mídia (clique ou impressão). Se o local do engajamento não estiver disponível, o local associado ao evento de instalação será usado.  
Exemplo de relatório Desinstalações Atenção! No exemplo, para maior clareza, a linha 2 indica quais campos são preenchidos, se os dados relevantes estiverem disponíveis.  
Casos de uso
  • Analisar o evento de desinstalação, dispositivo e características do usuário.
  • Criar um público de eventos de desinstalação para retargeting.

Disponibilidade do relatório da jornada do usuário por ferramenta

Relatório de engajamento com anúncios por ferramenta  

Relatório Exportar dados Pull API Data Locker Push API SDK
Dados de conversão
Impressões (1) - - - -
Cliques (1) - - - -
(1) Os dados de cliques e impressões são disponibilizados por não SRNS. As SRNs não disponibilizam esses dados.

Relatórios de aquisição de usuários por ferramenta  

Relatório Exportar dados Pull API Data Locker Push API Dados de conversão do SDK
Instalações
Sessões - - - -
Eventos in-app -
Desinstalações - -

Relatórios de dados brutos de retargeting por ferramenta

Relatório Exportar dados Pull API Data Locker Push API SDK
Dados de conversão
Cliques (1) - - - -
Conversões (reatribuições + reengajamentos)
Impressões (1) - - - -
Sessões - - - -
Eventos in-app -

(1) Os dados de cliques e impressões são disponibilizados por não SRNS. As SRNs não disponibilizam esses dados.

FAQ

Detalhes

Por que os dados brutos do Meta ads estão ausentes?

Por padrão, os dados brutos do Meta Ads são atribuídos à fonte de mídia restrita. Consulte dados a nível de usuário do Meta Ads.

Qual é a diferença entre os marcadores de data/hora?

Os marcadores de data e hora são comuns a todos os relatórios. Isso possibilita combinar relatórios diferentes.

Os seguintes marcadores de data/hora são relevantes:  

  • Hora de toque atribuído: hora em que o usuário engajou com um anúncio.
  • Hora de instalação : hora em que o aplicativo é iniciado pela primeira vez.
  • Hora do evento: hora em que o evento ocorre.

Considere: 

  • Nos relatórios de instalação, os horários de instalação e de evento são os mesmos.
  • Nos relatórios de eventos in-app, os horários de instalação e de evento são diferentes. A diferença pode mostrar o tempo que passa entre a abertura do aplicativo e o engajamento do usuário com o aplicativo.

Qual é o objetivo do campo de colaborador?

O campo de colaborador lista as fontes de mídia colaboradoras. Às vezes chamadas de Instalações Assistidas. No Protect360, elas também são usadas para a correção de atribuição de instalação que sofreu hijacking.

O que é o campo de palavras-chave—por que ele não está disponível em todas as instalações não-orgânicas? 

Instalações atribuídas ao Google Ads ou Apple Search Ads podem conter palavras-chave ou o keyword ID associados ao anúncio que levou à instalação. 

Dicas de relatório de instalação

Compreendendo a jornada do usuário

A jornada do usuário é uma série de etapas que o usuário executa antes de atingir uma meta, como comprar um produto ou reservar um voo. A ideia por trás da análise da jornada do usuário é ver o que o usuário faz no aplicativo, quão ativo ele é e qual valor ele traz durante um determinado período.

Você pode identificar e destacar as jornadas do usuário com a ajuda do AppsFlyer ID. O ID é gerado para cada instalação de aplicativo por dispositivo. O ID permanece inalterado durante todo o ciclo de vida do usuário (da instalação à desinstalação.) O ID persiste mesmo que o usuário redefina o device ID.

Como os relatórios de instalação e eventos in-app têm as mesmas estruturas, eles podem ser mesclados em um único relatório. No relatório mesclado, você pode agregar e filtrar usando o AppsFlyer ID e o Costumer User ID (se disponível) para analisar as jornadas do usuário.

 Exemplos

Usuário engajado—forte

  • Um usuário instalou o aplicativo em 20 de agosto às 09:31.
  • O relatório mesclado mostra que ele realizou compras em 20 de agosto às 10:31, 22 de agosto às 15:22 e 25 de agosto às 16:47.
  • A partir disso, concluímos que o usuário é um usuário engajado. Ele fez uma compra uma hora após a inicialização do aplicativo e continuou comprando nos dias seguintes à instalação.

Usuário engajado—fraco

  • Um usuário instala o aplicativo em 30 de julho. O relatório mesclado mostra que ele adicionou um item ao carrinho em 15 de agosto, mas não há eventos de compra subsequentes.
  • Você pode assumir que o usuário está hesitante em fazer uma compra e fazer o retargeting desse usuário com os itens já adicionados ao carrinho.

Analisando a jornada do usuário para otimização de campanhas

  • O gerente de aquisição de usuários (UA) de um aplicativo de viagens baixa os relatórios de eventos in-app e de instalação e os mescla.
  • Depois, para visualizar as jornadas do usuário no aplicativo, ele filtra ou agrega dados usando o AppsFlyer ID.
  • Ele percebe que um determinado usuário, identificado pelo AppsFlyer ID, fez download do aplicativo há 12 meses e reservou um voo vários dias depois.
  • Posteriormente, o usuário visualizou algumas ofertas de voos, mas não fez nenhuma reserva. Em uma análise mais profunda, o gerente de UA encontra mais usuários com o mesmo padrão e decide investigar mais a fundo.
  • Ele descobre que a maioria desses usuários veio do Anúncio A da Campanha B realizada na Fonte de Mídia C. Esse anúncio e campanha tinham como alvo usuários que desejavam viajar para um determinado destino.
  • Ao analisar a jornada do usuário, o gerente de UA entende que a campanha pode ter sido muito limitada ou muito focada, e que os usuários não estavam suficientemente engajados com o aplicativo.

Relatórios de funcionalidades

Relatórios que mostram funcionalidades adicionais disponíveis na plataforma

Postbacks

Use relatórios de postback para revisar cópias de dados enviados para uma ad network. Por exemplo, use-os para investigar discrepâncias. Esses relatórios são para fins informativos e não são necessários para a integração com as ad networks.

Relatórios de postback (disponíveis na página Exportar dados e Pull API)

Tópico do relatório Eventos enviados para a fonte de mídia atribuída
Instalações Instalações não orgânicas (UA)
Eventos in-app Eventos in-app não orgânicos

Postbacks de conversão de retargeting

Retargeting (reengajamento e reatribuição)

Eventos in-app de retargeting 

Eventos in-app de retargeting

Campos adicionais em relatórios de postback

Campo Observações
URL de postback

Alguns valores, como receita, podem não aparecer no campo apropriado, mas você ainda pode ver esses dados na URL do postback.

Método de postback  
Código de resposta HTTP de postback 200: confirma que o postback foi recebido pela ad network.
Mensagem de erro de postback   

Regras de fraude e de validação do Protect360

  • Veja os relatórios de dados brutos do Protect360 e das regras de validação
  • Ad networks e agências precisam da permissão do anunciante para acessar os relatórios do Protect360 e das Regras de Validação

Para dar permissão a um parceiro integrado para acessar o Protect360:

  1. Vá para colaborar > integrações ativas.  
  2. Escolha o parceiro integrado.
  3. Na aba Permissões, ative Acessar seu dashboard do Protect360 e dados brutos via API.
  4. Para dar acesso ao dashboard de eventos in-app (CPA), também ative Acessar dados de eventos in-app agregados.