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 |
|
Único | Atualizado continuamente | x |
Específico do aplicativo |
Específico do aplicativo |
Pull API* |
|
Único | Atualizado continuamente | ✓ |
|
|
Data Locker P |
|
Múltiplos | Atualizado continuamente com um atraso de várias horas | ✓ | UTC | USD |
Push API P |
|
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) |
|
N/A | Tempo real <5 segundos | ✓ | UTC | N/A |
Notas e abreviaturas: |
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) |
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
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.
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 |
|
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 |
|
Semelhante às instalações. |
Orgânico vs. não orgânico |
|
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 |
|
Caso de uso |
Use o relatório para:
|
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.
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 |
|
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 |
|
Campos disponíveis |
|
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 |
|
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:
Considere:
|
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.
- O relatório contém:
- Cópias de postbacks enviados para a fonte de mídia atribuída.
- Campos de dados brutos e campos adicionais, conforme detalhado nesta seção.
- O relatório não contém:
- Instalações de SRNs.
- Eventos in-app relacionados com Meta Ads, X Ads e Apple Search Ads.
- Postbacks de parceiros não atribuídos. Veja eventos atribuídos a qualquer parceiro ou atribuídos como orgânicos.
- Usuários orgânicos. Saiba mais sobre instalações orgânicas.
- Campanhas de instalação de CPA com postbacks de instalação desativados.
- Desde março de 2021, os campos são preenchidos de acordo com a configuração de Privacidade Avançada de uma ad network. Ou seja, se a Privacidade Avançada estiver ativada, alguns campos, como identificadores de usuário, não serão inclusos. Consulte especificação de postbacks de Privacidade Avançada para ad networks.
- URIs para relatórios de postback via Pull API
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:
- Vá para colaborar > integrações ativas.
- Escolha o parceiro integrado.
- Na aba Permissões, ative Acessar seu dashboard do Protect360 e dados brutos via API.
- Para dar acesso ao dashboard de eventos in-app (CPA), também ative Acessar dados de eventos in-app agregados.