Conecte o Google Analytics, passo a passo

Este guia tem quatro partes. Você as faz uma única vez. Deixe duas abas do navegador abertas: o Kaam360 e o Google.

Com o que você vai terminar

Duas coisas para colar no Kaam360:

• O número da propriedade: só dígitos, por exemplo 412345678.
• O arquivo de chave (JSON): um arquivo de texto que o Google permite baixar. Você cola o conteúdo inteiro dele.

Parte 1. Encontre o número da sua propriedade

1. Abra analytics.google.com e entre.
2. Clique no ícone de engrenagem (Administrador) no canto inferior esquerdo.
3. Na coluna do meio (Propriedade), clique em Detalhes da propriedade. Se você tiver várias propriedades, escolha a certa no topo primeiro.
4. No canto superior direito você verá ID DA PROPRIEDADE. É um número. Copie-o.

Parte 2. Ative a Google Analytics Data API

1. Abra console.cloud.google.com e entre com a mesma conta Google.
2. No topo, clique no seletor de projetos e em Novo projeto. Dê o nome "Kaam360 stats" e clique em Criar. Confirme que ele está selecionado.
3. Na caixa de pesquisa no topo, digite Google Analytics Data API e abra o resultado.
4. Clique em Ativar e aguarde alguns segundos.

Parte 3. Crie o arquivo de chave

1. Na mesma página do Google Cloud, abra o menu, depois IAM e administrador e depois Contas de serviço.
2. Clique em Criar conta de serviço. Dê o nome "kaam360-reader". Clique em Criar e continuar e depois em Concluído. Você não precisa escolher nenhum papel.
3. Clique na nova conta de serviço na lista. Copie o endereço de e-mail dela. Ele se parece com kaam360-reader@kaam360-stats.iam.gserviceaccount.com.
4. Abra a aba Chaves. Clique em Adicionar chave, depois em Criar nova chave, escolha JSON e clique em Criar.
5. Um arquivo pequeno é baixado para o seu computador. Guarde-o em sigilo, como uma senha.

Parte 4. Deixe a conta de serviço ver os seus números

1. Volte ao Google Analytics e clique no ícone de engrenagem (Administrador).
2. Na coluna Propriedade, escolha Gerenciamento de acesso à propriedade.
3. Clique no botão azul + e depois em Adicionar usuários.
4. Cole o endereço de e-mail da conta de serviço que você copiou.
5. Escolha o papel Leitor. Desmarque "Notificar novos usuários por e-mail", se aparecer. Clique em Adicionar.

Parte 5. Coloque no Kaam360

1. Abra Marketing, Tráfego do site e depois o seu site.
2. Em De onde vêm os números?, escolha Google Analytics 4.
3. Cole o número da propriedade em Número da propriedade do Google Analytics.
4. Abra o arquivo baixado com o Bloco de Notas (Windows) ou o TextEdit (Mac). Selecione tudo, copie e cole em Arquivo de chave do Google (JSON). Ele começa com { e termina com }.
5. Clique em Salvar e depois em Testar a conexão.
6. Uma mensagem verde significa que terminou. Os números aparecem na página Tráfego do site e são atualizados a cada 10 minutos.

Preciso mudar alguma coisa no meu site?

Não. Se o seu site já tem o código do Google Analytics, deixe-o exatamente como está. O Kaam360 lê os números do Google, então nada é adicionado ao seu site e o código do contador do Kaam360 não é necessário.

Se o teste falhar

• Mensagem de "Permission" ou "403": a parte 4 não foi feita, ou você adicionou o e-mail errado. Confira se o e-mail da conta de serviço está em Gerenciamento de acesso à propriedade com o papel Leitor. As mudanças podem levar alguns minutos para começar a funcionar.
• "API has not been used" ou "disabled": a parte 2 não foi feita no mesmo projeto do Google Cloud ao qual a chave pertence. Ative a Google Analytics Data API lá.
• "Property not found": você colou o número errado. Use os dígitos de Detalhes da propriedade, não o código G-.
• "Key file is not valid": você não copiou o arquivo inteiro. Copie do primeiro { até o último }.
• "Connected ... 0 page views from 0 visitors": a conexão funciona, mas o número da propriedade é de uma propriedade diferente daquela que recebe as visitas do seu site. Muitas contas têm mais de uma. No Google Analytics, escolha a propriedade que mostra suas visitas (no canto superior esquerdo), abra Administrador, Detalhes da propriedade e copie o ID DA PROPRIEDADE. Cole no Kaam360, clique em Salvar e depois em Testar a conexão de novo.
• Os números estão em zero: uma propriedade nova precisa de um dia para coletar dados. Confira se o seu site realmente tem a tag do Google Analytics.

Desfazer

Exclua a conta de serviço no Google Cloud ou remova-a de Gerenciamento de acesso à propriedade. O Kaam360 não consegue mais ler nada.