Data Import no GA4: Como Importar Dados Externos Para o Google Analytics

O Google Analytics 4 coleta dados de tráfego e comportamento dos usuários no seu site ou app. Mas e os dados que ficam em outros sistemas, seu CRM, plataformas de anúncios que não são do Google, sistema de gestão de conteúdo?

Esses dados normalmente ficam isolados em silos separados. A funcionalidade de Data Import (Importação de Dados) do GA4 resolve esse problema: permite que você una dados externos com os dados coletados pelo Analytics.

Por Que Usar Data Import?

Cada sistema que você usa no seu negócio gera seus próprios dados. Seu CRM pode conter informações como classificação de fidelidade do cliente, lifetime value, preferências de produtos. Se você é publisher, seu CMS armazena dimensões como autor e categoria do artigo. Se você tem e-commerce, você guarda atributos dos produtos como preço, estilo e tamanho.

E você usa o Analytics para medir tráfego e performance dos seus sites e apps.

Normalmente cada conjunto de dados existe no seu próprio silo, sem se comunicar com os outros. Data Import permite que você una todos esses dados no Analytics, seguindo uma programação definida. O resultado é uma visão mais completa da atividade online e offline.

Como Funciona o Data Import do GA4?

Upload de Dados

Você conecta uma fonte de importação ou faz upload de arquivos CSV contendo dados externos para uma propriedade do Analytics. Você pode exportar esses arquivos CSV de ferramentas de negócio offline como seu CRM ou CMS, ou para quantidades menores de dados, pode criar os arquivos manualmente em um editor de texto ou planilha.

O Data Import une os dados offline que você fez upload com os dados de eventos que o Analytics coleta. Os dados importados enriquecem seus relatórios, comparações e públicos. O resultado é uma visão mais completa da atividade online e offline.

União de Dados (Data Join)

Os dados são unidos de 2 formas diferentes, dependendo do tipo de dado importado:

Collection/Processing time (Momento da coleta/processamento): Seus dados importados são unidos com os dados do Analytics no momento em que os dados do Analytics são coletados e processados, como se tivessem sido coletados junto com o evento. Os dados unidos são escritos nas tabelas agregadas do Analytics. Os dados importados não são unidos com dados históricos do Analytics (dados que já foram processados). Se você deletar o arquivo de dados importados, nenhuma nova união acontece, mas as uniões que já aconteceram permanecem.

Reporting/Query time (Momento do relatório/consulta): Seus dados importados são unidos com os dados do Analytics quando você abre um relatório e o Analytics executa uma consulta para buscar os dados do relatório. Esse tipo de união é temporária: se você deletar o arquivo de dados importados, nenhuma nova união acontece e os dados unidos não estarão mais acessíveis no Analytics.

Os dados de Reporting/Query time não estão disponíveis quando você está criando públicos no Analytics ou criando segmentos nas Explorações.

Quando você importa dados, os dados previamente importados persistem enquanto novos dados importados são adicionados. Note que se os dados importados têm o mesmo conjunto de chaves dos dados previamente importados, os dados serão sobrescritos.

Observação importante: Dados de processamento importados como dados de usuário e dados de evento são unidos no momento da coleta/processamento e serão exportados para o BigQuery. Dados de query time como custo, item e dados de eventos customizados são unidos no momento do relatório/consulta e podem ser unidos dentro do BigQuery.

Tipos de Metadados Que Você Pode Importar

Metadados

Importar metadados adiciona aos dados já coletados e processados por uma propriedade. Tipicamente, metadados são armazenados em uma dimensão ou métrica personalizada, embora em alguns casos você possa querer sobrescrever a informação padrão já coletada (por exemplo, importar um catálogo de produtos com categorias atualizadas).

Você pode importar os seguintes tipos de dados:

Dados de campanhas (Campaign data): Dados de cliques, custos e impressões de redes de anúncios de terceiros (não-Google).

Dados de itens (Item data): Metadados de produtos como tamanho, cor, estilo ou outras dimensões relacionadas a produtos.

Dados de usuários (User data): Metadados de usuários, por exemplo, classificação de fidelidade ou lifetime value do cliente, que você pode usar para criar segmentos e listas de remarketing.

Eventos (Events): Importar dados de eventos que não foram previamente capturados em tempo real. Isso inclui eventos não capturados anteriormente por uma tag do Google ou de fontes sem conexão com internet ou suporte para coleta em tempo real. Remover esses dados requer deleção de usuário ou de dados.

• •Web ou app mobile: você precisa escolher associar seus eventos com a plataforma Web ou Mobile app. Essa escolha permite que o Analytics forneça e valide os campos mais apropriados para você importar.

Dados de eventos customizados (Custom event data): Importar metadados de eventos via campos padrão e/ou dimensões customizadas.

Limites de Importação

Limites Gerais

Tamanho da fonte de importação: 1GB

Uploads diários: 120 uploads por propriedade por dia

Limites por Tipo de Dado

Você pode encontrar o uso atual da cota dentro do produto através do botão "Quota information".

Como Importar Dados

Quando você importa dados, você cria uma fonte de importação ao conectar uma nova fonte ou fazer upload de arquivos CSV contendo dados externos.

Não faça upload de um arquivo que inclui chaves duplicadas (por exemplo, 2 campos chamados user_id).

Iniciar o Processo de Importação

1. •

   Em Admin, em Data collection and modification, clique em Data import

   Nota: Você precisa estar logado em uma Conta do Google para abrir a propriedade. Você pode mudar a propriedade usando o seletor de propriedades. Você precisa ter permissão de Editor ou superior no nível da propriedade para iniciar o processo de importação.

2. •

   Crie uma nova fonte de importação ou selecione uma fonte existente.

Criar Uma Nova Fonte de Importação

1. •Clique em Create import source
2. •Insira um nome para sua fonte de importação
3. •Selecione o tipo de dado:
   • •Campaign data (importação query-time apenas)
   • •Item data (importação reporting/query-time)
   • •User data by User ID (importação collection/processing-time)
   • •User data by Client ID (importação collection/processing-time)
   • •Events data (importação collection/processing-time)
   • •Custom event data (importação reporting/query-time)
4. •Clique em Review terms se solicitado. Esse prompt aparece se você está importando dados de dispositivo ou usuário
5. •No dropdown "Import source", selecione uma das opções:
   • •Selecione Manual CSV upload, selecione o arquivo CSV no seu computador, então clique em Open
   • •Selecione SFTP. Saiba mais sobre uso de SFTP para importar dados na seção abaixo
   • •Selecione uma fonte de importação do menu dropdown. Fontes de importação suportadas fazem parte de um beta aberto e estão disponíveis apenas para dados de campanhas
6. •Clique em Next para prosseguir para o estágio de mapeamento
7. •Selecione os nomes dos campos importados que você quer mapear para os campos do Analytics
8. •Clique em Import

Fazer Upload de Dados Para Uma Fonte de Importação Existente

1. •Na linha de uma fonte de importação existente, clique em Import now
2. •Se a fonte de importação está configurada para importação CSV, selecione o arquivo CSV que você quer importar e clique em Open

O arquivo CSV precisa incluir os mesmos campos, ou um subconjunto dos campos, do original. Se você quer importar campos diferentes para o mesmo tipo de dado, precisa deletar a fonte de importação existente e criar uma nova.

Importação de dados de eventos feita na propriedade de origem será automaticamente exportada tanto para as roll-up quanto subpropriedades se os dados atenderem aos filtros aplicados. Subpropriedades não herdam outras configurações de entidade como dimensões e métricas customizadas, importações de dados de usuários e importações de dados de query-time como custos e eventos customizados. Porém, você pode recriá-las em uma subpropriedade.

Usando SFTP Para Importar Dados

Detalhes Necessários Para Upload de Dados

Nome de usuário do servidor SFTP: Insira seu nome de usuário para seu servidor SFTP.

URL do servidor SFTP: Insira a URL para seu servidor SFTP.

Frequência: Escolha a frequência de upload (Diária, Semanal, Mensal).

Hora de início: Selecione a hora em que você quer que o upload comece.

Pré-requisitos Para Usar SFTP

Se você planeja usar a opção SFTP, certifique-se de que seu servidor SFTP suporta os algoritmos de host-key ssh-rsa e ssh-dss.

Como Verificar Algoritmos e Formatar a URL do Servidor SFTP

Verificar algoritmos:

Existem diferentes métodos que você pode usar para verificar se seu servidor SFTP usa os algoritmos ssh-rsa ou ssh-dss. Por exemplo, você pode usar o cliente de login remoto OpenSSH para verificar seus logs do servidor via o seguinte comando:

ssh -vv <nome do seu servidor sftp>

Se seu servidor suporta algum desses algoritmos, você deve notar uma linha como a seguinte no log do servidor:

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

Formatar URL do servidor SFTP:

Se a URL do seu servidor SFTP está mal formatada, sua configuração de importação vai falhar com uma mensagem de erro interno.

Uma URL de servidor SFTP geralmente tem 3 partes que você precisa considerar para fazer upload de arquivos de importação de dados. Por exemplo:

sftp://example.com//home/jon/upload.csv tem as seguintes partes:

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

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

Você pode formatar a porção do domínio da URL de várias formas, usando o nome do domínio ou o endereço IPv4 ou IPv6 do servidor, com ou sem 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 porta padrão é 22.

Você pode formatar corretamente a URL para incluir ou excluir o diretório home. Os seguintes exemplos de URLs corretamente formatadas usam diferentes formatos para identificar o domínio:

Incluir diretório home:

• •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 diretório home:

• •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 seu arquivo de upload está localizado em um subdiretório do seu diretório home, sua URL seria algo como:

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

Nesse caso, você pode usar os seguintes tipos de formatos:

Incluir diretório home:

• •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 diretório home:

• •sftp://example.com/data/upload.csv
• •sftp://[2607:f8b0:4007:817::2004]:1234/data/upload.csv (IPv6 com número de porta)

Se seu arquivo de upload não está armazenado no seu diretório home ou em um subdiretório dele, e está armazenado no diretório /foo/bar, então a URL corretamente formatada seria algo como:

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

Ver Detalhes da Fonte de Dados, Obter Chave Pública SFTP, Importar Novos Dados, Deletar Fonte de Importação

1. •

   Em Admin, em Data collection and modification, clique em Data import

   Nota: Você precisa ter permissão de Viewer ou superior no nível da propriedade para ver detalhes da fonte de importação.

2. •

   Na linha da fonte de importação, clique no ícone de mais opções

Você pode ver o nome, tipo de dado, chave pública e histórico de cada upload.

Chave pública (Public key): A chave pública do servidor SFTP que corresponde a uma chave privada correspondente que o Analytics armazena (e nunca compartilha) que é usada para garantir uma conexão segura e privada entre seu servidor e os servidores de importação de dados do Analytics. É vital que você autorize essa chave pública no seu servidor para garantir que a importação de dados possa funcionar de forma segura.

% importado (% imported): O número de linhas importadas com sucesso dividido pelo número de linhas no arquivo de importação. 100% significa que todas as linhas foram importadas com sucesso.

Taxa de correspondência (Match rate):

• •Para importação de dados de itens e eventos customizados: A razão de chaves no arquivo de importação que podem ser encontradas na sua propriedade nos últimos 90 dias. 100% significa que os dados são totalmente úteis e relevantes para seus dados nos últimos 90 dias.
• •Para importação de dados de custo: A porcentagem de linhas importadas unidas com sucesso com dados do Analytics. 100% significa que todas as linhas importadas foram unidas com sucesso. Esse cálculo considera apenas os últimos dois anos dos seus dados importados.

Nota: % importado e taxa de correspondência são relevantes para importação de dados de custo, itens e eventos customizados, mas não são aplicáveis para importação de dados de usuários ou dados de eventos.

Para Importar Novos Dados

Clique em Import now e escolha o arquivo CSV relevante no seu computador.

Para Deletar a Fonte de Importação

1. •Clique em Mais > Delete import source
2. •Leia o aviso de deleção, então clique em Delete import source

Você pode deletar dados de Collection/Processing-time, mas se quiser remover os dados que foram previamente carregados de todos os eventos processados pelo Analytics, então você pode precisar fazer uma deleção de usuário ou propriedade de usuário. Deletar um arquivo já importado não vai remover os dados processados que foram associados com eventos coletados desde que a importação foi completada.

Nomes e Prefixos Reservados

Os seguintes nomes de eventos, nomes de parâmetros de eventos, nomes de propriedades de usuários e prefixos são reservados para uso pelo Analytics. Se você tentar fazer upload de dados que incluem qualquer um dos nomes ou prefixos reservados, esses dados não serão carregados.

Por exemplo:

• •Se você tentar importar um evento com um nome reservado, esse evento e seus parâmetros não serão importados.
• •Se você tentar importar um evento com um nome válido mas um dos parâmetros usa um nome reservado, o evento será importado mas o parâmetro com o nome reservado não será importado.

Nomes de Eventos Reservados

• •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 de Usuários Reservados

• •first_open_after_install
• •first_open_time
• •first_visit_time
• •last_deep_link_referrer
• •user_id

Prefixos Reservados (aplica-se a parâmetros de eventos e propriedades de usuários)

• •ga_
• •google_
• •firebase_

Nomes de Parâmetros de Itens Reservados

• •affiliation
• •cid
• •creative_name
• •currency
• •customer_id
• •customerid
• •item_brand
• •item_category
• •item_category2
• •item_category3
• •item_category4
• •item_category5
• •item_id
• •item_list_id
• •item_list_name
• •item_name
• •item_variant
• •promotion_id
• •promotion_name
• •session_id
• •sessionid
• •sid
• •uid
• •user_id
• •userid

Diferenças Entre Collection Time e Query Time

Entender a diferença entre esses dois tipos de importação é fundamental:

Collection/Processing Time:

• •Os dados são unidos permanentemente quando coletados
• •Ficam armazenados nas tabelas do GA4
• •São exportados para o BigQuery
• •Não podem ser removidos deletando o arquivo (apenas via deleção de usuário)
• •Exemplos: User Data, Events

Query/Reporting Time:

• •Os dados são unidos temporariamente quando você abre relatórios
• •Não ficam permanentemente armazenados com os eventos
• •Se você deletar o arquivo, os dados somem dos relatórios
• •Não estão disponíveis para criação de públicos
• •Exemplos: Campaign Data (custos), Item Data, Custom Event Data

Essa diferença é importante porque afeta como você gerencia os dados e quais funcionalidades do GA4 podem usar esses dados importados.

Casos de Uso Práticos

Importação de custos de anúncios: Se você anuncia no TikTok, Pinterest, Snapchat ou outras plataformas que não são Google, você precisa importar os dados de custo manualmente para ter visão completa de ROI no GA4.

Enriquecimento de dados de produtos: Se você tem um catálogo extenso de e-commerce, pode importar atributos adicionais dos produtos (margem, fornecedor, categoria interna) que não estão sendo coletados via tag.

Dados de CRM: Importar lifetime value, segmento de cliente, classificação de fidelidade permite criar públicos mais sofisticados e analisar performance por valor do cliente.

Eventos offline: Se você tem eventos de conversão que acontecem offline (ligações telefônicas convertidas, vendas em loja física vinculadas a campanhas online), pode importar esses eventos para análise completa.

Limitações e Cuidados

Chaves de união: A qualidade da união de dados depende totalmente da qualidade das suas chaves. Se você está importando dados de usuário por User ID, todos os eventos precisam ter esse User ID coletado. Se a taxa de matching é baixa, seus dados importados não vão aparecer na maioria dos relatórios.

Dados históricos: Para importações de Collection Time, dados importados não se unem retroativamente com dados históricos. Apenas eventos coletados após a importação terão os dados enriquecidos.

Taxa de correspondência baixa: Se você vê taxa de correspondência baixa em importações de custo ou itens, significa que as chaves no seu arquivo de importação não estão batendo com as chaves nos dados coletados pelo GA4. Isso pode indicar problemas de implementação de UTMs ou parâmetros de produto.

Limites de volume: Fique atento aos limites de 120 uploads por dia e 1GB por fonte de importação. Para operações grandes, planeje sua estratégia de importação considerando esses limites.

Quando Usar Data Import

A funcionalidade faz sentido quando você:

• •Tem dados em sistemas externos que são relevantes para análise de marketing
• •Precisa de visão unificada de performance cross-channel incluindo plataformas não-Google
• •Quer enriquecer dados de produtos ou usuários com informações de sistemas internos
• •Tem eventos de conversão offline que precisa conectar com campanhas online
• •Quer análises mais sofisticadas considerando atributos que não são coletados nativamente

A funcionalidade é menos útil quando:

• •Você só trabalha com plataformas do Google (já tem integração nativa)
• •Não tem forma confiável de criar chaves de união entre sistemas
• •Seus dados externos mudam com muita frequência (>120 vezes por dia)
• •Você não tem processo estruturado para extrair e formatar dados dos sistemas de origem

Como Começar

Se você decidiu usar Data Import, comece pequeno:

1. •Identifique qual tipo de dado traria mais valor (normalmente custos de anúncios é o mais comum)
2. •Exporte um arquivo CSV de teste com poucos dias de dados
3. •Configure a fonte de importação no GA4
4. •Valide a taxa de correspondência e % importado
5. •Se estiver funcionando bem, automatize via SFTP ou script
6. •Expanda para outros tipos de dados conforme necessário

A chave é validar que a união de dados está funcionando antes de investir em automação completa.

Precisa de ajuda para estruturar uma estratégia de medição que integra dados de múltiplas fontes?

A Métricas Boss desenvolve arquiteturas de dados e processos de importação para empresas que precisam de visão unificada de performance. Fale conosco.

Gustavo Esteves

Gustavo Esteves é fundador e CEO da Métricas Boss, já trabalhou dentro de gigantes como B2W. Autoridade na área de Digital Analytics, com mais de 15 anos de experiência e 3 mil projetos atendidos, incluindo gigantes como PUC, Rede D'Or, Globo, Stanley, Médico Sem Fronteiras, Alura, entre outras.

Publicado em 2 de fevereiro de 2026