Configuração do Google Analytics 4
O Google Analytics 4 é um parceiro de analytics integrado à Adjust. Nossa integração permite que o Google Analytics 4 receba dados mensurados na Adjust por meio de callbacks automáticos. Use esses dados com as ferramentas de parceiros para analytics e insights.
Neste artigo, saiba como configurar a mensuração com o Google Analytics 4 para seu aplicativo. Isso inclui a ativação da integração e a escolha dos dados que a Adjust pode compartilhar com o Google Analytics 4.
Antes de começar
Requisitos
- Permissões de Administrador, Editor ou Editor personalizado na Adjust.
- SDK versão 4.0.0 da Adjust e posteriormente para mapear os parâmetros do SDK aos parâmetros de Google Analytics 4. Siga os guias abaixo para usar essa funcionalidade.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Credenciais
Firebase App ID, API Secret
- Para obter ajuda para encontrar suas credenciais, entre em contato com seu representante do Google Analytics 4.
No painel do Google Analytics 4:
Para saber seu ID do Firebase:
- Vá ao console do Firebase
- Encontre seu projeto e clique nele
- Clique no ícone de engrenagem > "Configurações do projeto" ao lado de "Visão geral" no lado esquerdo do painel
- Em "Seus apps", selecione o aplicativo e encontre o ID do app do Firebase em "ID do app".
Para saber sua API secret (chave secreta da API):
- Vá ao seu painel do Google Analytics
- Selecione Administrador > Coleta e modificação de dados > Fluxos de dados
- Selecione o fluxo de dados do seu aplicativo e encontre a API secret em Chaves secretas da API do Measurement Protocol > Valor do secret
- Se não houver nenhuma API secret, em API Secrets do Protocolo de Medição, selecione Criar e insira um nome. Depois, selecione Criar.
Selecione Google Analytics 4 e o seu aplicativo no Campaign Lab
- Em Campaign Lab, selecione Parceiros.
- Selecione Novo parceiro > Google Analytics 4. Selecione Próximo para ir para a próxima tela.
- Na tela Seleção de aplicativos, escolha o aplicativo para o qual deseja criar o link e habilite a integração para compartilhar dados com o Google Analytics 4.
- Selecione Próximo.
Habilitar o compartilhamento de dados
Habilite o compartilhamento de dados para ativar a integração com o Google Analytics 4. Para fazer isso:
- Insira seus Firebase App ID, API Secret.
Depois que você habilitar o compartilhamento de dados com o Google Analytics 4, a Adjust enviará automaticamente os seguintes dados ao Google Analytics 4, por padrão:
- instalação
- reatribuição
Configurar suas opções de compartilhamento de dados
Se estiver trabalhando com um aplicativo multiplataforma com compartilhamento de dados habilitado para várias plataformas, você pode:
- Separar opções de compartilhamento de dados no nível de plataforma selecionando Usar as configurações específicas da plataforma.
- Definir as mesmas configurações de compartilhamento de dados para múltiplas plataformas selecionando Usar as configurações globais.
Agora, em O que será compartilhado por padrão?, revise as atividades que o Adjust compartilha com o Google Analytics 4 por padrão:
- instalação
- reatribuição
Enviar dados adicionais
Escolha a quantidade e o tipo de dados que deseja compartilhar com o Google Analytics 4 por meio de retornos de chamada. O Google Analytics 4 pode usar essas informações para otimizar o desempenho.
Para enviar dados adicionais, você pode revisar e personalizar o seguinte:
Habilitar o Google Analytics 4 para seu aplicativo
Na tela Revisão da configuração, revise suas escolhas. Você também pode retornar e fazer alterações em:
- Seu app selecionado
- Opções de compartilhamento de dados
Selecione Habilitar parceiro para habilitar o Google Analytics 4 para seu aplicativo. Os parceiros de análise não trabalham com links para campanhas. Uma vez ativada, nossa integração envia dados de atribuição e de eventos no aplicativo por meio de callbacks automatizados.
Instruções de configuração de parceiros específicos
Nossa integração com o Google Analytics 4 permite que a Adjust envie dados de atribuição entre redes para o Google Analytics. Se você já estiver registrando conversões com o Google Analytics com o SDK do Firebase, você precisa ativar a integração. A Adjust usa o evento campaign_details na API do Measurement Protocol para enviar conversões junto com os dados de atribuição.
Essa integração requer que o SDK do Firebase esteja integrado ao seu aplicativo e aos parâmetros do parceiro da sessão para ser implementada no SDK da Adjust. Isso porque o Google Analytics 4 cria um app_instance_id para cada instância de uma instalação de um aplicativo contendo o SDK do Firebase. Se o app_instance_id não for rastreado e passado de forma adequada, a Adjust não enviará callbacks ao Google Analytics.
Siga os guias abaixo para usar esse recurso:
iOS / Android / Unity / Flutter / React Native
Os parâmetros do parceiro da sessão permitem que o SDK da Adjust rastreie o app_instance_id do Google Analytics 4 e o inclua ao enviar dados ao Google. É preciso definir o app_instance_id antes de inicializar o SDK da Adjust.
Observação : o tráfego orgânico não é compartilhado por essa integração. Devido a diferenças na metodologia de atribuição, o Google Analytics não aceita conversões que ocorreram há mais de três dias. Dependendo das janelas de atribuição configuradas para seus links, você pode ver discrepâncias já que algumas conversões não serão registradas no Google Analytics 4.
Lista de todos os parâmetros encaminhados a Google Analytics 4
O Google Analytics 4 solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks:
Placeholder | Informação |
{adgroup_name} | Nome do grupo de anúncios, conforme retirado do tracker |
{campaign_name} | Nome da campanha, conforme retirado do tracker |
{creative_name} | Nome criativo, conforme retirado do tracker |
{engagement_time} | Marca temporal do engajamento |
{network_name} | Nome da rede, conforme retirado do tracker |