Sobre a importação de dados

Fazer upload de dados de origens externas e combiná-los com seus dados do Google Analytics

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 publisher 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

Conecte uma fonte de importação ou faça upload de arquivos CSV contendo 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.
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 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.

Observação: os dados de processamento importados, como dados do usuário e de eventos, são agregados no momento da coleta/tratamento e exportados para o BigQuery. Os dados do momento da consulta, como custo, item e dados de eventos personalizados, são combinados no momento do relatório/consulta, e isso pode ser feito no BigQuery.

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 campanha: 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: importe dados de eventos que não foram capturados anteriormente em tempo real. Isso inclui eventos não capturados por uma tag do Google ou de fontes sem conexão de Internet ou suporte à coleta em tempo real. Para remover esses dados, é preciso excluir o usuário ou as informações.
- Web ou app para dispositivos móveis: escolha associar seus eventos ao tipo de plataforma: Web ou app para dispositivos móveis. Essa escolha permite que o Google Analytics forneça e valide os campos mais apropriados para importação.
Dados de eventos personalizados: importações de metadados de eventos usando campos padrão e/ou dimensões personalizadas.

Limites

Tamanho da origem da importação	1 GB
Uploads diários	120 uploads por propriedade a cada dia

Importar tipo de dados	Limite de origens de importação por propriedade	Limite de armazenamento por tipo de dados
Dados da campanha		1 GB em todas as origens de importação
Dados do item	Até 5	1 GB em todas as origens de importação
Dados do usuário	Até 10	Não relevante
Eventos	Até 10	Não relevante
Dados de eventos personalizados	Até 5	1 GB em todas as origens de importação

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

Como importar dados

Na importação, você cria uma origem quando conecta uma nova origem ou faz upload de arquivos CSV com dados externos.

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 origens de importação.

Iniciar o processo de importação

Em Administrador, em Coleta e modificação de dados, clique em Importação de dados.

Observação: o link anterior abre a última propriedade do Google Analytics que você acessou. É necessário fazer login em uma Conta do Google para abrir a propriedade. É 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.
Crie uma nova origem de importação ou selecione uma já criada. Consulte as seções a seguir.

Criar uma nova origem de importação

Clique em Criar origem de importação.
Insira um nome para a origem da importação.
Selecione o tipo de dados:
- Dados de campanha (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 (importação de tempo de processamento/coleta)
- Dados de eventos personalizados (importação de tempo de consulta/geração de relatórios)
Clique em Ler os termos se solicitado. Essa solicitação aparece quando você está importando dados do dispositivo ou do usuário.
No menu suspenso "Importar fonte", selecione uma das seguintes opções:
- Escolha Upload manual de CSV, selecione o arquivo CSV no seu computador e clique em Abrir.
- Selecione SFTP. Saiba como usar o SFTP para importar dados.
- Selecione uma origem de importação no menu suspenso. As fontes de importação compatíveis fazem parte de uma versão Beta aberta e só estão disponíveis para dados de campanha. Saiba como conectar uma fonte de importação.
Clique em Avançar e siga para a etapa de mapeamento.
Selecione os nomes dos campos importados que você quer mapear para o campo "Google Analytics".
Clique em Importar.

Fazer upload de dados para uma fonte de dados

Na linha de uma fonte de importação atual, clique em Importar agora.
Se a fonte de importação estiver configurada para CSV, selecione o arquivo nesse formato 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 importação atual e criar uma nova.

A importação de dados de eventos feita na propriedade de origem será exportada automaticamente para as subpropriedades e a propriedade de visualização completa se os dados atenderem aos filtros aplicados. As subpropriedades não herdam outras configurações de entidade, como dimensões e métricas personalizadas, importações de dados de usuários e importações de dados do aumento do tempo de consulta, como custo e eventos personalizados. No entanto, é possível recriá-las em uma subpropriedade.

Usar o SFTP para importar dados

Detalhes necessários para fazer upload de dados

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.

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 como verificar quais algoritmos de chave de host você usa e como formatar o URL do servidor SFTP.

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. Por 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 (//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 origem de importação

Em Administrador, em Coleta e modificação de dados, clique em Importação de dados

Observação: o link anterior abre a última propriedade do Google Analytics que você acessou. É necessário fazer login em uma Conta do Google para abrir a propriedade. É 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 importação.
Na linha da origem da importação, 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:
- Para importação de dados de itens e eventos personalizados: 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 de custo: a porcentagem de linhas importadas que foram combinadas com os dados do Google Analytics. O valor de 100% indica que todas as linhas importadas foram combinadas. Esse cálculo considera apenas seus dados importados nos últimos dois anos.

Observação: a % de linhas importadas e a taxa de correspondência são relevantes para a importação de dados de custo, itens e eventos personalizados, mas não se aplicam à importação de dados de usuários ou eventos.

Para importar dados novos, faça o seguinte:

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

Para excluir a origem da importação:

Clique em > Excluir origem da importação.
Leia a notificação de exclusão e clique em Excluir origem de importação.

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.

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
erro
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_

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

Isso foi útil?

Como podemos melhorá-lo?