Personyze Wiki Personyze Wiki docs
Deutsch
Open Personyze
Docs/ Erste Schritte/ Personyze über Google Tag Manager installieren
Erste Schritte

Personyze über Google Tag Manager installieren

Den Tracking-Tag per GTM laden, den GA4-dataLayer für E-Commerce wiederverwenden, Profilattribute schreiben und den Consent Mode berücksichtigen.

5 min read Updated 51 Minuten ago

Wenn Ihre Website bereits Google Tag Manager nutzt, ist GTM der sauberste Ort, um den Personyze-Tracking-Tag zu laden — ohne Vorlagenbearbeitung, mit Bereitstellung und Rollback über die GTM-Versionierung, ohne Entwickler-Deployment. Die Tag-Vorlage Personyze Tracking kann mehr als den Tag installieren: Sie kann Ihren bestehenden GA4-E-Commerce-dataLayer in Personyze-Produktinteraktionen übersetzen, bestimmte Interaktionen melden, Attribute des Besucherprofils aus GTM-Variablen schreiben und den Google Consent Mode berücksichtigen.

Voraussetzungen

  • Ein auf Ihrer Website installierter GTM-Container.
  • Ihre Personyze-Kontonummer — im Panel angezeigt (es ist die Zahl in Ihrer Panel-URL, z. B. /panel2/id/8110/, sowie unter Einstellungen → Site profile).
  • Die Vorlage Personyze Tracking — suchen Sie in der Galerie der Tag-Vorlagen von GTM nach „Personyze“.

Grundinstallation

  1. In Ihrem GTM-Arbeitsbereich: Tags → New, klicken Sie auf den Bereich für die Tag-Konfiguration und wählen Sie Personyze Tracking.
  2. Account Number — Ihre Personyze-Kontonummer.
  3. For use on domains — eine durch Leerzeichen getrennte Liste der zu trackenden Domains, etwa example.com shop.example.com.
  4. Trigger: All Pages (Page View). Lösen Sie Personyze so früh wie möglich aus — je früher, desto mehr Zeit bleibt, den Besucher zu identifizieren, Zielgruppen aufzulösen und die Personalisierung zu rendern, bevor er zu scrollen beginnt; ein spätes Auslösen zeigt kurz die ursprünglichen Inhalte.
  5. Veröffentlichen Sie per Submit eine neue GTM-Version.
Konfiguration des Tags Personyze Tracking
Die Konfiguration des Tags: Konto und Domains, dann die vier optionalen Gruppen. Zum Vergrößern klicken.

E-Commerce-Tracking — Ihren GA4-dataLayer wiederverwenden

Setzen Sie ein Häkchen bei Track ecommerce events from the dataLayer automatically, und der Tag übersetzt die standardmäßigen GA4-E-Commerce-Pushes — view_item, add_to_cart, remove_from_cart, add_to_wishlist, purchase — in Personyze-Produktinteraktionen. Wenn Ihre Website bereits E-Commerce an GA4 meldet, ersetzt dies jede separate Einrichtung von Interaktionen.

  • Einrichtung des Triggers: Hängen Sie den Tag an einen Trigger vom Typ Custom Event mit aktiviertem Use regex matching und dem Ereignisnamen
    view_item|add_to_cart|remove_from_cart|add_to_wishlist|purchase
    — zusätzlich zum Trigger All Pages (oder stattdessen).
  • Match products by — welcher Spalte Ihres Personyze-Produktkatalogs die gemeldeten IDs entsprechen: Internal ID oder SKU. Die IDs in Ihrem dataLayer müssen im Katalog existieren, sonst werden die Interaktionen keinen Produkten zugeordnet.

Eine bestimmte Interaktion senden

Das Dropdown Interaction sendet bei jedem Auslösen des Tags eine Personyze-Interaktion (zusätzlich zur Installation des Tracking-Codes). Befüllen Sie seine Felder mit GTM-Variablen (z. B. {{Ecommerce item id}}):

  • Product Viewed / Added to cart / Removed from cart / Purchased / Liked (wishlist) — nimmt die Product ID und, wo relevant, die Quantity an.
  • Order completed — alle Artikel im Warenkorb gekauft.
  • Article Viewed — nimmt die Article ID an, für Content-Empfehlungen.
  • Category viewed — erfasst das Interesse des Besuchers; ein oder mehrere Kategorienamen, durch Kommas getrennt.
  • SPA route change — führt das Targeting bei einer Navigation in einer Single-Page-App erneut aus. Hängen Sie diese Interaktion an einen Trigger vom Typ History Change.
Single-Page-Applications Belassen Sie den Basis-Tracking-Tag nur auf einem Page-View-Trigger — Personyze erkennt Routenwechsel in SPAs intern (siehe Single-Page-Applications). Wenn GTM das erneute Targeting ausdrücklich steuern soll, fügen Sie einen zweiten Personyze-Tracking-Tag mit Interaction = SPA route change auf einem History-Change-Trigger hinzu — das ist der einzige Ort, an den History Change gehört.

Attribute des Besucherprofils

Setzen Sie ein Häkchen bei Send visitor profile attributes, um Werte in das Personyze-Profil des Besuchers zu schreiben — dort sind sie in jeder Targeting-Regel, jeder dynamischen Content-Variablen und jedem Bericht nutzbar. Klicken Sie auf Add attribute, wählen Sie das Feld und geben Sie den Wert als GTM-Variable an.

Verfügbare Felder: Email, First/Last name, Phone, Mobile phone, Gender, Birthday, Postal code, City, State, Country, Occupation, Industry, Website, Interests, Subscription type, Lead score, Sale state, Account type, Account balance, Account ID number, Opted in (email, sms) — dazu allgemeine Plätze: Custom text 1–6, Custom integer 1–4, Custom float 1–2, Custom date 1–2.

Consent Mode

Setzen Sie ein Häkchen bei Respect Google Consent Mode (analytics_storage), und der Personyze-Tracker wird nicht geladen — und es werden keine Cookies gesetzt —, bis die Einwilligung für analytics_storage erteilt ist. Erteilt der Besucher die Einwilligung später auf derselben Seite, lädt der Tracker in diesem Moment. Kombinieren Sie das mit der standardmäßigen Consent-Mode-Integration Ihrer CMP; weitere Verknüpfungen sind nicht nötig.

Nutzen Sie ein Caching- oder Speed-Plugin? Schließen Sie Personyze davon aus, sonst erscheint die Personalisierung erst, wenn der Besucher mit der Seite interagiert. Was ausgeschlossen werden muss, und der Test in einer Zeile.

Prüfen, ob der Tag ausgelöst wird

  1. Klicken Sie in GTM auf Preview — Tag Assistant öffnet sich mit Ihrer Website. Personyze Tracking sollte unter „Tags Fired“ erscheinen.
  2. Entwicklertools → Netzwerk → filtern nach counter.personyze.com — bei jedem Seitenaufruf sollte eine Anfrage ausgelöst werden.
  3. Im Panel erscheint der Besuch innerhalb von Sekunden unter Live-Besuche; mit aktiviertem E-Commerce-Tracking erscheinen Produktereignisse im Schritt „Interaktionen“ der Kampagne.

Häufige Probleme

  • Der Tag wird ausgelöst, aber in Personyze kommen keine Ereignisse an — meist eine falsche Kontonummer, oder die aktuelle Domain fehlt unter For use on domains.
  • Die Personalisierung wird nicht dargestellt oder flackert — der Tag wird zu spät ausgelöst; lösen Sie ihn bei Page View und vor störenden Tags aus.
  • E-Commerce-Interaktionen werden keinen Produkten zugeordnet — die Artikel-IDs im dataLayer passen nicht zur unter Match products by gewählten Katalogspalte.
  • SPA-Seiten werden doppelt getrackt — der Basis-Tag liegt auf einem History-Change-Trigger; verschieben Sie ihn auf Page View und nutzen Sie stattdessen die Interaktion SPA route change.

Verwandte Artikel

Did this page answer your question?
Thank you — that goes to whoever maintains this page.