[GA4] Sobre a importação de dados

Por que usar a importação de dados?

Cada sistema que você usa na sua empresa gera seus próprios dados. Seu CRM pode ter informações como classificações de lealdade do cliente, valores da vida útil e preferências de produtos. Se você for um editor da Web, pode ser que seu sistema de gerenciamento de conteúdo armazene dimensões, como autor e categoria do artigo. Se administra uma empresa de e-commerce, você armazena atributos dos itens, como preço, estilo e tamanho.

Além disso, você usa o Google Analytics para medir o tráfego e o desempenho dos seus sites e apps.

Normalmente, cada conjunto de dados existe em um silo próprio, sem acesso a outras informações. Com a importação de dados, você consegue reunir todos eles no Google Analytics em uma programação definida para remover esses silos, ter novos insights e democratizar seus dados.

Como funciona a importação de dados

Fazer upload de dados

Você faz o upload de arquivos CSV, que contêm dados externos, para uma propriedade do Google Analytics. Também é possível exportar esses arquivos CSV de uma ferramenta comercial off-line, como seu sistema de CRM ou de gerenciamento de conteúdo (CMS). Para volumes menores de dados, você consegue criar os arquivos manualmente em um editor de texto ou planilha.

A importação de dados agrega os dados off-line que você envia e os dados de eventos que o Google Analytics coleta. Os dados importados melhoram os relatórios, as comparações e os públicos-alvo. O resultado é uma visão mais completa das atividades on-line e off-line.

Como agregar dados

Os dados são agregados de duas maneiras diferentes, dependendo do tipo de informação importada:

• Tempo de coleta/processamento: os dados importados são agregados aos do Google Analytics à medida que são coletados e processados como se tivessem sido obtidos com o evento e, depois, gravados nas tabelas de agregação do Analytics. Os dados importados não são agregados aos dados históricos do Google Analytics, isto é, dados que já foram processados. Se você excluir o arquivo de dados importado, nenhuma outra agregação será feita, permanecendo apenas aqueles que já foram mesclados.
  
  Os dados do usuário e dos eventos off-line são agregados no tempo de coleta/processamento.
• Tempo de consulta/geração de relatórios: seus dados importados são agregados aos do Google Analytics quando você abre um relatório e o Analytics emite uma consulta para os dados desse relatório. Esse tipo de agregação é temporária: se você excluir o arquivo de dados importado, nenhuma outra mesclagem vai ser feita, e não vai ser mais possível acessar os dados agregados no Google Analytics.
  
  Os dados de custo e item são agregados no horário do relatório/consulta.
  
  Os dados de horário do relatório/consulta não ficam disponíveis quando você está criando públicos-alvo no Google Analytics ou segmentos nas Análises detalhadas.

Tipos de metadados que você pode importar

Metadados

A importação de metadados funciona como uma adição aos dados já coletados e processados por uma propriedade. Normalmente, os metadados são armazenados em uma dimensão ou métrica personalizada, mas, em alguns casos, convém substituir as informações padrão já coletadas, por exemplo, importando um catálogo de produtos com categorias atualizadas.

Os tipos de dados a seguir podem ser importados:

• Dados de custo: dados de cliques, custo e impressões da rede de anúncios de terceiros (não pertencentes ao Google)
• Dados do item: metadados do produto, como tamanho, cor, estilo ou outras dimensões relacionadas
• Dados do usuário: metadados do usuário, por exemplo, uma classificação de lealdade ou o valor da vida útil do cliente, que podem ser usados para criar segmentos e listas de remarketing.
• Eventos off-line: eventos off-line de origens sem conexão de Internet ou que não são compatíveis com a coleta de eventos em tempo real.

Limites

Armazenamento total	10 GB (propriedades padrão) 1 TB (propriedades do Analytics 360)
Tamanho da fonte de dados	1 GB
Uploads diários	120 uploads por propriedade a cada dia

Como importar dados

Ao importar dados, você cria uma fonte de dados. Uma fonte de dados é a combinação do arquivo CSV que você quer fazer upload e de um mapeamento dos campos do Google Analytics para os campos do CSV. Por exemplo:

 

Não faça upload de um arquivo com chaves duplicadas (por exemplo, dois campos chamados "user_id").

Saiba mais sobre as fontes de dados

Pré-requisitos para usar o SFTP ao fazer upload dos dados

Se você planeja usar a opção SFTP na Etapa 5, verifique se o servidor SFTP é compatível com os algoritmos de chave de host ssh-rsa e ssh-dss. Saiba mais sobre como verificar quais algoritmos de chave de host você usa e como formatar o URL do servidor SFTP.

Iniciar o processo de importação

1. No Google Analytics, clique em Administrador.
2. Verifique se você está na conta e na propriedade certas.

3. Na coluna Propriedade, clique em Importação de dados.
4. Crie uma fonte de dados ou selecione uma existente. Consulte as seções a seguir para saber como fazer isso.

Criar uma nova fonte de dados

1. Clique em Criar fonte de dados.
2. Insira um nome para sua fonte de dados.
3. Selecione o tipo de dados:
   • Dados de custo (somente importação de tempo de consulta)
   • Dados do item (importação de tempo de consulta/geração de relatórios)
   • Dados de usuários por User-ID (importação de tempo de processamento/coleção)
   • Dados de usuários por Client-ID (importação de tempo de processamento/coleção)
   • Dados de eventos off-line (importação de tempo de processamento/coleção)
4. Clique em Ler os termos se solicitado. Essa solicitação aparece quando você está importando dados do dispositivo ou do usuário.
5. Siga uma destas opções:
   • Escolha Upload manual de CSV, selecione o arquivo CSV no seu computador e clique em Abrir.
   Ou
   • Selecione SFTP.
   • Nome de usuário do servidor SFTP: insira seu nome de usuário do servidor SFTP.
   • URL do servidor SFTP: insira o URL do servidor SFTP.
   • Frequência: escolha a frequência de uploads (diária, semanal, mensal).
   • Horário de início: selecione a hora que você gostaria que o upload fosse iniciado.
   • Depois que a fonte de dados for criada, a chave pública do seu servidor SFTP fica visível na interface em que você está criando a fonte e disponível nos detalhes da fonte (confira abaixo).
6. Clique em Avançar e siga para a etapa de mapeamento.
7. Selecione os campos do Google Analytics e os campos importados que você quer mapear. Edite os nomes dos campos conforme necessário.
8. Clique em Importar.

Fazer upload de dados para uma fonte de dados

1. Na linha de uma fonte de dados atual, clique em Importar agora.
2. Se a fonte de dados estiver configurada para importação de CSV, selecione o arquivo CSV que você quer importar e clique em Abrir.
   
   O arquivo CSV precisa incluir os mesmos campos ou subconjunto de campos do original. Se você quiser importar campos diferentes para o mesmo tipo de dados, exclua a fonte de dados atual e crie uma nova.

Verificar os algoritmos de chave de host SFTP e formatar o URL do servidor SFTP

Verificar algoritmos

Existem métodos diferentes para verificar se o servidor SFTP usa o algoritmo de chave de host ssh-rsa ou ssh-dss. Por exemplo, utilize o cliente de login remoto do OpenSSH para verificar os registros do servidor com este comando:

ssh -vv <your sftp server name>

Se o servidor for compatível com algum desses algoritmos, uma linha como esta vai aparecer no registro do servidor:

debug2: host key algorithms: rsa-sha2-512, rsa-sha2-256, ssh-rsa

Formatar o URL do servidor SFTP

Se o URL do servidor SFTP estiver formatado incorretamente, a configuração da importação vai falhar com uma mensagem de erro interno.

Um URL do servidor SFTP geralmente tem três partes que devem ser consideradas para fazer o upload de arquivos de importação de dados. Exemplo:

sftp://example.com//home/jon/upload.csv é dividido da seguinte forma:

• Domínio: example.com
• Diretório principal: //home/jon
• Caminho do arquivo: /upload.csv

No exemplo acima, o arquivo de upload está no diretório principal.

É possível formatar a parte do domínio do URL de várias maneiras, usando o nome de domínio ou o endereço IPv4 ou IPv6 do servidor, com ou sem um número de porta:

• Nome de domínio: sftp://example.com
• IPv4 (com número de porta): sftp://142.250.189.4:1234
• IPv4 (sem número de porta): sftp://142.250.189.4
• IPv6 (com número de porta): sftp://[2607:f8b0:4007:817::2004]:1234
• IPv6 (sem número de porta): sftp://[2607:f8b0:4007:817::2004]

Se você não incluir o número da porta, a padrão será 22.

Você pode formatar corretamente o URL para incluir ou excluir o diretório principal. Os exemplos de URLs formatados corretamente a seguir usam formatos diferentes para identificar o domínio. Os exemplos incluem números de porta, mas você pode escolher não usar esse número.

• Incluir o diretório principal:
  • sftp://example.com//home/jon/upload.csv (nome de domínio)
  • sftp://142.250.189.4:1234//home/jon/upload.csv (IPv4 com número de porta)
• Excluir o diretório principal:
  • sftp://example.com/upload.csv (nome de domínio)
  • sftp://[2607:f8b0:4007:817::2004]:1234/upload.csv (IPv6 com número de porta)

Se o arquivo de upload estiver em um subdiretório do diretório principal, o URL vai ser semelhante a este:

sftp://example.com//home/jon/data/upload.csv

Nesse caso, é possível usar os seguintes tipos de formatos:

• Incluir o diretório principal:
  • sftp://example.com//home/jon/data/upload.csv
  • sftp://142.250.189.4:1234//home/jon/data/upload.csv (IPv4 com número de porta)
• Excluir o diretório principal:
  • sftp://example.com/data/upload.csv
  • sftp://[2607:f8b0:4007:817::2004]:1234/data/upload.csv (IPv6 com número de porta)

Caso seu arquivo de upload não esteja armazenado no diretório principal (//home/jon) nem em um subdiretório dele (//home/jon/data), mas sim no diretório /foo/bar, o URL formatado corretamente do seu arquivo de upload será semelhante a este:

sftp://example.com//foo/bar/upload.csv (//foo/bar substitui o diretório principal)

Conferir detalhes da fonte de dados, receber sua chave pública do SFTP, importar novos dados e excluir uma fonte

1. No Google Analytics, clique em Administrador.
2. Verifique se você está na conta e na propriedade certas.

3. Na coluna Propriedade, clique em Importação de dados.
4. Na linha da fonte de dados, clique em .

Você pode ter acesso ao nome, tipo de dados, chave pública e histórico de cada upload.

• Chave pública: a chave pública do servidor SFTP que corresponde a uma chave privada armazenada pelo Google Analytics (e nunca compartilhada) para garantir uma conexão segura e particular entre seu servidor e os servidores de importação de dados do Analytics. É fundamental que você autorize essa chave pública no seu servidor para garantir que a importação de dados funcione com segurança.
• % de linhas importadas: o número de linhas importadas dividido pelo número de linhas no arquivo de importação. O valor de 100% indica que todas as linhas foram importadas.
• Taxa de correspondência: a proporção de chaves no arquivo de importação que podem ser encontradas na sua propriedade nos últimos 90 dias. O valor de 100% indica que as informações são totalmente úteis e relevantes para os dados dos últimos 90 dias.

Para importar dados novos, faça o seguinte:

Clique em Importar agora e escolha o arquivo CSV no seu computador.

Para excluir a fonte de dados, siga estas etapas:

1. Clique em > Excluir fonte de dados.
2. Leia a notificação de exclusão e clique em Excluir fonte de dados.

Você pode excluir os dados de tempo de processamento/coleta. No entanto, se quiser remover os dados enviados anteriormente de todos os eventos processados pelo Google Analytics, será necessário também excluir o usuário ou a propriedade. Para saber mais, clique aqui. Quando um arquivo já importado é excluído, isso não remove os dados processados que foram associados aos eventos coletados desde que a importação foi concluída.

 

Nomes e prefixos reservados

Os seguintes nomes e parâmetros de eventos, propriedades do usuário e prefixos são reservados para uso do Google Analytics. Se você tentar fazer o upload de dados que tenham qualquer um dos nomes ou prefixos reservados, eles não serão enviados.

Por exemplo:

• Se você tentar importar um evento com um nome reservado, nem ele nem os parâmetros dele serão importados.
• Se você tentar importar um evento com um nome válido, mas que inclui um parâmetro com um nome reservado, o evento vai ser importado, mas o parâmetro com o nome reservado não.

Nomes de eventos reservados

• ad_activeview
• ad_activeview
• ad_exposure
• ad_impression
• ad_query
• adunit_exposure
• app_clear_data
• app_install
• app_remove
• app_update
• error
• first_open
• first_visit
• in_app_purchase
• notification_dismiss
• notification_foreground
• notification_open
• notification_receive
• os_update
• screen_view
• session_start
• user_engagement

Nomes de parâmetros de eventos reservados

• firebase_conversion

Nomes de propriedades do usuário reservados

• first_open_after_install
• first_open_time
• first_visit_time
• last_deep_link_referrer
• user_id

Prefixos reservados (aplicável a parâmetros de evento e propriedades do usuário)

• ga_
• google_
• firebase_