Google Analytics 4 Audiences

​

Voraussetzungen

• Die Anmeldedaten eines Service Accounts im JSON-Format. Bitte verwenden Sie ein Kompressionstool, um diese Datei mit einem Passwort zu sichern, und senden Sie das Paket dann getrennt von seinem Passwort.
• Die property ID Ihres Projekts.
• Den sitecode Ihres Kameleoon-Projekts.

​

Schritt 1: Authentifizierung uber einen Service Level Account einrichten

• Ein E-Mail-Konto mit Administratorzugriff auf Google Analytics, das zum Generieren eines Projekts und eines Service Accounts verwendet wird.
• Zugriff auf alle erforderlichen Audiences (in GA4) fur dieses Konto.

​

Ein Projekt in der Google Cloud Console erstellen

​

Geeignete APIs aktivieren

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

​

Service Level Account erstellen

​

Service Account Viewer-Berechtigungen fur Ihre Property gewahren

1. Melden Sie sich bei Ihrem GA4-Konto an.
2. Wahlen Sie die spezifische GA4-Property aus, die Sie verwalten mochten.
3. Greifen Sie auf die Admin-Einstellungen zu.
4. Suchen Sie nach der Option Property User Management oder Property Access Management.
5. Klicken Sie auf + > Add user.

6. Geben Sie im Feld Email addresses die E-Mail-Adresse ein, die mit dem Service Account verknupft ist, der Zugriff benotigt.
7. Wahlen Sie im Abschnitt Standard roles die Option Viewer.
8. Klicken Sie auf Add.

​

Schritt 2: Kameleoon-Visitorcodes in eine benutzerdefinierte GA4-Dimension einspielen

​

Verwendung von gtag.js

​

1. Den visitorCode an GA4 senden

      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. Die benutzerdefinierte Dimension in GA4 erstellen

​

Verwendung des Google Tag Managers

​

1. Den visitorCode in den dataLayer einspielen

 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. Die GTM-Variable hinzufugen

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

​

3. Einen Tag in GTM erstellen

1. Eine Variable erstellen

1. Zu GTM gehen: Offnen Sie Google Tag Manager und navigieren Sie zu Ihrem Container.
2. Zu Variables navigieren: Klicken Sie im linken Menu auf Variables.
3. Eine neue Variable erstellen: Klicken Sie unter User-Defined Variables auf New.
4. Variablentyp auswahlen: Klicken Sie auf Variable Configuration und wahlen Sie Data Layer Variable.
5. Die Variable konfigurieren:
   • Name: kameleoon_visitor_code
   • Variable type: Data Layer Variable
   • Data Layer Variable Name: Kameleoon Visitor Code
6. Speichern Sie die Variable.

2. Einen Trigger erstellen

1. Zu Triggers navigieren: Klicken Sie im linken Menu auf Triggers.
2. Einen neuen Trigger erstellen: Klicken Sie auf New.
3. Trigger-Typ auswahlen: Klicken Sie auf Trigger Configuration und wahlen Sie Custom Event.
4. Den Trigger konfigurieren:
   • Trigger name: Geben Sie Ihrem Trigger einen aussagekraftigen Namen (z. B. “Page Type is Product”).
   • Event name: Geben Sie den Namen des Ereignisses ein, auf dem der Trigger basieren soll, oder lassen Sie ihn leer, wenn der Trigger bei jedem Ereignis aktiviert werden soll.
   • This trigger fires on: Wahlen Sie Some Custom Events.
   • Conditions: Legen Sie die Bedingung fur Ihre dataLayer-Variable fest.

5. Den Trigger speichern: Klicken Sie auf Save.

3. Den Trigger an einen Tag anhangen

1. Zu Tags navigieren: Klicken Sie im linken Menu auf Tags.
2. Einen Tag erstellen oder bearbeiten: Erstellen Sie einen Tag oder bearbeiten Sie einen vorhandenen.
3. Den Trigger anhangen:
   • Scrollen Sie in der Tag-Konfiguration zum Abschnitt Triggering.
   • Klicken Sie auf Triggering und wahlen Sie den von Ihnen erstellten Trigger aus.
4. Den Tag speichern: Klicken Sie auf Save.

​

Schritt 3: Eine Custom Data erstellen, um Ihre GA4-Audiences in Kameleoon zu verwenden

 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;

​

Externe Segment-Synchronisierung fur die Server-Seite