Configuração do parceiro Google Analytics 4

O Google Analytics 4 é um parceiro analítico integrado à Adjust. Nossa integração 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.

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

Encontre suas credenciais

Para saber seu ID do Firebase:

1. Vá ao console do Firebase.
2. Encontre e selecione seu projeto.
3. Selecione Settings (ícone de engrenagem), depois Project settings no painel à esquerda.
4. Em Your apps, selecione o aplicativo e vá até o App ID (ID do app).
5. Encontre e copie seu ID do app do Firebase.

Para obter seu API secret (segredo da API):

1. Vá ao seu painel do Google Analytics.
2. Selecione Admin > Data collection and modification > Data streams.
3. Selecione o fluxo de dados do seu aplicativo e vá para API do Measurement Protocol > Secret value.
4. Encontre e copie seu API secret (segredo da API).
   1. Se você ainda não tiver um API secret, vá para Measurement Protocol API secrets (Chaves secretas da API do Measurement Protocol) e selecione Create (Criar).
   2. Insira um nome e selecione Create.

Integração com o SDK do Firebase

Essa integração requer que o SDK do Firebase esteja integrado com seu aplicativo e com 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 dos parceiros de 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.

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 habilitá-lo:

1. Insira seus Firebase App ID, API Secret.

Depois que você ativar o compartilhamento de dados com o Google Analytics 4, a Adjust enviará automaticamente os seguintes dados ao Google Analytics 4, por padrão:

• install
• reattribution

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.

Mapeando parâmetros

Normalmente é necessário mapear os parâmetros para compartilhar dados personalizados com o Google Analytics 4.

Os parâmetros de parceiros (disponíveis no SDK da Adjust, versão 4.0+) permitem à Adjust coletar pontos de dados personalizados do seu aplicativo e enviá-los ao Google Analytics 4. Isso permite que o Google Analytics 4 receba detalhes de eventos personalizados para cada um de seus eventos vinculados.

Antes de adicionar novos parâmetros de parceiros ao SDK da Adjust, confira se não há parâmetros de parceiros que já atendem seus requisitos.

Para encaminhar parâmetros de parceiros ao Google Analytics 4, siga estes passos.

1. Configure os parâmetros do parceiro no SDK da Adjust.

   • Confira Antes de começar para ver todos os links de plataformas de desenvolvimento de SDK.

2. Em Configure suas opções de compartilhamento de dados, selecione Parâmetros.

3. Em Mapear parâmetros, você pode especificar como deseja enviar à rede os parâmetros do parceiro definidos no SDK:

   1. Selecione Mapear parâmetro.
   2. No campo Parâmetro do SDK, insira o nome do parâmetro de SDK que você deseja compartilhar com a rede.
   3. No campo Parâmetro do parceiro, insira o parâmetro de rede que corresponde ao parâmetro do SDK.

Habilite o Google Analytics 4 para seu aplicativo

Na tela de Revisão de 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.

Lista de todos os parâmetros encaminhados a Google Analytics 4

Google Analytics 4 solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks: