Pré-requisito: Antes de criar uma integração, certifique-se de entrar em contato com o parceiro e abrir uma conta com ele.

Para ativar a integração:

1. Para ativar: na AppsFlyer, no menu lateral, selecione Colaborar > Partner Marketplace.Para editar: na AppsFlyer, vá para o menu lateral e selecione colaborar > integrações ativas.
2. Selecione o aplicativo correspondente.
3. Pesquise por Google Analytics (GA4) e selecione-o.
4. Clique em Configurar a integração.
   Observação: o botão de alternância deve permanecer ativado (ativo) enquanto você trabalhar com o Google Analytics (GA4). Saiba mais
5. Complete a configuração utilizando as abas relevantes, conforme descrito abaixo.

A configuração do Google Analytics inclui apenas a aba Integração.

Para uma descrição detalhada do cabeçalho da janela de configuração de parceiros, clique aqui.

Defina as seguintes configurações:

1. Na aba Integração, selecione o aplicativo e ative a opção Ativar parceiro.

   Atenção: Essa opção deve permanecer ativada durante todo o tempo que você trabalhar com o parceiro.

   Para mais detalhes sobre a ativação do parceiro, clique aqui.

2. Em Firebase App ID, insira o identificador do aplicativo no Firebase. Para saber como localizá-lo, consulte a documentação do Firebase.
3. Em API Secret, insira o API Secret para autenticar os postbacks para o Google Analytics. Um API Secret é gerado através da interface do usuário do Google Analytics. Para visualizar, editar ou criar essa informação (secret), siga as instruções na documentação do Google. Quando instruído a selecionar um fluxo de dados da web, escolha um fluxo de dados do Android ou iOS.
4. Ative o Customer User ID para enviar o Customer User ID (CUID) em vez do advertising ID (IDFA).

5. Em Postbacks padrão, em para usuários de, selecione Todas as fontes de mídia, incluindo orgânicas.

    Nota

   O postback de instalação inclui apenas os detalhes do ponto de contato (fonte de mídia, nome da campanha e ID da campanha).

A AppsFlyer pode enviar postbacks automáticos para o GA4 após as instalações de usuários, incluindo instalações e reengajamentos (incluindo reatribuições). Os reengajamentos ocorrem quando um usuário que já tem o aplicativo instalado o abre depois de clicar em um link de campanha. Saiba mais sobre postbacks padrão.

Na aba Integração, mapeie os eventos in-app da AppsFlyer para os eventos do Google Analytics (GA4), enviados via postbacks.

1. Ative os postbacks de eventos in-app.

2. Clique em Adicionar evento para adicionar um SDK ou evento de servidor para servidor à lista. A tabela a seguir descreve os campos a serem preenchidos:

   Nome do parâmetro	Descrição
   Evento AppsFlyer	O nome do evento, conforme recebido do SDK integrado no aplicativo ou de eventos de servidor para servidor. Dica: não encontrou o evento que está procurando? Certifique-se de ativar o evento em um dispositivo com uma instalação não orgânica e verifique novamente. Digite-o em evento da AppsFlyer, depois clique em criar evento personalizado. Saiba mais sobre o mapeamento de eventos personalizados.
   Mapeado para o evento do parceiro	O nome exclusivo ou ID de cada evento, conforme definido pelo parceiro. As configurações de mapeamento possíveis são: Campo de texto: obtenha o ID do evento correspondente no parceiro. Caixa suspensa: selecione o evento predefinido mais adequado. Sem alterações: envie os eventos como eles estiverem, sem mapeamento de nomes.
   para usuários de	Selecione a opção de envio para o evento: Todas as fontes de mídia, incluindo orgânicas: Envie postbacks para eventos atribuídos a qualquer parceiro, bem como eventos orgânicos.
   incluindo	Sem dados (padrão): Envie apenas o evento em si, sem qualquer valor de evento. Valores e receitas: envie todos os parâmetros de evento, incluindo o valor da receita (se existir no evento). Valores sem receita: envie todos os parâmetros exceto o valor de receita.

3. [Opcional] Clique no ícone Adicionar condição () para definir condições para um evento.
4. Clique em Salvar integração.
5. Envie o mapeamento do postback para o evento

Depois de configurar o mapeamento do evento in-app, envie ao seu desenvolvedor uma tabela onde cada evento mapeado corresponde a uma linha com as seguintes colunas:

• Evento AF: nome do evento da AppsFlyer.

• Mapeado para evento do Google: nome do evento no Google Analytics.

  Importante!

  Não use nenhum dos eventos reservados do Google como nomes para eventos personalizados do Google Analytics.

• Parâmetros do evento AF (OBRIGATÓRIO): Parâmetros de evento pré-definidos na AppsFlyer, que devem ser incluídos no postback enviado ao Google Analytics.

  Importante!

  É obrigatório incluir todos os parâmetros pré-definidos na AF dentro da definição do evento, exatamente como eles estão listados na tabela; caso contrário, o postback será rejeitado pelo Google Analytics.

Tabela de mapeamento de eventos

A tabela a seguir inclui todos os eventos do Google Analytics e seus parâmetros pré-definidos na AppsFlyer. Envie ao seu desenvolvedor uma tabela contendo apenas os eventos que você mapeou.

Nomes de eventos reservados - Google

Os seguintes nomes de eventos não podem ser usados como nomes de eventos personalizados:

• ad_activeview
• ad_click
• exposição_da_unidade_de_anúncio
• consulta_do_anúncio
• recompensa_do_anúncio
• exposição_do_anúncio
• limpar_dados_do_aplicativo
• exceção_do_aplicativo
• instalação_do_aplicativo
• remoção_do_aplicativo
• reembolso_da_loja_de_aplicativos
• app_update
• atualização_do_aplicativo
• abertura_do_aplicativo_por_link_dinâmico
• atualização_do_aplicativo_por_link_dinâmico
• primeira_abertura_por_link_dinâmico
• erro
• campanha_firebase
• ação_da_mensagem_no_aplicativo_firebase
• dispensar_mensagem_no_aplicativo_firebase
• impressão_da_mensagem_no_aplicativo_firebase
• primeira_abertura
• primeira_visita
• in_app_purchase
• dispensar_notificação
• notificação_em_primeiro_plano
• notification_open
• recebimento_de_notificação
• envio_de_notificação
• atualização_do_sistema_operacional
• início_da_sessão
• engajamento_do_usuario

O app instance ID identifica exclusivamente uma instalação específica de um aplicativo no Firebase. Esse valor precisa ser recuperado pelo SDK a partir do SDK do Firebase.

Seu desenvolvedor deve implementar o código para:

1. Coletar o campo app_instance_id do Firebase.
2. Chamar setAddiotionalData antes da primeira abertura para incluir o app instance ID em instalações, sessões e eventos no aplicativo.

FirebaseAnalytics.getInstance(this).appInstanceId.addOnCompleteListener { task ->
   if (task.isSuccessful) {
       AppsFlyerLib.getInstance().setAdditionalData("app_instance_id", task.result)
    }
}

FirebaseAnalytics.getInstance(this).getAppInstanceId().addOnCompleteListener(task -> {
       if (task.isSuccessful()) {
           AppsFlyerLib.getInstance().setAdditionalData("app_instance_id", task.getResult());
       }
  });

let appInstanceId = Analytics.appInstanceID()
    AppsFlyerLib.shared().customData = ["app_instance_id": appInstanceId]

(void) fetchAnalyticsInstanceId {
           NSString *instanceID = [FIRAnalytics appInstanceID];
           [[AppsFlyerLib shared] setAdditionalData:@{@"app_instance_id": instanceID}];
}

using Firebase. Analytics;
    public class AnalyticsManager : MonoBehaviour
    {
        private async void Start()
        {
           AppsFlyer.initSDK(devKey, appID, this);
           string appInstanceId = await FirebaseAnalytics. GetAnalyticsInstanceIdAsync();
           Dictionary <string, string> customData = new Dictionary<string, string>();
           customData. Add("app_instance_id", appInstanceId);
           AppsFlyer.setAdditionalData(appInstanceId);
           AppsFlyer.startSDK();
        }
}

O ga_session_id identifica exclusivamente uma sessão de um aplicativo no Firebase. Esse valor deve ser recuperado do SDK do Firebase e enviado para o GA4 usando a API setAdditionalData.

Seu desenvolvedor deve implementar o código para:

1. Coletar o campo ga_session_id do Firebase.
2. Chame setAdditionalData antes da primeira abertura do app para incluir o session ID.
3. Use a chave ga_session_id ao chamar a API.

FirebaseAnalytics.getInstance(this).sessionId.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        AppsFlyerLib.getInstance().setAdditionalData("ga_session_id", task.result)
    }
}

FirebaseAnalytics.getInstance(this).getSessionId().addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        AppsFlyerLib.getInstance().setAdditionalData("ga_session_id", task.getResult());
    }
});

if #available(iOS 14.0, *) {
    Analytics.sessionID { sessionID, error in
        if let sessionID = sessionID {
            AppsFlyerLib.shared().customData = ["ga_session_id": sessionID]
        }
    }
}

- (void)fetchAnalyticsSessionId {
    if (@available(iOS 14.0, *)) {
        [FIRAnalytics sessionIDWithCompletion:^(NSString * _Nullable sessionID, NSError * _Nullable error) {
            if (sessionID) {
                [[AppsFlyerLib shared] setAdditionalData:@{@"ga_session_id": sessionID}];
            }
        }];
    }
}

using Firebase. Analytics;
using System. Threading. Tasks;
using AppsFlyerSDK;
using UnityEngine;
using System. Collections. Generic;

public class AnalyticsManager : MonoBehaviour
{
    private async void Start()
    {
        AppsFlyer.initSDK("yourDevKey", "yourAppID", this);

        // Get session ID
        string sessionId = await FirebaseAnalytics. GetSessionIdAsync();

        Dictionary<string, string> customData = new Dictionary<string, string>();
        customData. Add("ga_session_id", sessionId);
        AppsFlyer.setAdditionalData(customData);

        AppsFlyer.startSDK();
    }
}

Certifique-se de que os eventos que você envia nos postbacks para o GA4 foram registrados e lidos pelo Google Analytics. Existem dois métodos que os anunciantes podem usar para visualizar seus dados:

• Usando GA4 Explorations, você pode explorar os dados de eventos brutos com todos os parâmetros associados. Pré-requisito: o Big Query export deve ser configurado em sua propriedade

• O relatório de eventos permite que os anunciantes vejam seus eventos de postback. O relatório pode ser encontrado em uma ou mais coleções de relatórios.
  
  Para mais informações sobre o relatório de eventos, consulte a documentação do Google. Por exemplo, os relatórios de eventos podem ser encontrados na coleção Life cycle ou Games reporting em Engagement > Events.

  

• O relatório de aquisição de tráfego ajuda a entender de onde vêm os visitantes do seu site e aplicativo.

  Na coleção Life cycle, vá para Acquisition > Traffic Acquisition).

  Para mais informações sobre o relatório de aquisição de tráfego, consulte a documentação do Google.