Integración con Google Analytics (GA4)

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

Para activar o editar la integración:

1. Para activar: En AppsFlyer, desde el menú lateral, selecciona Colaborar > Partner Marketplace. Para editar: En AppsFlyer, desde el menú lateral, selecciona Colaborar > Integraciones Activas.
2. Busca Google Analytics (GA4) y selecciónalo.
3. Haz clic en Configurar integración. Se te dirigirá a la página de configuración de la integració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 de Integración selecciona la aplicación para la integración y haz clic en Activar partner

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

   Para más detalles sobre la activación de partners, haz clic aquí.

2. En ID de la aplicación de Firebase ingresa el identificador de la aplicación de Firebase. Para aprender cómo localizar el ID de la aplicación de Firebase, consulta la documentación de Firebase.
3. En API Secret ingresa la API Secret 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 en 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 el ID de usuario del cliente 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, incluyendo orgánico.

   Nota

   El postback de instalación incluye solo los detalles del punto de contacto (fuente de medios, nombre de campaña e ID de campaña).

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 postbacks de eventos in-app.

2. Haz clic en Agregar evento para agregar un evento de SDK o de servidor a servidor a la lista. La siguiente tabla describe los campos que debes completar:

   Nombre de parámetro	Descripción
   Evento de AppsFlyer	El nombre del evento, tal como lo recibió AppsFlyer, ya sea del SDK integrado en tu aplicación o de los eventos servidor a servidor. Consejo: ¿No encuentras 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 luego haz clic en Crear personalizado. Saber más sobre la asignación de eventos personalizados.
   Asignado al evento de partner	El ID o nombre único de cada evento, tal y como lo defina 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	Selecciona la opción de envío para el evento: Todas las fuentes de medios, incluidas las orgánicas: Envía postbacks para eventos atribuidos a cualquier partner, así como eventos orgánicos.
   incluyendo	Sin datos (por defecto): Envía solo el evento en sí sin ningún valor de evento. Valores e ingresos: Envía todos los parámetros del evento, incluyendo el valor de los ingresos (si existe en el evento). Valores sin ingresos: Envía todos los parámetros excluyendo el valor de los ingresos.

3. [Opcional] Haz clic en el ícono Añadir 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 AF: Nombre del evento de AppsFlyer.

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

   ¡Importante!

  No utilices ninguno de los eventos reservados de Google como nombres para eventos personalizados de Google Analytics.

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

   ¡Importante!

  Es obligatorio incluir todos los parámetros de evento AF predefinidos dentro de la definición del evento exactamente como se enumeran en la tabla; no hacerlo resultará en que Google Analytics rechace el postback.

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
• app_exception
• app_install
• app_remove
• app_store_refund
• app_update
• app_upgrade
• dynamic_link_app_open
• dynamic_link_app_update
• dynamic_link_first_open
• error
• firebase_campaign
• firebase_in_app_message_action
• firebase_in_app_message_dismiss
• firebase_in_app_message_impression
• first_open
• first_visit
• in_app_purchase
• notification_dismiss
• notification_foreground
• notification_open
• notification_receive
• notification_send
• os_update
• session_start
• user_engagement

El ID de instancia de la aplicación identifica de manera única una instalación específica de una aplicación de Firebase. Este valor debe ser recuperado por el SDK del SDK de Firebase.

Deja que tu desarrollador implemente el código para:

1. Recoger el campo app_instance_id de Firebase.
2. Llama a setAddiotionalData, antes de la primera apertura, para incluir el ID de instancia de la aplicación 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();
        }
}

ga_session_id identifica de manera única una sesión de una aplicación de Firebase. Este valor debe ser recuperado del SDK de Firebase y enviado a GA4 utilizando la API setAdditionalData.

Deja que tu desarrollador implemente el código para:

1. Recoger el campo ga_session_id de Firebase.
2. Llama a setAdditionalData antes de la primera apertura para incluir el ID de sesión.
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 Big Query 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 la colección Ciclo de vida o en la colección Reportes de juegos bajo 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.

  Bajo 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.