Google Analytics 4 Audiences

​

Requisitos previos

• Las credenciales de una cuenta de servicio en formato JSON. Utilice una herramienta de compresión para proteger este archivo con una contraseña y luego envíe el paquete por separado de su contraseña.
• El property ID de su proyecto.
• El sitecode de su proyecto de Kameleoon.

​

Paso 1: Configurar la autenticación a través de una cuenta de servicio

• Una cuenta de correo electrónico con acceso de administrador a Google Analytics que se utilizará para generar un proyecto y una cuenta de servicio.
• Acceso a todas las audiencias requeridas (en GA4) para esta cuenta.

​

Crear un proyecto en Google Cloud Console

​

Activar las APIs apropiadas

• Google Analytics Reporting API
• Google Analytics Data API
• Google Analytics API

​

Crear una cuenta de servicio

​

Otorgar permisos de Viewer de cuenta de servicio para su propiedad

1. Inicie sesión en su cuenta de GA4.
2. Seleccione la propiedad GA4 específica que quiere gestionar.
3. Acceda a la configuración de administrador.
4. Busque la opción Property User Management o Property Access Management.
5. Haga clic en + > Add user.

6. En el campo Email addresses, introduzca la dirección de correo electrónico asociada a la cuenta de servicio que requiere acceso.
7. En la sección Standard roles, seleccione Viewer.
8. Haga clic en Add.

​

Paso 2: Enviar los visitorcodes de Kameleoon en una dimensión personalizada de GA4

​

Utilizando gtag.js

​

1. Enviar el visitorCode a GA4

      if (Kameleoon.API.CurrentVisit.pageViews === 1) {
    Kameleoon.API.Core.runWhenConditionTrue(
      function () {
        return typeof window.google_tag_data !== "undefined";
      },
      function () {
        gtag.push({ 'event': 'Kameleoon Visitor Code', 'kameleoon_visitor_code': Kameleoon.API.Visitor.code });
      },
      500
    );
  }

​

2. Crear la dimensión personalizada en GA4

​

Utilizando Google Tag Manager

​

1. Enviar el visitorCode al dataLayer

 if (Kameleoon.API.CurrentVisit.pageViews === 1) {
   Kameleoon.API.Core.runWhenConditionTrue(
     function () {
       return typeof window.google_tag_manager !== "undefined";
     },
     function () {
       dataLayer.push({ 'event': 'Kameleoon Visitor Code', 'kameleoon_visitor_code': Kameleoon.API.Visitor.code });
     },
     500
   );
 }

​

2. Añadir la variable de GTM

• Name: kameleoon_visitor_code
• Variable configuration:
  • Type: Data Layer Variable
  • Data Layer Variable Name: Kameleoon Visitor Code

​

3. Crear un tag en GTM

1. Crear una variable

1. Ir a GTM: Abra Google Tag Manager y vaya a su contenedor.
2. Ir a Variables: En el menú de la izquierda, haga clic en Variables.
3. Crear una nueva variable: En User-Defined Variables, haga clic en New.
4. Seleccionar tipo de variable: Haga clic en Variable Configuration y elija Data Layer Variable.
5. Configurar la variable:
   • Name: kameleoon_visitor_code
   • Variable type: Data Layer Variable
   • Data Layer Variable Name: Kameleoon Visitor Code
6. Guarde la variable.

2. Crear un trigger

1. Ir a Triggers: En el menú de la izquierda, haga clic en Triggers.
2. Crear un nuevo trigger: Haga clic en New.
3. Seleccionar tipo de trigger: Haga clic en Trigger Configuration y elija Custom Event.
4. Configurar el trigger:
   • Trigger name: Asigne un nombre descriptivo a su trigger (por ejemplo, “Page Type is Product”).
   • Event name: Introduzca el nombre del evento en el que quiere basar el trigger, o déjelo vacío si desea que el trigger se active en cualquier evento.
   • This trigger fires on: Elija Some Custom Events.
   • Conditions: Establezca la condición para su variable dataLayer.

5. Guardar el trigger: Haga clic en Save.

3. Adjuntar el trigger a un tag

1. Ir a Tags: En el menú de la izquierda, haga clic en Tags.
2. Crear o editar un tag: Cree un tag o edite uno existente.
3. Adjuntar el trigger:
   • En la configuración del tag, desplácese hasta la sección Triggering.
   • Haga clic en Triggering y seleccione el trigger que creó.
4. Guardar el tag: Haga clic en Save.

​

Paso 3: Crear un dato personalizado para utilizar sus audiencias de GA4 en Kameleoon

 Kameleoon.API.Data.retrieveDataFromRemoteSource(Kameleoon.API.Visitor.code, function(data) {
     for (const [key, value] of Object.entries(data)) {
         Kameleoon.API.Data.setCustomData('GA4 Audiences',key)
     }
 });
 return { "value": null} 

var xhr = new XMLHttpRequest();

xhr.open(
  "GET",
    "https://integrations.kameleoon.com/ga4-audience?sitecode=[SITECODE]&web_property=[WEB_PROPERTY]",
  false
);

var GA4Audiences = [];

xhr.onreadystatechange = function () {
  if (this.readyState === XMLHttpRequest.DONE && this.status === 200) {
    var audiences = JSON.parse(xhr.response);

    audiences.map(function (audience) {
      if (audience) {
        GA4Audiences.push({ value: audience, label: audience });
      }
    });
  }
};

xhr.send();

return GA4Audiences;

​

External segment sync para servidor