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 |
|
Único | Atualizado continuamente | x |
Específico da aplicação |
Específico da aplicação |
API Pull* |
|
Único | Atualizado continuamente | ✓ |
|
|
Data Locker P |
|
Múltiplos | Atualizado continuamente com um atraso de várias horas | ✓ | UTC | USD |
API Push P |
|
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) |
|
N/A | Tempo real <5 segundos | ✓ | UTC | N/A |
Notas e abreviaturas: |
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) |
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
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.
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 |
|
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 |
|
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 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 |
|
Caso de uso |
Use o relatório para:
|
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.
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 |
|
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 |
|
Campos disponíveis |
|
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 |
|
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:
Considere:
|
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.
- O relatório contém:
- Cópias de postbacks enviadas para a fonte de mídia atribuída.
- Campos de dados brutos e campos adicionais conforme detalhado nesta secção.
- O relatório não contém:
- Instalações SRN.
- Eventos in-app relacionados com anúncios Meta, X Ads e Apple Search Ads.
- Postbacks de parceiros não atribuídos. Consulte eventos atribuídos a qualquer parceiro ou orgânico.
- Utilizadores orgânicos. Consulte sobre instalações orgânicas.
- Campanhas de instalação CPA com postbacks de instalação desativados.
- Desde março de 2021, os campos são preenchidos de acordo com as configurações de Privacidade Avançada da rede. Significa que, se a Privacidade Avançada estiver ativada, alguns campos, como identificadores de utilizador, não serão incluídos. Consulte especificação de postback de privacidade avançada para redes de anúncios.
- URIs para relatórios de postback via Pull API
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:
- Aceda a Colaborar> Integrações Ativas.
- Escolha o parceiro integrado.
- No separador Permissões, ative Acesso ao seu painel Protect360 e aos dados brutos através da API.
- Para permitir o acesso ao painel de eventos na app (CPA), ative Acesso a dados agregados dos eventos na aplicação.