Preparar seus dados para importação

This article applies to supported import sources that are part of an open beta and are subject to change.

Manter seus dados atualizados

É necessário atualizar os dados na fonte de importação antes de uma execução manual ou programada da conexão para que eles sejam importados e usados no destino ou caso de uso pretendido. Por exemplo, se você escolher uma programação diária, será preciso atualizar os dados diariamente, antes do horário de início programado.

Disponibilizar seus dados

Ao se conectar a uma fonte de dados de importação, cada caso de uso que você quiser implementar vai precisar de uma tabela específica ou de um subconjunto filtrado das informações da tabela nessa fonte. É possível reutilizar a tabela de uma fonte de dados conectada em vários casos de uso com diferentes subconjuntos filtrados dessa tabela.

Para algumas fontes de importação, você precisa ter as credenciais relevantes para fazer a conexão. Consulte o guia específico da fonte que você está usando para conferir as orientações.

Formatar seus dados

As seções a seguir mostram como formatar seus dados corretamente para garantir que eles possam ser importados sem erros.

Sobre os formatos de arquivos

Se você estiver fazendo upload de um arquivo, como um CSV, a primeira linha dele precisa conter os cabeçalhos.

Verifique se o arquivo tem uma extensão, porque aqueles que não têm extensões são rejeitados.

Sobre os formatos de data e hora

A conversão de datas e horas de vários formatos em um carimbo de data/hora lógico é aceita e precisa ser baseada em seis modelos que usam três conjuntos de formatos: DATE, TIME e TIMEZONE. O tipo DATETIME não é aceito. Os campos DATETIME precisam ser convertidos para o tipo STRING na fonte de importação usando os formatos compatíveis descritos neste artigo.

Confira a seguir exemplos de carimbos de data/hora nos formatos aceitos:

• 2012-08-15T00:01:54Z (padrão UTC ISO 8601)
• 2012-08-14T17:01:54-07:00 (padrão ISO 8601 com ajuste)
• Aug 14, 2012 17:01:54
• 08/14/2012T5:01:54 PM
• 2012-08-14 5:01:54 PM
• 08/14/2012 17:01:54
• 2012-08-14 17:01:54
• 08/14/2012 17:01:54*123
• 2012-08-14T17:01:54-07
• 08/14/2012T17:01:54-0700
• 2012-08-14T17:01:54-070000
• 2012-08-14T17:01:54-07:00:00
• 2012-08-14T17:01:54 America/Los_Angeles
• Aug 14, 2012 17:01:54PST
• 2012-08-14 17:01:54 PST
• 2012-08-14 17:01:54 Pacific Standard Time
• 2012-08-14 17:01:54 GMT-07:00
• 08/14/2012 17:01:54 GMT-07:00:00
• Julho 17, 2025 17:01:54 PST
• 17 de julho de 2025 17:01:54 GMT-07:00
• 17-Jul-2025T17:01:54-07:00

Ao importar dados, o Google Analytics converte automaticamente vários formatos de data comuns para o padrão ISO 8601, AAAA-MM-DD.

Os seguintes formatos são compatíveis com campos de data:

Formato	Descrição	Exemplo
AAAA-MM-DD	ISO 8601	2025-07-17
MM/DD/AAAA	Formato dos EUA	07/17/2025
MMM DD, AAAA	Nome abreviado do mês	Jul 17, 2025
DD de Mês, AAAA	Formato longo	17 de julho de 2025
DD de Mês de AAAA	Formato longo europeu	17 de julho de 2025
DD-MMM-AAAA	Formato internacional comum	17-Jul-2025

Datas ambíguas, como 02/01/2026, podem passar na validação e serem processadas como 1º de fevereiro, já que o formato MM/DD/AAAA é aceito, mesmo que você tenha se referido a 2 de janeiro. Para garantir a precisão dos dados, se o sistema identificar uma única linha usando o formato DD/MM/AAAA, a importação vai falhar para evitar o processamento incorreto.

Sobre a criptografia com hash de dados particulares dos clientes

Para proteger os dados, é necessário gerar hash das informações particulares dos clientes que você importar. Os dados serão criptografados com hash usando o algoritmo SHA256, que é o padrão do setor para hash unidirecional. O resultado é codificado em hexadecimal. Não é necessário formatar previamente os dados. Os campos de informações de identificação pessoal (PII) relevantes serão normalizados, gerados em hash e codificados para você, e os dados serão enviados à API para os casos de uso.

Se você preferir gerar hash das informações particulares dos clientes por conta própria, consulte Formatar seu arquivo de dados de clientes para garantir que esteja tudo certo. Se você fizer o upload de um arquivo de dados com hash, não gere hash das informações que não são particulares dos clientes. Os dados com hash serão enviados para a API.

O hash inteligente é automático, ou seja, você não precisa selecionar nada no menu "Ações".

Definir o escopo da importação de dados usando filtros

Você pode definir condições de filtro diretamente na interface, eliminando a necessidade de criar pipelines de dados personalizados ou escrever consultas SQL complicadas na sua fonte de importação. Quando você cria um filtro, apenas os dados da sua fonte de importação (para todos os casos de uso) que atendem a todas as condições do filtro são importados.

É possível aplicar um filtro com até 25 condições por fonte de importação conectada.

Criar um filtro

Para criar filtros em uma nova fonte de importação, adicione-os durante a etapa Selecionar dados da configuração:

1. Na etapa Selecionar dados da configuração, clique em Filtro para abrir.
2. Selecione o campo a ser usado para filtrar os dados.
3. Selecione um operador.
4. Insira um valor.
5. Opcional: crie outras condições clicando em E ou Ou.
6. Continue o processo de configuração.

Para criar e editar filtros em uma fonte de importação conectada:

1. Clique no nome da fonte para editá-la.
2. Em Filtro, clique em Editar.
3. Faça as mudanças e clique em Salvar.

Operadores compatíveis

• E
• OU
• Não contém (strings, números inteiros, data, hora, booleano)
• Contém (strings, números inteiros, data, hora, booleano)
• Maior que (número inteiro)
• Igual a (número inteiro, string, data)
• Menor que (número inteiro)
• Antes (data, hora)
• Após (data, hora)
• Diferente de
• Começa com
• Termina com
• Não começa com
• Não termina com

Tipos de dados compatíveis

• Moeda
• Data
• Hora
• Booleano
• Número inteiro
• Menu suspenso
• String