Google Analytics 4 — Streaming de eventos

​

Ventajas clave

• Información precisa sobre el comportamiento: La integración envía eventos específicos a herramientas de terceros para los visitantes expuestos a experimentos web y feature flags en proyectos basados en SDK. Este seguimiento detallado proporciona una visión clara de cómo las diferentes variaciones afectan a las acciones del usuario. Por ejemplo, puede observar qué variación genera más clics, conversiones u otros resultados deseados, ayudándole a determinar el enfoque más eficaz.
• Toma de decisiones en tiempo real: La integración proporciona datos en tiempo real. Con esta información actualizada, puede ajustar rápidamente las estrategias si una variación no está funcionando como se esperaba o asignar recursos para aprovechar las variaciones exitosas.
• Configuración sencilla: Habilite las integraciones de terceros en la aplicación de Kameleoon sin necesidad de código personalizado o cambios en el SDK.

​

Consideraciones

​

Requisitos previos

• SDK de Kameleoon: Un SDK debe estar instalado en su proyecto del lado del servidor.
• API secret: El secreto de API generado en Google Analytics, documentado en la referencia de Google Analytics 4.
• Measurement ID: Para SDKs web, el identificador de un Data Stream, como se documenta en la referencia de Google Analytics 4.
• Firebase app ID: Para SDKs móviles, el identificador de una aplicación Firebase, como se documenta en la referencia de Google Analytics 4 para Firebase.

​

Elegir el identificador GA4 correcto

• Para proyectos basados en web (sitios web que utilizan gtag.js): Cree un dato personalizado llamado ga4_client_id y recupere el client_id de GA4 (normalmente almacenado en la cookie _ga).
• Para aplicaciones móviles basadas en Firebase: Cree un dato personalizado llamado ga4_app_instance_id y recupere el app_instance_id del SDK de Firebase.

​

Configuración

​

Para experimentos web

​

Identificar el client ID de GA4

​

Configurar el dato personalizado

• Name: ga4_client_id
• Projects: Seleccione su proyecto.
• Retrieval method: Kameleoon Activation API.
• Type: Single
• Format: String
• Scope: Visit

​

Añadir código en el Global custom script

if(!Kameleoon.API.CurrentVisit.customData["ga4_client_id"]){

// First, create a ga4ClientId variable and obtain your GA4 client ID.
let gaClientId = null;

const getClientId = () =>{
    gtag('get', 'G-XXXXXXXXXX', 'client_id', function(clientId) {
        gaClientId = clientId;
    });
    return gaClientId !== null
}

Kameleoon.API.Core.runWhenConditionTrue(
    () => getClientId(),
    () =>{
        // Then set your Kameleoon "ga4_client_id" custom data to this value using Kameleoon's Activation API
        Kameleoon.API.Data.setCustomData("ga4_client_id", gaClientId);
    },
    200
)

}

​

Activar la integración para sus campañas

​

Para experimentos de funcionalidades

1. Haga clic en Edit en el feature flag que desea seguir.
2. Haga clic en Integrations en la sección Reporting. Aparecen todas las integraciones que ha activado.
3. Active Google Analytics 4 en Delivery rules, Feature experiments o en ambos.

​

Para móvil

1. Obtenga el Firebase app instance ID de GA4.
2. Configure un dato personalizado.
   • Name: ga4_app_instance_id
   • Projects: Seleccione su proyecto.
   • Retrieval method: Kameleoon SDK method.
   • Type: Single
   • Format: String
   • Scope: Visit

​

Ejemplo en Java utilizando el SDK de Android de Kameleoon

• Un identificador único para la instancia de aplicación Firebase, solo para configuración SDK, llamado app_instance_id.
• Un identificador único para el cliente, solo para configuración web, llamado client_id.
• Tiempo de exposición.
• Un identificador único para el experimento y la variación que sigue el formato KAM-XXXX-YYYY, donde XXXX es el ID del experimento de Kameleoon y YYYY es el ID de la variación.

​

Ejemplo de payload de evento

{
  "events": [
    {
      "name": "experience_impression",
      "exp_variant_string": "KAM-1234-5567",
      "timestamp_micros": 1718201234000
    },
    {
      "name": "experience_impression",
      "exp_variant_string": "KAM-5678-6978",
      "timestamp_micros": 1718201267000
    }
  ],
  "app_instance_id": "example-instance-id"
}

Identificar usuarios

• Móvil: app_instance_id (estándar para las aplicaciones móviles GA4)
• Web: client_id (el equivalente de app_instance_id para clientes web)

Enriquecer eventos