[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 junção é temporária: se você excluir o arquivo de dados importado, nenhuma outra junção será feita, e os dados agregados não poderão mais ser acessados no Google Analytics.
  
  Os dados de custo, itens e eventos personalizados são unidos no momento 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.

Quando você importa informações, os dados importados anteriormente são mantidos enquanto os novos são anexados. Se os dados novos tiverem as mesmas chaves daqueles importados no passado, eles serão substituídos.

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 taxa 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.
• Dados de eventos personalizados: importações de metadados de eventos usando campos padrão e/ou dimensões personalizadas.

Limites

Tamanho da fonte de dados	1 GB
Uploads diários	120 uploads por propriedade a cada dia

 

Importar tipo de dados	Limite de fontes de dados por propriedade	Limite de armazenamento por tipo de dados
Dados de custo	Até 5	1 GB em todas as fontes de importação
Dados de itens	Até 5	1 GB em todas as fontes de importação
Dados do usuário	Até 10	Não relevante
Eventos off-line	Até 10	Não relevante
Dados de eventos personalizados	Até 5	1 GB em todas as fontes de importação

Você pode encontrar o uso atual da cota no produto pelo botão "Informações de cota".

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. Exemplo:

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

Consulte este artigo se quiser saber 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. Em  Administrador, em Coleta e modificação de dados, clique em Importação de dados
   O link anterior abre a última propriedade do Google Analytics que você acessou. É possível mudar a propriedade com o seletor. Você precisa ter função de editor ou superior no nível da propriedade para iniciar o processo de importação.
2. Crie uma fonte de dados ou selecione uma existente. (consulte as seções a seguir).

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 ID do usuário (importação de tempo de coleta/processamento)
   • Dados de usuários por ID do cliente (importação de tempo de coleta/processamento)
   • Dados de eventos off-line (importação de tempo de coleta/processamento)
   • Dados de eventos personalizados (importação de tempo de consulta/geração de relatórios)
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 é 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, precisará excluir a fonte de dados atual e criar uma nova.

A importação de dados feita na propriedade de origem é exportada automaticamente para as subpropriedades e a propriedade de visualização completa.

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 é dividida 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 do 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. Eles incluem números de porta, mas não é obrigatório usá-los.

• Incluir o diretório principal:
  • sftp://example.com//home/jon/upload.csv (nome do 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 do 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 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 (sftp://example.com//foo/bar/upload.csv 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. Em  Administrador, em Coleta e modificação de dados, clique em Importação de dados
   O link anterior abre a última propriedade do Google Analytics que você acessou. É possível mudar a propriedade com o seletor.

   Você precisa ter função de leitor ou superiorno nível da propriedade para conferir os detalhes da fonte de dados.

2. 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.
  Observação: % importado e taxa de correspondência são relevantes para a importação de dados de custo, itens e eventos personalizados, mas não são aplicáveis à importação de dados de usuários ou eventos off-line.

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. 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. Leia este artigo para saber mais sobre os pedidos de exclusão de dados.

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.

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_