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 |
|
|
|
|
|
|
Campos do relatório de dados brutos
Visitas ao site e eventos do site
Relatórios de amostra
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 |
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 | |
Touchpoint | web_media_channel | |
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:
|
04/10/2020 | Web-to-app |
Campos adicionados:
|
04/10/2020 | Caminhos de conversão |
Campos adicionados:
|
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.
Para ativar os relatórios do PBA, um administrador de conta deve configurar o Data Locker:
- Vá para Integração > Data Locker.
- Selecione todos os relatórios na seção People-Based Attribution.
- 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:
- Abrir Cyberduck
A lista de tipos de dados disponíveis é exibida.
-
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. - Clique com o botão direito em uma determinada data.
- Selecione Fazer download para um local específico e preencha o local.
O download dos arquivos é realizado. - 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:
- Usando a linha de comando/maс terminal, vá para o diretório que contém os dados.
- 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
- Abra o arquivo usando o Excel ou qualquer outra ferramenta