Relatórios de dados brutos do PBA

Visão geral: os relatórios de dados brutos do PBA estão disponíveis via Data Locker.

Relatórios de dados brutos do PBA

Use os relatórios de dados brutos do PBA para analisar as jornadas e ações do usuário.

Descrições do relatório

Tópicos do relatório de dados brutos do PBA

Tópico do relatório de dados brutos Descrição
Visitas ao site
  • Visitas ao site.
  • Mensure a exposição e o engajamento do usuário com campanhas de tráfego da web.

Eventos do site

  • Contêm as ações realizadas pelos visitantes do site, como inscrição ou compra.
  • Os eventos são atribuídos à última visita não direta à web ocorrida nos últimos 30 dias.
  • Os parâmetros de atribuição associados ao evento podem incluir fonte de mídia, canal de mídia, campanha e assim por diante. 
  • Use esses parâmetros para otimizar seus esforços de marketing.
  • Analise o comportamento do usuário por fonte de mídia.
  • Os valores desses campos são determinados por meio da visita atribuída usando as regras de atribuição de fonte de mídia do PBA.
  • A intenção é associar eventos a uma visita específica ao site e não a uma visualização de página específica.
  • Use este tópico para descobrir quais fontes e campanhas impulsionam os usuários e quais ações os usuários realizam.

Instalações assistidas pelo site

  • Os relatórios de instalações auxiliadas pelo site contêm as visitas ao site que levam o usuário a instalar o aplicativo.
  • Verifique a posição da fonte de mídia da web na jornada de instalação: último ou auxiliar (ou seja, que não é o último)
  • Examine a combinação de fontes de mídia da web com o maior potencial para impulsionar instalações.
  • Por exemplo,
    • A fonte de mídia da web A e a fonte de mídia mobile B geralmente aparecem na jornada do usuário.
    • Suposição: essa combinação tem o potencial de conduzir instalações.

Caminhos de conversão

  • Contém os touchpoints encontrados no caminho para a conversão, sendo que cada touchpoint possui o seu próprio registro.
  • As conversões são identificadas por um ID de conversão exclusivo. Use isso para identificar touchpoints relacionados à mesma conversão.
  • No dashboard, touchpoints idênticos consecutivos são agregados em etapas. Em dados brutos, cada touchpoint tem um registro. Isso fornece a máxima granularidade.

Campos do relatório de dados brutos

Visitas ao site e eventos do site

Relatórios de amostra

  • Eventos no site: CSV
  • Visitas ao site: CSV

Os campos de dados brutos são preenchidos em parte a partir de dados originados no link de atribuição do usuário do aplicativo mobile e no evento de instalação do aplicativo. 

Faça o download da lista de campos como um arquivo CSV

Visitas ao site da lista de campos e relatório de eventos do site:

Nome do campo Descrição Formato Exemplo
advertising_id ID de publicidade (GAID) Sequência de caracteres 7fzzz3fa-8bad-46c9-bb03-fffffffffffffffffffffffff
af_web_id ID de cookie enviado do SDK da web Sequência de caracteres 68972980-58f9-4ca6-8743-c0d633364b6d
amazon_aid ID de publicidade da Amazon Fire TV Sequência de caracteres df07c7dc-cea7-4a89-b328-810ff5acb15d
android_id ID do dispositivo Android Sequência de caracteres 68999980-58f9-4ca6-8743-c0d633364b6d
app_id O ID do aplicativo mais recente instalado Sequência de caracteres id123456789
app_name O nome do aplicativo mais recente Sequência de caracteres Meu aplicativo
app_version A versão mais recente do aplicativo Sequência de caracteres 6.32
appsflyer_id ID da AppsFlyer (instalação) Sequência de caracteres 1594825729709-5655157112349378588
attributed_touch_time Em visitas na web, o carimbo de data/hora da visita na web Em eventos da web, o carimbo de data/hora da visita atribuída na web aaaa-mm-dd hh:mm:ss 9/17/2020 0:09:25
attributed_touch_type Tipo do touchpoint. Atualmente, sempre definido para visita ao site. Sequência de caracteres Visita web
bundle_id ID do bundle PBA Sequência de caracteres 048db9bf-97r7-4m2f-919b-607b7kk806d0
campanha Atribuído à visita ao site Sequência de caracteres Campanha de verão
campaign_id Atribuído à visita ao site Sequência de caracteres 12343425
city Resolvido usando o endereço IP Sequência de caracteres Spring Valley
country_code Resolvido usando o endereço IP Sequência de caracteres EUA
customer_user_id Identificador de Usuário do Cliente (CUID) Sequência de caracteres 5a8771ecbb986ABC
device_type O tipo de dispositivo Sequência de caracteres Desktop
dma Resolvido usando o endereço IP Sequência de caracteres 501
event_name No relatório de visita ao site: sempre visita ao site. No relatório de eventos do site: eventName enviado pelo SDK da web.  Sequência de caracteres compra
event_revenue Valor da receita do evento na moeda de compra Sequência de caracteres 199,99
event_revenue_currency código de moeda de 3 dígitos do event_revenue Sequência de caracteres USD, ZAR, EUR
event_revenue_usd event_revenue convertido para USD Sequência de caracteres 57,46
event_source SDK web ou servidor para servidor Sequência de caracteres SDK web, S2S
event_time Visitas ao site: hora da visita Evento no site: hora do evento aaaa-mm-dd hh:mm:ss 9/17/2020 0:09:25
event_type O seguinte: evento padrão, evento de conversão, visita ao site Sequência de caracteres evento de conversão
event_url URL da página da web na qual o evento ocorreu (é igual à URL original nas visitas ao site) Sequência de caracteres http://www.brandpit.com/checkout
event_value Eventos no site: detalhes do valor do evento contidos em um JSON. Visitas ao site: sempre nulo JSON {"sku": "ABC123", “color": "blue", "unit_price":3.99,"currency": "USD"}
idfa Identificador do anúncio Sequência de caracteres A56B9887-FEBA-458C-BEFC-C891F9DF7681
idfv Identificador do anúncio Sequência de caracteres EBC2F523-B1E5-4484-A4C8-ADC32DC7C23D
imei Identificador do dispositivo Sequência de caracteres 3532211234
install_time O horário de instalação mais recente do aplicativo aaaa-mm-dd hh:mm:ss 9/17/2020 0:09:25
ip Endereço IP do visitante Sequência de caracteres 24.7.104.115
language Relatado pelo agente do usuário Sequência de caracteres English
media_channel Atribuído à visita ao site Sequência de caracteres Anúncio
media_source Atribuído à visita ao site Sequência de caracteres googleadwords_int
media_type Atribuído à visita ao site Sequência de caracteres Paga
OAID Identificador do anúncio Sequência de caracteres df07c7dc-cea7-4a89-b328-810ff5acb15d
original_url Endereço URL redirecionando o usuário para o site na visita atribuída ao site Sequência de caracteres https://www.brandpitt.com/signin?utm_source=Googleg&utm_term=shoes&utm_campaign=cool&c=summer&af_siteid=publisher&af_sub1=helloworld
platform A plataforma Sequência de caracteres macOS
postal_code Resolvido usando o endereço IP Sequência de caracteres 10977
query_params Parâmetros de consulta na URL de redirecionamento (após o '?') Exwmplo: https://www.brandpitt.com/signin?utm_source=Google&utm_term=shoes&utm_campaign=cool&c=summer&af_siteid=publisher&af_sub1=helloworld&af_keyword=shoes Se a URL não tiver parâmetros de consulta, o valor será nulo JSON {"c":"summer",af_siteid":"publisher",af_sub1":helloworld",af_keywords":"shoes","utm_source":"Google","utm_campaign":"cool","utm_term":"shoes"}
referrer Referenciador do documento HTTP da visita atribuída ao site Sequência de caracteres https://www.google.com/
Região Resolvido usando o endereço IP Sequência de caracteres NA
Estado Resolvido usando o endereço IP Sequência de caracteres NY

Instalações auxiliadas pelo site 

A estrutura de registro do relatório é a seguinte:

  • Os campos de registro são agrupados da seguinte forma:
    • Evento: o evento de conversão de instalação.
    • Touchpoint: touchpoints encontrados antes da conversão da instalação.
    • Uma conversão de instalação consiste em um ou mais touchpoints. Cada touchpoint tem um registro em dados brutos. O install_id agrupa os touchpoints de uma instalação.

Exemplo de relatório web-to-app:

Instalações auxiliadas pelo site

Grupo de campos Nome do campo Descrição
Evento bundle_name Nome do bundle de marca configurado na página Bundle de marca
Evento bundle_id ID do agrupamento da marca
Evento app_id

App ID

Evento install_id ID de instalação exclusiva que agrupa os touchpoints da jornada do usuário. Calculado como bundle_id+appsflyer_id+install_time
Evento appsflyer_id ID da AppsFlyer atribuído a um dispositivo mobile quando um usuário instala um aplicativo
Evento install_time Hora da instalação 
Evento install_name

instalar, reinstalar (ou seja, um usuário que instalou o aplicativo, o excluiu e o instalou novamente) independentemente da causa da reinstalação.

Evento install_type

Tipo de instalação: organic_install, custom_link_install, smart_banner_install, non-organic_install

Evento final_data

Verdadeiro ou Falso: se verdadeiro, a linha é final.

Exemplo:

A instalação ocorreu no dia 1 de janeiro. 

Nos próximos 7 dias, as linhas de relatório associadas a essa instalação contêm o valor false na coluna final_data

Em 8 de janeiro, a conversão é finalizada e o valor muda para verdadeiro. Os relatórios a partir de 9 de janeiro não contêm mais a instalação. 

Evento mobile_media_source A fonte de mídia mobile que recebeu o último engajamento, antes da instalação
Evento mobile_campaign A última campanha na qual houve engajamento, antes da instalação
Evento mobile_campaign_id

O ID da campanha foi acionado por último, antes da instalação

Evento mobile_device_category

Tipo de dispositivo usado: telefone, tablet

Touchpoint touchpoint_contirubtion
  •  Por último (última ou única fonte de mídia da web antes da instalação)
  • Assistência (não é o último touchpoint antes da instalação)

Esse campo substitui path_touch_type que agora está desativado.

Evento mobile_platform

Sistema operacional do dispositivo: Android, iOS

Evento mobile_country País de instalação de acordo com o endereço IP do dispositivo
Touchpoint web_timestamp

Hora em que o touchpoint da web ocorreu

Touchpoint web_media_source Touchpoint da fonte de mídia da web
Touchpoint web_campaign Touchpoint da campanha na web
Touchpoint web_campaign_id Touchpoint com o ID da campanha
Touchpoint web_media_type

Tipo de fonte de mídia

Touchpoint web_media_channel

Canais de mídia

Touchpoint web_device_category

Valor para este touchpoint: desktop, outro, smartphone, tv, tablet

Touchpoint web_platform

O sistema operacional do dispositivo usado para o touchpoint: Android, iOS, Windows, macOS, Chrome-OS, Linux

Touchpoint web_country País do touchpoint
Touchpoint web_pid Valor UTM para visitas ao site
Touchpoint web_utm_source

Valor UTM para visitas ao site

Touchpoint web_utm_medium

Valor UTM para visitas ao site

Touchpoint web_utm_campaign

Valor UTM para visitas ao site

Touchpoint web_utm_content

Valor UTM para visitas ao site

Touchpoint web_utm_term

Parâmetro de termo UTM (palavras-chave) em um touchpoint

Touchpoint web_referrer

O referenciador HTTP da visita da web à qual a instalação foi atribuída.

Touchpoint web_googleads_campaign_id

ID da campanha fornecido pela integração do Google Ads (disponível a partir de 6 de agosto de 2020)

Touchpoint web_googleads_campaign_name

Nome da campanha fornecido pela integração do Google Ads (disponível a partir de 6 de agosto de 2020)

Touchpoint web_utm_id

Valor UTM para visitas ao site

Evento customer_user_id ID de usuário do cliente conforme definido pelo SDK da web
Touchpoint idfa

O ID do dispositivo que instala o aplicativo

Touchpoint idfv O ID do dispositivo que instala o aplicativo
Touchpoint android_id O ID do dispositivo que instala o aplicativo
Touchpoint advertising_id O ID do dispositivo que instala o aplicativo
Touchpoint amazon_fire_id O ID do dispositivo que instala o aplicativo
Touchpoint imei O ID do dispositivo que instala o aplicativo

Caminhos de conversão

Estrutura de registro de relatório

  • Campos agrupados da seguinte forma:
    • Evento: o evento de conversão e as informações associadas.
    • Touchpoint: detalhes de um touchpoint no caminho para a conversão.
  • Uma conversão consiste em um ou mais touchpoints. No arquivo, cada touchpoint é representado por um registro. 

Exemplo de relatório de caminhos de conversão
Conversion_paths_example_oct20.csv

Campos de caminhos de conversão

Grupo de campos Nome do campo Descrição
Evento conversion_id ID de conversão exclusivo que agrupa os touchpoints de uma conversão. Calculado como bundle_id+appsflyer_id+conversion_time
Evento bundle_name
Nome do bundle de marca definido na página do bundle de marca
Evento bundle_id ID do agrupamento da marca
Evento final_data

Verdadeiro ou Falso: se verdadeiro, a linha é final.

Exemplo:

A conversão ocorre em 1º de janeiro. 

Nos próximos 7 dias, as linhas de relatório associadas a essa conversão contêm o valor false na coluna final_data

Em 8 de janeiro, a conversão é finalizada e o valor muda para true. Os relatórios a partir de 9 de janeiro não contêm mais a conversão.

Evento conversion_type mobile_conversion, web_converson, install
Evento app_id App ID
Evento appsflyer_id
ID atribuída a um dispositivo mobile quando um usuário instala um aplicativo
Evento conversion_time -
Evento conversion_name Enviado pelo Web SDK ou Web S2S, ou o nome do evento in-app enviado pelo dispositivo mobile/S2S mobile.
Evento conversion_media_source Fonte de mídia atribuída
Evento conversion_campaign Campanha atribuída
Evento conversion_campaign_id
ID da campanha atribuída
Evento conversion_media_type
Tipo de mídia atribuída: paga, própria, earned
Evento conversion_media_channel
Canal de mídia atribuído: busca direta e orgânica, mídia social, e-mail, anúncio, referência
Evento conversion_device_category Categoria do dispositivo: telefone, tablet, desktop
Evento conversion_platform Plataforma, por exemplo, MacOS, Windows
Evento conversion_country Localização do usuário
Evento conversion_url
Conversões da web: a página na qual a conversão ocorreu.
Mobile: nulo
Touchpoint touchpoint_time -
Touchpoint touchpoint_type Visita na web, clique em dispositivos mobile, impressão mobile
Touchpoint touchpoint_media_source -
Touchpoint touchpoint_campaign -
Touchpoint touchpoint_campaign_id -
Touchpoint touchpoint_media_type Pago, próprio, ganho (earned)
Touchpoint touchpoint_media_channel
Pesquisa direta e orgânica, mídia social, e-mail, anúncio, referência
Touchpoint touchpoint_device_category Telefone, tablet
Touchpoint touchpoint_platform Android, iOS
Touchpoint touchpoint_country Código do país
Touchpoint touchpoint_utm_source Valores UTM para visitas ao site
Touchpoint touchpoint_utm_medium Valores UTM para visitas ao site
Touchpoint touchpoint_utm_campaign Valores UTM para visitas ao site
Touchpoint touchpoint_utm_content Valores UTM para visitas ao site
Touchpoint touchpoint_utm_term Valores UTM para visitas ao site
Touchpoint touchpoint_utm_id Valores UTM para visitas ao site
Touchpoint touchpoint_referrer URL que envia o usuário do site para esse touchpoint. No caso de um touchpoint mobile, o valor será nulo.
Touchpoint web_googleads_campaign_id

ID da campanha fornecido pela integração do Google Ads. (Disponível a partir de 6 de agosto de 2020)

Touchpoint web_googleads_campaign_name

Nome da campanha fornecido pela integração do Google Ads. (Disponível a partir de 6 de agosto de 2020)

Evento customer_user_id ID de usuário do cliente enviado com o evento
Evento idfa ID do dispositivo usado durante a conversão
Evento idfv ID do dispositivo usado durante a conversão
Evento android_id ID do dispositivo usado durante a conversão
Evento advertising_id ID do dispositivo usado durante a conversão
Evento amazon_fire_id ID do dispositivo usado durante a conversão
Evento imei ID do dispositivo usado durante a conversão

Notas de versão

Data Relatório Mudança
17/01/2020 Instalações auxiliadas pelo site

O nome do relatório no Data Locker foi alterado.

18/11/2020

Eventos do site

Visitas ao site

Os nomes e a estrutura do relatório são alterados:

  • Touchpoints da web substituídos por Visitas ao site
  • Eventos da web substituídos por Eventos ao site
04/10/2020 Web-to-app

Campos adicionados:

  • mobile_campaign_id
  • web_campaign_id
04/10/2020 Caminhos de conversão

Campos adicionados: 

  • conversion_campaign_id
  • touchpoing_campaign_id

Procedimentos

Configurando relatórios de PBA no Data Locker

  • Os relatórios de PBA são registrados diariamente no Data Locker na pasta h=23 para eventos que ocorrem em um determinado dia.
  • Os dados não podem ser gravados retroativamente.

AppsFlyerAdmin_us-en.png Para ativar os relatórios do PBA, um administrador de conta deve configurar o Data Locker:

  1. Vá para Integração > Data Locker.
  2. Selecione todos os relatórios na seção People-Based Attribution. 
  3. Clique em Salvar configuração.

Para fazer download de relatórios, consulte Acessando relatórios do Data Locker.

Os relatórios de dados brutos PBA do Data Locker são disponibilizados na pasta h=23. 

Example: t=website_events/dt=2020-11-26/h=23

Combinando os dados de PBA e dados mobile

Os dados refletem os usuários com maior probabilidade de interagir com o aplicativo mobile e o site.

Combine dados de aplicativos mobile e de sites.

Solução

  • Combinar relatórios usando o ID de usuário do cliente (CUID)
    • Use o mesmo CUID para mobile e web e combine relatórios usando o CUID como chave. 
    • Depois combine relatórios usando o campo CUID
  • Identificação do usuário da plataforma cruzada do PBA:
    • O PBA pode determinar que um usuário da web e um usuário mobile são a mesma pessoa.
    • Nesse caso, os relatórios da web com o PBA incluem um ID de anúncios mobile: ID de anúncios do Android, IDFA do iOS, OAID ou ID de anúncios da Amazon.
    • Em seguida, combine relatórios mobile e da web com base no ID de anúncios mobile.

Casos de uso para PBA e dispositivos mobile

Combine dados mobile e da web para ver a atividade do usuário em várias plataformas e dispositivos. Os dados combinados permitem que você: 

  • Acompanhe a jornada do usuário pelas propriedades digitais da sua marca
  • Analise o comportamento do usuário em cada plataforma
  • Considere qual plataforma recebe engajamento do usuário
  • Veja qual plataforma produz mais conversões
  • Mensure os seus esforços para enviar os seus usuários da web para o mobile

Nota do aplicativo - fazendo o download e combinando arquivos do Data Locker

Os dados brutos do PBA estão disponíveis no Data Locker. Para um determinado relatório, os dados estão contidos na pasta h=23 do tipo de relatório e consistem em vários arquivos compactados. 

Use este procedimento para:

  • Copiar os arquivos do Data Locker usando o Cyber-Duck ou qualquer outra ferramenta para copiar arquivos do S3. 
  • Combinar os arquivos em um único arquivo CSV usando Q. 

Copiando dados do PBA do Data Locker

 Antes de começar:

Para copiar dados usando o Cyber Duck:

  1. Abrir Cyberduck
    A lista de tipos de dados disponíveis é exibida.

    Duck_us-en.jpg

  2. Clique duas vezes em um tipo de relatório PBA e escolha entre web_events, web_to_app ou web_touch_points.
    A lista de datas de relatório disponíveis é exibida.
  3. Clique com o botão direito em uma determinada data.
  4. Selecione Fazer download para um local específico e preencha o local. 
    O download dos arquivos é realizado. 
  5. Repita as etapas acima para copiar dados de outros tipos de relatórios. Cada tipo de relatório e data devem ser armazenados em um diretório diferente no seu computador. 

Criando um arquivo CSV combinado: 

Antes de começar:

Instale o Q no seu computador.

Para combinar os dados em um arquivo CSV usando Q:

  1. Usando a linha de comando/maс terminal, vá para o diretório que contém os dados.
  2. Use o comando a seguir para combinar os arquivos compactados em um único arquivo com o nome pbadata.csv.
    Observação: o símbolo ~ representa o caminho/pasta inicial onde o comando Q está localizado em seu computador. Talvez seja necessário incluir o caminho completo para invocar o comando. 
    ~q "SELECT * from part*.gz" -d , -H -z -O >pbadata.csv
  3. Abra o arquivo usando o Excel ou qualquer outra ferramenta