Requisito previo: Antes de configurar la integración, asegúrate de ponerte en contacto con el partner y abrir una cuenta con él.

Para configurar una nueva integración:

1. En AppsFlyer, ve a la pestaña Collaborate > Partner Integrations > Marketplace .
   (Para editar una integración existente: Ve a la pestaña Collaborate > Partner Integrations > Active integrations .)
2. Selecciona la aplicación correspondiente.
3. Busca Google Analytics (GA4) y selecciona Integrar.
4. En la pestaña Integración, activa el selector Activar partner. 
   Nota: El selector debe permanecer activado (activo) mientras trabajes con Google Analytics (GA4). Saber más
5. Completa la configuración utilizando las pestañas pertinentes, como se describe a continuación.

La configuración de Google Analytics solo incluye la pestaña Integración.

Para ver una descripción detallada del encabezado de la ventana de configuración del partner, haz clic aquí.

Configura los siguientes ajustes:

1. En la pestaña Integración, selecciona la aplicación para la integración y activa Activar partner.

   Nota: El selector debe estar (activado) mientras trabajes con el partner.

   Para obtener más detalles sobre la activación del partner, haz clic aquí.

2. En ID de la aplicación de Firebase, introduce el identificador de la aplicación de Firebase. Para saber cómo localizar el ID de la aplicación de Firebase, consulta la documentación de Firebase.
3. En API Secret, introduce la API Secret que se usa para autenticar los postbacks a Google Analytics. Una API Secret se genera a través de la interfaz de usuario de Google Analytics. Para ver, editar o crear un secreto, sigue las instrucciones de la documentación de Google. Cuando se te indique seleccionar un flujo de datos web, elige un flujo de datos de Android o iOS en su lugar.
4. Activa Customer User ID para enviar el ID de usuario del cliente (CUID) en lugar del ID de publicidad (IDFA).
5. En la sección Postbacks predeterminados, en para usuarios de, selecciona Todas las fuentes de medios, incluido orgánico.

AppsFlyer puede enviar postbacks automáticos a GA4 después de las instalaciones de usuarios, incluidas tanto las instalaciones como los re-engagements (incluidas las reatribuciones). Los re-engagements se producen cuando un usuario que ya tiene la aplicación instalada la abre después de hacer clic en un enlace de campaña. Saber más sobre los postbacks predeterminados.

En la pestaña Integración, mapea los eventos in-app de AppsFlyer a los eventos de Google Analytics (GA4), enviados a través de postbacks.

1. Activa los postbacks de eventos in-app.

2. Haz clic en Agregar evento para añadir un evento del SDK a la lista. En la siguiente tabla se describen los campos que debes completar:

   Nombre del parámetro	Description
   Evento de AppsFlyer	El nombre del evento, tal como se recibe desde el SDK de AppsFlyer integrado en tu app. Consejo: ¿No ves el evento que estás buscando? Asegúrate de activar el evento en un dispositivo con una instalación no orgánica y vuelve a verificar. Escríbelo en Evento de AppsFlyer y, a continuación, haz clic en Crear personalizado. Leer más sobre la asignación personalizada de eventos.
   Asignado al evento de socio	El nombre o ID único de cada evento, definido por el partner. Existen varias configuraciones de asignación: Campo de texto: Obtén el ID del evento correspondiente del partner. Cuadro desplegable: selecciona el evento de AppsFlyer predefinido más adecuado. Tal como está: envía los eventos tal como están, sin asignación de nombres.
   Para usuarios de	Seleccione la opción de envío para el evento: Todas las fuentes de medios, incluidas las orgánicas: envía postbacks de eventos atribuidos a cualquier partner, así como eventos orgánicos.
   incluye	Sin datos (predeterminado): envía solo el evento en sí, sin ningún valor del evento. Valores e ingresos: envía todos los parámetros del evento, incluido el valor de ingresos (si existe en el evento). Valores sin ingresos: envía todos los parámetros, excluyendo el valor de ingresos.

3. [Opcional] Haz clic en el icono Agregar condición () para establecer condiciones para un evento.
4. Haz clic en Guardar integración.
5. Enviar el mapeo de postback de eventos

Después de haber configurado el mapeo de eventos in-app, envía a tu desarrollador una tabla donde cada evento mapeado corresponda a una fila con las siguientes columnas:

• Evento de AF: Nombre del evento de AppsFlyer.
• Asignado al evento de Google: Nombre del evento en Google Analytics.

• Parámetros del evento de AF (OBLIGATORIOS): Parámetros de evento de AppsFlyer predefinidos que deben incluirse en el postback de evento enviado a Google Analytics.

La tabla de mapeo de eventos

La siguiente tabla incluye todos los eventos de Google Analytics y sus parámetros predefinidos de AppsFlyer. Envía a tu desarrollador una tabla que contenga solo los eventos que has mapeado.

Nombres reservados de eventos de Google

Los siguientes nombres de eventos están reservados y no se pueden usar como nombres de eventos personalizados:

• ad_activeview
• ad_click
• ad_exposure
• ad_query
• ad_reward
• adunit_exposure
• app_clear_data
• excepción_de_la_aplicación
• instalación_de_la_aplicación
• eliminación_de_la_aplicación
• reembolso_de_la_tienda_de_aplicaciones
• app_update
• actualización_de_la_aplicación
• apertura_de_la_aplicación_mediante_enlace_dinámico
• actualización_de_la_aplicación_mediante_enlace_dinámico
• primera_apertura_mediante_enlace_dinámico
• error
• campaña_de_firebase
• acción_del_mensaje_in-app_de_firebase
• cierre_del_mensaje_in-app_de_firebase
• impresión_del_mensaje_in-app_de_firebase
• primera_apertura
• primera_visita
• in_app_purchase
• descarte_de_notificación
• notificación_en_primer_plano
• notification_open
• recepción_de_notificación
• envío_de_notificación
• actualización_del_sistema_operativo
• inicio_de_sesión
• engagement_del_usuario

El app_instance_id identifica de forma única una instalación de la app de Firebase, y el ga_session_id identifica de forma única una sesión de la app de Firebase. Recupera estos valores desde el SDK de Firebase y, después, envíalos a GA4 con la API setAdditionalData.

Deja que tu desarrollador implemente el código para:

1. Recopila de Firebase los campos app_instance_id y ga_session_id.
2. Llama a setAdditionalData antes del primer inicio para incluir el ID de instancia de la aplicación y ga_session_id en instalaciones, sesiones y eventos in-app.

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();
        }
}

El ga_session_id identifica de forma única una sesión de una aplicación de Firebase. Este valor debe recuperarse del SDK de Firebase y enviarse a GA4 mediante la API setAdditionalData.

Deja que tu desarrollador implemente el código para:

1. Recoge el campo ga_session_id de Firebase.
2. Llama a setAdditionalData antes del primer inicio para incluir el ID de sesión (y app_instance_id, si se usa).
3. Usa la clave ga_session_id al llamar a la 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();
    }
}

Asegúrate de que los eventos en los postbacks que envías a GA4 estén registrados y leídos por Google Analytics. Hay dos métodos que los anunciantes pueden usar para ver sus datos:

• Usando Exploraciones de GA4, puedes explorar los datos de eventos en bruto con todos los parámetros asociados. Requisito previo: La exportación de BigQuery debe estar configurada en tu propiedad)

• El reporte de eventos permite a los anunciantes ver sus eventos de postback. El reporte se puede encontrar en una o más colecciones de reportes.
  Por ejemplo, los reportes de eventos se pueden encontrar en las colecciones Ciclo de vida o Reportes de juegos, en engagement > Eventos. 
  Para más información sobre el reporte de eventos, consulta la documentación de Google.

  

• El reporte de adquisición de tráfico te ayuda a entender de dónde provienen los visitantes de tu sitio web y aplicación.

  En la colección Ciclo de vida, ve a Adquisición > Adquisición de tráfico).

  Para más información sobre el reporte de adquisición de tráfico, consulta la documentación de Google.