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 (for mobile apps), Measurement ID (for web apps), 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:

1. Vá ao console do Firebase
2. Encontre seu projeto e clique nele
3. Clique no ícone de engrenagem > "Configurações do projeto" ao lado de "Visão geral" no lado esquerdo do painel
4. 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):

1. Vá ao seu painel do Google Analytics
2. Selecione Administrador > Coleta e modificação de dados > Fluxos de dados
3. Selecione o fluxo de dados do seu aplicativo e encontre a API secret em Chaves secretas da API do Measurement Protocol > Valor do secret
4. 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

1. Em Campaign Lab, selecione Parceiros.
2. Selecione Novo parceiro > Google Analytics 4. Selecione Próximo para ir para a próxima tela.
3. 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.
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:

1. Insira seus Firebase App ID (for mobile apps), Measurement ID (for web apps), 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:

1. Separar opções de compartilhamento de dados no nível de plataforma selecionando Usar as configurações específicas da plataforma.
2. 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

Our Google Analytics 4 (GA4) integration allows Adjust to send cross-network attribution data to Google Analytics. You should enable this integration if you are already logging conversions with the Google Analytics for Firebase SDK or using Google Analytics 4 for web. Adjust leverages the campaign_details event of the Measurement Protocol API to send conversions along with attribution details.

Requirements

This integration supports both mobile apps and web-based apps:

• For mobile apps:
  • The Firebase SDK must be integrated into your app.
  • A Firebase App ID is required.
  • You must implement session partner parameters within the Adjust SDK to capture and send Google Analytics 4’s app_instance_id.
  • You should set app_instance_idbefore initializing the Adjust SDK.
• For web-based apps:
  • A Measurement ID from your GA4 web property is required.
  • You must implement session partner parameters within the Adjust SDK to capture and send Google Analytics 4’s client_id.
  • You should set client_idbefore initializing the Adjust SDK.

These identifiers (app_instance_id for mobile, client_id for web) are essential because Google Analytics 4 uses them to uniquely identify each user or app instance. If these values are not properly tracked and passed, Adjust will not be able to fire callbacks to Google Analytics.

Follow the guides linked below to use this feature:

iOS / Android / Unity / Flutter / React Native

Additional Notes

• Organic traffic is not shared via this integration.
• Due to differences in attribution methodology, Google Analytics does not accept conversions older than 3 days.
• Depending on your Adjust Link attribution windows, you might see discrepancies because some conversions may not be reported in GA4.

About Session ID

You can send the Firebase Session ID through the session partner parameter ga4_session_id

About User ID

You can send the Firebase User ID through the session partner parameter ga4_user_id

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: