Visão geral dos relatórios de dados brutos

Visão geral: Os dados ao nível da linha (também conhecidos como dados brutos) descrevem eventos relacionados com os utilizadores, tais como instalações, eventos na aplicação, visitas ao website, instalações bloqueadas pelo Protect360, receitas de anúncios geradas e postbacks associados ao utilizador enviados aos parceiros. Os relatórios de dados brutos podem ser acedidos através de download, API e Data Locker.

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

Os relatórios de dados brutos permitem-lhe analisar o comportamento e a jornada dos utilizadores, reconciliar as contas das redes publicitárias e enriquecer os seus sistemas de CRM e BI. Ao utilizar dados brutos, você aumenta a sua capacidade de analisar, otimizar e melhorar o desempenho da sua aplicação. 

Os relatórios são disponibilizados através de ferramentas de reporting. As ferramentas possuem características distintas, adequadas a diferentes casos de uso. Por exemplo, para reconciliar uma conta específica de rede de anúncios, descarregue o relatório conforme necessário na página Exportar dados. Para obter dados de desempenho do utilizador para carregar nos seus sistemas de BI, obtenha os dados programaticamente usando o Data Locker ou Pull API.

Dica

Quer compreender melhor os seus dados brutos? Consulte este breve e informativo curso no Portal de Aprendizagem da AppsFlyer.

Ferramentas de reporting – características e recursos

Os relatórios são disponibilizados através das ferramentas de reporting listadas nesta secção.

Considerações:

  • O intervalo de datas do relatório refere-se à data (real) de atividade em que o evento ocorreu. Isto contrasta com relatórios agregados, onde o período é baseado em LTV.
  • Descrições dos campos — consulte o dicionário de campos de dados.

Ferramentas de reporting

Ferramenta Descrição Aplicação múltipla/única (1) Capacidade de atualização de dados (2) Incorporar em scripts Fuso horário Moeda
Página de exportação de dados em bruto
  • Descarregar relatório usando a interface do utilizador
  • Formato: Arquivo CSV
Único Atualizado continuamente x

Específico da aplicação

Específico da aplicação
API Pull*
  • 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 
API Push P
  • Dados da jornada do utilizador (instalações, eventos na aplicação, retargeting, SKAN) enviados para os seus servidores em tempo real.
  • Formato: JSON ou parâmetros de consulta
Pode usar o mesmo endpoint Minutos após o evento ser registado na AppsFlyer UTC + específico da app USD + específico da app
Dados de conversão do SDK (3)
  • Obtenha os dados de conversão de atribuição na app.
  • Formato: JSON
N/A  Tempo real <5 segundos   UTC N/A

Notas e abreviaturas:
(1) Suporte para várias apps
(2) A frescura 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 os dados de atribuição do utilizador em menos de cinco segundos a partir do primeiro lançamento da app 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  API de extração (*) API Push 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 na aplicação Selecione os tipos de dados, campos e eventos na aplicação 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  Extrair API API Push 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 receção estiverem inativos Não Pequeno, em caso de atrasos na resposta da rede de anúncios
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 consulta CSV ou parquet JSON

Os registos de dados brutos que ocorrem num determinado contexto são agrupados em relatórios. Por exemplo, instalações não orgânicas, eventos orgânicos na aplicação. Para facilitar a explicação, os relatórios estão agrupados da seguinte forma:

  • Jornada do utilizador: Utilize para acompanhar a jornada e o envolvimento de um utilizador com a aplicação.
    Por exemplo: clique > instalar > evento na aplicação > desinstalar.
  • Funcionalidade: Estão relacionados a uma funcionalidade específica da AppsFlyer, mas não fazem parte da jornada principal do utilizador. Por exemplo, postbacks para redes de anúncios, relatórios de fraude e regras de validação, e relatórios de receita de anúncios ao nível do utilizador.

Campos de relatório

O dicionário de campos de dados em bruto contém campos relevantes para relatórios da jornada do utilizador e alguns campos de relatórios de funcionalidades. Os princípios são os seguintes:

  • Jornada do utilizador:
    • Ter um conjunto comum de campos.
    • A inclusão dos campos depende do contexto da jornada. Por exemplo, os relatórios não orgânicos identificam a fonte de media responsável por trazer o utilizador. Os campos de atribuição em relatórios orgânicos não são preenchidos porque não há uma fonte de media. 
  • Funcionalidade: Podem ter um conjunto exclusivo de campos ou incluir campos da jornada do utilizador e campos adicionais relevantes para a funcionalidade. Por exemplo, os relatórios SKAdNetwork possuem uma lista única de campos, enquanto os relatórios de postback contêm campos da jornada do utilizador e campos adicionais relacionados com o envio de postbacks para parceiros. 

Sugestão! A melhor forma de se familiarizar com os relatórios é visualizá-los. Pode descarregar os seus relatórios na página Exportar dados

Para facilitar a compreensão, os campos da jornada do utilizador são agrupados com base no contexto.

Grupos de campos de dados brutos da jornada do utilizador

Grupo de campos Relevante para utilizadores orgânicos Exemplos de campos
Aplicação Sim ID da aplicação, nome da aplicação, versão da aplicação, versão do SDK, ATT
Atribuição

Não, exceto para o tempo de instalação

Tempo de instalação, tempo de interação atribuído, fonte de media, campanha, conjunto de anúncios, anúncio, parceiro, tipo de conversão de retargeting

Atribuição dos contribuintes Não Parceiro contribuinte, tipo de correspondência
Informação do dispositivo Sim ID de publicidade, GAID, OAID, tipo de dispositivo, ID do utilizador cliente
Localização do dispositivo Sim Endereço IP, cidade, país
Evento

Sim

Preenchido nos relatórios de eventos na aplicação:

Nome do evento, valor do evento, receita do evento

Relatórios de jornada do utilizador

Raw_data_-_User_acquisition_.png

Fundamentos da jornada do utilizador

Os relatórios da jornada do utilizador incluem dados recolhidos sobre eventos que ocorrem durante a vida útil de um utilizador. Os dados são organizados em relatórios de acordo com:

  • Fonte do utilizador: orgânica ou não orgânica
  • Contexto da jornada:
    • Interação com anúncios antes da instalação da app (visualizações e cliques)
    • Aquisição
    • Retargeting

Os relatórios de aquisição de utilizadores (UA) incluem:

  • As visualizações e cliques ocorridos antes da instalação de qualquer utilizador potencial que interaja com um anúncio.
  • Evento de instalação.
  • Eventos subsequentes na app realizados pelo utilizador.

Os relatórios de retargeting incluem:

  • As visualizações e cliques que ocorrem quando o utilizador é alvo de retargeting.
  • Eventos de conversão: Reengajamento ou reafectação.
  • Eventos subsequentes na app realizados como parte do reengajamento. Considere:
    • Os dados de retargeting são sempre de origem não orgânica.
    • Os eventos de retargeting na app estão presentes nos relatórios de eventos do UA e de retargeting. Consulte a metodologia de dupla atribuição de retargeting.

      Raw_data_-_Retargeting.png

Para seguir a jornada do utilizador, combine os relatórios referentes à parte da jornada do seu interesse, como instalações e eventos na app. Após isso, organize o relatório utilizando o ID da AppsFlyer, o horário dos eventos e o tipo de relatório. O resultado são os eventos de um determinado utilizador ao longo do tempo, isto é, a jornada do utilizador. 

Disponibilidade do relatório de jornada do utilizador

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

Relatórios de jornada do utilizador

Categoria Exclusivo para Data Locker Tema do relatório Orgânico Não orgânico
Aquisição de utilizadores Cliques N/A
Retargeting Cliques de campanhas de retargeting  Retargeting sempre não orgânico
Aquisição de utilizadores Impressões N/A
Retargeting Impressões de campanhas de retargeting Retargeting sempre não orgânico
Aquisição de utilizadores - Instalações 
Aquisição de utilizadores - Eventos na aplicação 
Aquisição de utilizadores - Receita publicitária atribuída -
Aquisição de utilizadores - 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 - Eventos de retargeting na 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 utilizadores   Sessões
Aquisição de utilizadores - Desinstalações não orgânicas  -
Aquisição de utilizadores - Desinstalações orgânicas -
Aquisição de utilizadores Interações entre plataformas

Descrições dos relatórios de jornada do utilizador

Cliques e impressões

Relatório Características
Contexto Um utilizador interage com uma campanha e clica ou visualiza um anúncio.
Características Os relatórios incluem um registo do link de atribuição e dos cabeçalhos HTTP presentes quando um utilizador clica ou visualiza um anúncio.
Caso de uso
  • Otimize campanhas que não levam à abertura de uma aplicação (instalação, reatribuição, reengajamento).
  • Redirecione esses utilizadores utilizando diversas campanhas.
Exemplo de relatório Cliques
Observações

Dados de SRN não disponíveis.

Utilizadores restritos Em alguns casos, devido a regras de privacidade, os dados de impressões e cliques são restritos (não têm identificadores de utilizador) 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 utilizadores: Instalações

Redirecionamento: Conversões
Contexto

Quando um utilizador abre uma aplicação pela primeira vez.

Após um utilizador interagir com um anúncio de retargeting e depois abrir a aplicação. Uma conversão de retargeting pode ser um reengajamento ou uma reatribuição.

Consulte o Guia de Atribuição de Retargeting.
Casos de uso
  • Gere relatórios agregados utilizando campos não disponíveis nas ferramentas analíticas da AppsFlyer.
  • Combine-os com outros relatórios para realizar análises avançadas e transversais.
  • Analise o desempenho em diversas dimensões, como cidades, áreas metropolitanas, etc. 
  • Segmente utilizadores conforme o país, cidade e idioma para fins de direcionamento.
  • Obtenha IDs de dispositivos dos utilizadores para fins de redirecionamento.
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. Considere isso ao carregar dados nos 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 redirecionamento

Eventos na aplicação

Relatório Características

Contexto do relatório

Lista cronológica das ações realizadas pelos utilizadores após a atribuição (instalação, reafectação ou reengajamento).

Características

  • A estrutura e os campos do relatório são semelhantes aos dos relatórios de instalação.
  • Campos específicos descrevem o evento. Isto inclui o nome do evento, o valor, a receita e o tempo. 

Caso de uso

Use o relatório para:

  • Obtenha insights observando a jornada do utilizador ao longo do seu período de uso.

  • Combine os dados brutos de instalação e de eventos na aplicação para acompanhar a jornada completa do utilizador.

Valores dos eventos

Campo de valor do evento

O campo de valor do evento contém todos os dados relacionados ao evento em formato JSON. Pode carregar estes dados no seu sistema de BI para análise mais aprofundada.

Dica! Pode utilizar o Power Query no Microsoft Excel para analisar parâmetros de evento de cadeias de texto JSON.


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

Relatório de receitas

Os dados de receita e ROI na AppsFlyer provêm do af_revenue enviado em eventos. 

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

Nota! Utilize apenas o parâmetro af_revenue com eventos que descrevam a receita real gerada. Para outros eventos relacionados com receita, mas não definitivos, como add_to_cart, use parâmetros diferentes, como af_price.

Exemplo de relatório

Eventos na aplicação

Observações

  • Os eventos de retargeting na aplicação são registados duas vezes nos relatórios de dados brutos de UA e de eventos na aplicação de retargeting.
  • Os eventos na aplicação não incluem o evento de início (af_app_opened). Este está disponível no relatório de dados brutos de sessões.
  • Localização geográfica: É determinada utilizando o endereço IP do utilizador no momento em que o evento é realizado.

Sessões

Relatório Características
Contexto Quando o utilizador abre a aplicação, um evento de sessão é enviado para a AppsFlyer. O evento é registado se o limite de tempo mínimo entre sessões for ultrapassado. 
Características

A estrutura do relatório é a mesma dos relatórios de eventos na aplicação. As sessões (eventos de sessão) estão num relatório separado devido ao grande volume desses eventos.

Caso de uso Compreenda o envolvimento do utilizador com a aplicação.
Exemplo de relatório O relatório de sessões é semelhante ao relatório de eventos na aplicação. Nota: Nos dados originais, as sessões possuem o nome de evento lançamento

Desinstalações

Relatório Características
Contexto Registo de utilizadores que desinstalam a aplicação. 
Características
  • Este relatório é atualizado diariamente e não de forma contínua, como acontece com outros relatórios de jornada do utilizador. 
  • No relatório, o horário do evento representa a hora em que a AppsFlyer determina que a aplicação foi desinstalada, e não a desinstalação efetiva. Consulte Medição de desinstalação.
Campos disponíveis
  • Se o utilizador vier de uma fonte de media não orgânica, os campos de origem de media serão preenchidos. 
  • Considere que o evento de desinstalação é gerado pelos servidores da AppsFlyer após se determinar que o utilizador desinstalou. Consequentemente, muitos campos não são preenchidos. 
  • Os identificadores de utilizador disponíveis são os registados no momento da instalação. O CUID nunca está disponível. 
  • Os campos relacionados com a geolocalização são preenchidos com a localização do utilizador no momento do envolvimento com a fonte de media (clique ou impressão). Se a localização de envolvimento não estiver disponível, a localização associada ao evento de instalação será utilizada. 
Exemplo de relatório Desinstalações Atenção! No exemplo, para maior clareza, a linha 2 indica quais campos serão preenchidos caso hajam dados relevantes disponíveis. 
Casos de uso
  • Analise o evento de desinstalação, o dispositivo e as características do utilizador.
  • Crie uma audiência de eventos de desinstalação para retargeting.

Disponibilidade do relatório de jornada do utilizador por ferramenta

Relatório de envolvimento de anúncios por ferramenta 

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

Relatórios de aquisição de utilizadores por ferramenta 

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

Relatórios de dados brutos de retargeting por ferramenta

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

(1) Os dados de cliques e impressões são disponibilizados por fontes de media não SRNs. Os SRNs não disponibilizam estes dados.

FAQ

Detalhes

Porque faltam dados brutos de anúncios Meta?

Por definição, os dados brutos dos anúncios Meta são atribuídos à fonte de media restrita. Consulte dados de anúncios Meta ao nível do utilizador.

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

Os carimbos de data/hora são comuns a todos os relatórios. Isto permite combinar diferentes relatórios.

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

  • Hora de toque atribuído: O momento em que o utilizador interagiu com um anúncio.
  • Hora de instalação : O momento em que a aplicação é lançada pela primeira vez.
  • Hora do evento: O momento em que o evento ocorre.

Considere: 

  • Nos relatórios de instalação, as horas de instalação e de evento são idênticas.
  • Nos relatórios de eventos na aplicação, as horas de instalação e de evento são diferentes. A diferença pode mostrar o intervalo de tempo entre o lançamento da aplicação e o envolvimento do utilizador com a aplicação.

Qual é o propósito do campo contribuidor?

O campo contribuidor lista as fontes de media associadas. Por vezes referido como Instalações Assistidas. No Protect360, também é utilizado para correção de atribuições de instalações sequestradas.

O que é o campo de palavras-chave — porque pode não estar 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 ID de palavras-chave associados ao anúncio que levou à instalação. 

Dicas para relatório de instalações

Compreensão da jornada do utilizador

Uma jornada do utilizador é uma série de passos que este realiza antes de atingir um objetivo, como comprar um produto ou reservar um voo. A análise da jornada do utilizador visa entender o que o utilizador faz na app, quão ativo é e que valor aporta durante um certo período.

Pode identificar e salientar as jornadas dos utilizadores com o auxílio do ID AppsFlyer. O ID é gerado para cada instalação de aplicação por dispositivo. O ID mantém-se inalterado ao longo de todo o ciclo de vida do utilizador (da instalação à desinstalação). O ID persiste mesmo se o utilizador redefinir a ID do dispositivo.

Dado que os relatórios de instalação e eventos na aplicação partilham a mesma estrutura, eles podem ser unificados num só relatório. No relatório combinado, pode agrupar e filtrar por ID AppsFlyer e ID do utilizador do cliente (se disponível) para analisar as jornadas dos utilizadores.

 Exemplos

Utilizador envolvido – forte

  • Um utilizador instalou a aplicação a 20 de agosto às 09h31.
  • O relatório combinado mostra que efetuou compras a 20 de agosto às 10h31, a 22 de agosto às 15h22 e a 25 de agosto às 16h47.
  • Com isto, concluímos que o utilizador está realmente envolvido. Fez uma compra uma hora após o lançamento da aplicação e continuou a comprar nos dias seguintes à instalação.

Utilizador envolvido – fraco

  • Um utilizador instalou a aplicação a 30 de julho. O relatório combinado mostra que adicionou um artigo ao carrinho a 15 de agosto, mas não há eventos de compra subsequentes.
  • Pode assumir que o utilizador está hesitante em efetuar uma compra e optar por redirecioná-lo com o artigo que adicionou ao carrinho.

Analisando a jornada do utilizador para otimizar a campanha

  • O gestor de aquisição de utilizadores (UA) de uma aplicação de viagens descarrega os relatórios de instalação e de eventos na aplicação e combina-os.
  • De seguida, para visualizar as jornadas dos utilizadores na aplicação, filtra ou agrupa dados por ID AppsFlyer.
  • Notam que um determinado utilizador, identificado pelo seu ID AppsFlyer, descarregou a aplicação há 12 meses e reservou um voo alguns dias depois.
  • Subsequentemente, o utilizador visualizou algumas ofertas de voos, mas não efetuou nenhuma reserva. Analisando mais a fundo, o gestor de UA descobre mais utilizadores com o mesmo padrão e decide investigar ainda mais.
  • Descobrem que a maioria destes utilizadores veio do Anúncio A da Campanha B conduzida na Fonte de Media C. Acontece que este anúncio e campanha eram dirigidos a utilizadores que desejavam viajar para um determinado destino.
  • Ao analisar a jornada do utilizador, o gestor de UA pode concluir que a campanha estava muito focada e que os utilizadores não estavam suficientemente envolvidos com a aplicação.

Relatórios de funcionalidades

Relatórios sobre funcionalidades adicionais disponíveis na plataforma

Postbacks

Use relatórios de postback para rever cópias dos dados enviados para uma rede de anunciantes. Por exemplo, use-os para investigar discrepâncias. Esses relatórios são apenas para fins informativos e não são necessários para integração com redes de anúncios.

Relatórios de postback (disponíveis através da página Exportar Dados e Pull API)

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

Postbacks de conversão de retargeting

Retargeting (reengajamento e reatribuição)

Eventos in-app relacionados com retargeting 

Eventos in-app relacionados com retargeting

Campos adicionais nos relatórios de postback

Campo Observações
URL de postback

Alguns valores, como receita, podem não aparecer no campo apropriado, mas ainda assim pode ver esses dados no URL de postback.

Método de postback  
Código de resposta HTTP do postback 200: Confirma que o postback foi recebido pela rede de anunciantes
Mensagem de erro de postback   

Regras de fraude e validação do Protect360

  • Veja os relatórios de dados brutos do Protect360 e regras de validação
  • Redes de anúncios e agências precisam de permissão do anunciante para aceder aos relatórios do Protect360 e Regras de Validação

Para conceder permissão a um parceiro integrado para aceder ao Protect360:

  1. Aceda a Colaborar> Integrações Ativas
  2. Escolha o parceiro integrado.
  3. No separador Permissões, ative Acesso ao seu painel Protect360 e aos dados brutos através da API.
  4. Para permitir o acesso ao painel de eventos na app (CPA), ative Acesso a dados agregados dos eventos na aplicação.