As fontes de dados compatíveis neste artigo estão disponíveis apenas para importação de dados de custo.
É possível vincular o Google Analytics às fontes de dados compatíveis. Para aproveitar ao máximo essas conexões, é preciso considerar os requisitos de preparação e configuração de dados, incluindo os tipos de fontes de dados, os campos a serem importados e as permissões de acesso.
Requisitos gerais
- Você precisa ter função de editor ou superior na propriedade.
- É necessário atualizar os dados antes de cada importação.
- Para fontes baseadas em arquivos, como HTTP, Planilhas Google, Google Cloud Storage e Amazon S3, os dados precisam estar no formato .csv ou .tsv.
- A primeira linha de dados da fonte precisa conter os cabeçalhos ou nomes das colunas. Por exemplo, o cabeçalho é "custo" e cada linha contém um número como o custo associado à linha.
- O nome da fonte precisa ser idêntico sempre que os dados forem atualizados. Se o nome for alterado toda vez, a integração será interrompida e os dados não serão atualizados.
Observações:
- Você pode atualizar os dados das fontes quantas vezes quiser. As atualizações podem incluir a adição ou remoção de usuários ou novas conversões.
- A importação de dados pode ser feita diariamente e permite atualizações programadas diárias.
Criar uma conexão de fonte de dados
- Na página 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. É possível mudar a propriedade com o seletor. Você precisa ter função de editor ou superior na propriedade para iniciar a importação.
- Crie uma fonte de dados ou selecione uma existente. Consulte as seções a seguir.
Criar uma nova fonte de dados
- Clique em Criar fonte de dados.
- Em seguida, insira um nome.
- Selecione os dados de custo (somente para importações de tempo de consulta).
- Clique em Ler os termos se solicitado. Essa solicitação aparece quando você está importando dados do dispositivo ou do usuário.
- Selecione uma conexão de dados no menu suspenso. Saiba como conectar uma fonte de dados.
- Clique em Avançar.
- Selecione um tipo de dados.
- Faça upload da fonte de dados que você quer usar.
- (Opcional) É possível aplicar filtros ou chaves de criptografia para configurar os dados que serão importados.
- Clique em Avançar.
- Para mapear campos, selecione os campos da fonte de dados nas listas suspensas referentes aos campos de destino.
- (Opcional) Aplique transformações aos dados.
- Clique em Avançar.
- Revise os detalhes da conexão, como nome, tipo de dados, programação de atualização, dados selecionados, campos mapeados e método de atualização.
- Clique em Concluir.
Fontes de dados compatíveis
As seguintes fontes de dados são compatíveis com o Google Analytics. Abra uma seção para conferir os requisitos e informações de solução de problemas de cada fonte.
Amazon Redshift
Requisitos
- O banco de dados Redshift que você quer usar precisa ser acessível pela Internet.
- É necessário fornecer o nome de usuário ou a senha de uma conta no banco de dados com acesso à tabela que contém as informações que você quer usar.
- Você precisa ter credenciais de um usuário com permissões (incluindo leitura) para acessar os dados no Redshift.
- O servidor do Redshift precisa estar acessível publicamente, ou você pode adicioná-lo à lista de permissões usando os intervalos de IP de us-central1, us-east1 ou us-west1 desta lista de intervalos.
Resolver erros
Erros de configuração
- Verifique se você está inserindo corretamente o URL e as credenciais do local do banco de dados.
- Confira se as credenciais usadas têm as permissões relevantes para acessar a tabela necessária.
- Verifique se a ação de conversão foi vinculada à conexão escolhida. Caso contrário, nenhuma informação será recebida.
Erros de execução programada
- A causa mais comum das falhas de execução programada é a atualização de permissões no Redshift. Verifique se a função ou conta correspondente à sua conta tem permissões para ler os dados.
- Confira se os dados ainda existem e se os nomes do esquema e da tabela não mudaram.
Amazon S3
Requisitos
- É necessário ter acesso a uma conta principal do Identity and Access Management da Amazon Web Services com permissões para:
- Fazer upload de objetos em um bucket do S3
- Gerar uma chave secreta e uma chave de API para uma função com acesso de leitura a um bucket do S3
- Além disso, convém ter permissões para criar funções com acesso a buckets específicos ou delegar o acesso a eles.
Resolver erros
Erros de configuração
- Verifique se você está inserindo o URL certo do identificador de conta.
- Confira se a primeira linha do seu objeto contém os cabeçalhos, como o endereço de e-mail e o nome.
- Confira o ID da chave de acesso e a chave de acesso secreta, que precisam ser diferentes.
- Verifique se o objeto no S3 tem uma extensão de arquivo. Arquivos sem extensão não são aceitos.
- Verifique se a ação de conversão foi vinculada à conexão escolhida. Caso contrário, nenhuma informação será recebida.
Erros de execução programada
- A causa mais comum das falhas de execuções programadas são as permissões atualizadas na AWS. Verifique se a função ou a conta correspondente à chave de acesso tem permissões para ler o objeto.
- Confirme se o objeto ainda existe e se o nome não foi alterado.
BigQuery
Requisitos
- É preciso ter acesso de proprietário do GCP no projeto do BigQuery e acesso de administrador do Google Ads para estabelecer uma conexão inicial entre a tabela do BigQuery e o Google Ads.
- Observação: o acesso de administrador do Google Ads pode ser revogado depois que a conexão é estabelecida.
- As visualizações do BigQuery precisam ser totalmente autorizadas, e a fonte delas não pode incluir tabelas externas. Saiba mais sobre as visualizações autorizadas e as fontes de dados externas.
Resolver erros
Erros de configuração
- Verifique se a ação de conversão foi vinculada à conexão escolhida. Caso contrário, nenhuma informação será recebida.
Google Cloud Storage
Requisitos
- Acesso a uma função do GCP com permissões de gravação em um bucket do GCS.
- Acesso administrativo do Google Ads para configurar a conexão inicial entre o bucket do GCS e o Google Ads.
Observação: as permissões de administrador só são necessárias durante o processo de configuração inicial.
Entender as permissões
Por que preciso compartilhar o acesso a um bucket inteiro quando quero compartilhar um único arquivo?
O Google Ads só vai oferecer controles de acesso no nível do objeto se a opção de acesso uniforme ao bucket estiver ativada e se a política do IAM que rege o acesso ao bucket for a v3 ou mais recente. Para conceder permissão a apenas um objeto em um bucket, ative a opção de acesso uniforme ao bucket e adicione a condição à sua conta de serviço. Para mais informações, consulte "Acesso uniforme no nível do bucket".
Observação: para transferir seus dados, é necessária apenas a permissão de leitura. Saiba mais sobre as permissões do IAM para o Cloud Storage.
Resolver erros
Erro — Falha ao carregar a lista de campos importados
- O objeto selecionado pode estar em um formato não compatível ou conter dados ilegíveis. Revise e atualize o objeto.
- Verifique se a ação de conversão foi vinculada à conexão escolhida. Caso contrário, nenhuma informação será recebida.
Planilhas Google
Requisitos
- É necessário ter acesso de editor ao arquivo das Planilhas Google.
- Sua conta do Google Ads precisa ter acesso de administrador.
Resolver erros
Problemas no formato do arquivo
Confira algumas dicas para evitar problemas ao importar dados das Planilhas Google
- Verifique se você tem acesso de editor à planilha Google e se ela contém dados.
- O arquivo precisa ser uma planilha Google nativa ou um arquivo com uma extensão, como .tsv ou .csv.
- A primeira linha da planilha ou do arquivo precisa consistir em cabeçalhos válidos, que podem ser informações como endereço de e-mail ou nome.
- Só é possível ler dados da primeira página de uma planilha Google. Se a planilha tiver várias páginas, verifique se a primeira página contém os dados que você está tentando importar.
Erros de configuração
Verifique se a ação de conversão foi vinculada à conexão escolhida. Caso contrário, nenhuma informação será recebida.
HTTPS
Requisitos
- É necessário ter acesso às seguintes credenciais: um URL para os dados que você quer importar, um nome de usuário e uma senha.
- O URL precisa usar o seguinte padrão:
https://[ip|domínio]/caminho/nomedearquivo.[csv|tsv].
Resolver erros
Erros de configuração
- Verifique se você está inserindo as credenciais e o URL do arquivo corretos.
- Confira se as credenciais usadas têm as permissões apropriadas para acessar os dados necessários.
- Verifique se a ação de conversão foi vinculada à conexão escolhida. Caso contrário, nenhuma informação será recebida.
MySQL
Requisitos
- O banco de dados MySQL que você quer usar precisa ser acessível pela Internet. Você pode restringir o acesso aos intervalos de endereços IP usados pelo Google Cloud.
- É necessário fornecer o nome de usuário e a senha de uma conta no banco de dados com acesso à tabela que contém os dados que você quer usar.
Resolver erros
Erros de configuração
Verifique se a ação de conversão foi vinculada à conexão escolhida. Caso contrário, nenhuma informação será recebida.
PostgreSQL
Requisitos
- O banco de dados Postgres que você quer usar precisa ser acessível pela Internet.
- É necessário fornecer o nome de usuário ou a senha de uma conta no banco de dados com acesso à tabela que contém as informações que você quer usar.
Resolver erros
Erros de configuração
- Verifique se você está inserindo corretamente o URL e as credenciais do local do banco de dados.
- Confira se as credenciais usadas têm as permissões apropriadas para acessar os dados necessários.
- Verifique se a ação de conversão foi vinculada à conexão escolhida. Caso contrário, nenhuma informação será recebida.
Erros de execução programada
- A causa mais comum das falhas de execuções programadas é a atualização de permissões no PostgreSQL. Verifique se a função ou a conta de usuário correspondente ao seu banco de dados tem permissões para ler os dados.
- Confira se os dados ainda existem e se os nomes do esquema e da tabela não mudaram.
Snowflake
Requisitos
- É preciso ter credenciais de uma conta do Snowflake (nome de usuário e senha). Você pode restringir o acesso aos intervalos de endereços IP usados pelo Google Cloud.
- É preciso ter uma conta do Snowflake com acesso à tabela que contém os dados que você quer usar. Você pode criar uma conta que só tenha acesso aos dados necessários para seu caso de uso.
Resolver erros
Verifique se a meta de conversão foi vinculada à conexão escolhida. Caso contrário, nenhuma informação será recebida.