1. Introdução
Última atualização:30/04/2019
O que você vai criar
- Neste codelab, você vai aprender a enviar eventos externos ao GA4 usando o Measurement Protocol.
- Este codelab presume que você já tem uma página da Web/site com o Google Analytics 4 implementado.
O que você vai aprender
- Etapas para fazer sua primeira ligação de MP
- Entender os parâmetros necessários para a chamada
- Enviar e validar sua chamada de teste
- Criar um script de exemplo em Python para fazer a chamada
O que é necessário
- Um site/página da Web
- Qualquer ambiente de desenvolvimento integrado para fazer mudanças
- Conta do GA4
- Opcional: ambiente de desenvolvimento Python (ou Colab)
2. Coletar os campos obrigatórios
Criar uma chave secreta da API no GA4
Acesse o GA4 e crie a nova chave secreta da API em Administrador > Fluxos de dados > escolha sua transmissão > Measurement Protocol > Criar
Você pode fornecer qualquer apelido, e o valor do secret será exibido, que você pode usar na chamada.
Coletar client_id
Você pode usar qualquer um dos métodos abaixo para coletar seu client_id.
- Coletando via gtag
Ambas são explicadas em detalhes abaixo
Coleta pela gtag
Você pode recuperar o client_id pelo seu site usando :
gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
Do something with clientID)
}
Confira abaixo mais links dependendo da sua infraestrutura
3. Criação da chamada
Você pode criar um exemplo de chamada usando o Criador de eventos no GA4. (Isso exige que você faça login e que os cookies estejam ativados). Verificar se a opção está definida como "gtag.js"
Você deve preencher os seguintes campos
- api_secret: já criado anteriormente no GA4
- Measurement_id: acesse "Administrador" > Fluxos de dados > escolha seu stream . Ele deve ser exibido conforme abaixo
- client_id: você já recuperou esse valor
- user_id não é obrigatório. Você pode deixar esse campo em branco por enquanto
- Categoria - altere para "Personalizado" no menu suspenso e coloque um nome de evento de sua escolha (não use eventos coletados automaticamente). Aqui, estamos usando "test_from_codelab".
Também é possível informar parâmetros de evento e/ou propriedades do usuário clicando nos botões abaixo
Depois de preencher tudo, você vai ver algo parecido com isto, com um botão para "Validar evento"
Depois, clique em "VALIDAR EVENTO". , o botão destacado em laranja. Ela vai exibir a mensagem abaixo, especificando que o evento é válido, e você verá um botão para agora "ENVIAR PARA GA". Nesse momento, se o evento aparecer como inválido, a ferramenta informará o campo exato em que há um problema, e você poderá corrigi-lo e tentar novamente
Agora você pode clicar no botão, e um evento de teste vai ser enviado para o GA4.
4. Como validar eventos no GA4
Depois de enviar o evento, acesse sua conta do GA4 e confira o Relatório de tempo real. Você verá o evento
Pode levar cerca de 24 horas para que os eventos sejam propagados da visualização em tempo real para a guia "Relatórios de eventos". Portanto, não se preocupe se essa informação não aparecer imediatamente nos relatórios de eventos normais.
5. Como criar um script Python
Agora que você o testou, pode examinar a chamada de API e o payload do evento para criar uma arquitetura semelhante em Python (ou em qualquer linguagem de sua escolha) que possa fazer essa chamada. Em seguida, você pode programar isso na frequência desejada e operacionalizá-lo. Para esta parte, você pode usar qualquer ambiente de desenvolvimento integrado de sua escolha que seja compatível com Python ou apenas usar um bloco do Google Colab que não exija instalação no dispositivo
Com base no Criador de eventos do GA4, o endpoint é o seguinte:
POST /mp/collect?measurement_id=XXXX&api_secret=XXXX
HTTP/1.1
Host: www.google-analytics.com
O payload do evento era como abaixo
{
"client_id": XXXX,
"non_personalized_ads": false,
"events": [
{
"name": "test_from_codelab",
"params": {
"test_param": "test_123"
}
}
]
}
Você pode traduzir isso para Python usando algo assim:
import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
"client_id": XXXX,
"non_personalized_ads": false,
"events": [
{
"name": "test_from_codelab",
"params": {
"test_param": "test_123"
}
}
]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)
Depois de usar os valores certos, o evento vai aparecer em tempo real no GA4.
6. Parabéns
Parabéns! Você usou o Measurement Protocol no GA4. Agora você pode criar arquiteturas de soluções avançadas para enviar dados mais significativos ao Google Analytics e melhorar suas análises de negócios e de marketing. Para aproveitar isso ao máximo, sugerimos que você se conecte ao Google Ads e importe esses eventos como conversões.
Você aprendeu
- Como coletar as variáveis corretas para fazer chamadas de MP
- Como enviar e validar eventos de teste
- Como criar um script para enviar chamadas MP