Personyze Wiki Personyze Wiki docs
Deutsch
Open Personyze
Docs/ Content-Editor und Varianten/ Kampagnendaten als clientseitige Variablen
Content-Editor und Varianten

Kampagnendaten als clientseitige Variablen

Die globalen JavaScript-Variablen, über die eine gerenderte Personyze-Kampagne ihre Identität preisgibt, und wie Sie sie auslesen.

2 min read Updated 2 Stunden ago

Wenn eine Personyze-Kampagne auf der Seite gerendert wird, gibt sie ihre Identität über globale JavaScript-Variablen preis. Sie können sie auslesen, um Kampagnen- und Aktionskontext an Ihre Analytics-Plattform weiterzugeben, zu debuggen, welche Variante ein Nutzer sieht, oder eigene Logik auszulösen, wenn eine bestimmte Kampagne läuft.

Verfügbare Variablen

Variable Beschreibung
personyzeCampaign Name der Kampagne
personyzeAction Name der Aktion
personyzeActiongroup Name der Aktionsgruppe
personyzeCampaignId ID der Kampagne
personyzeActiongroupId ID der Aktionsgruppe
personyzeActionId ID der Aktion

Wann sie verfügbar werden

Die Variablen werden gesetzt, nachdem Personyze die Zielgruppen ausgewertet und die gewinnende Aktion gerendert hat. Wer sie beim ersten Laden der Seite ausliest — bevor Personyze fertig ist —, erhält undefined. Zwei zuverlässige Muster:

Auf den Personyze-Ready-Hook warten

(window.personyze = window.personyze || []).push(['ready', function() {
  console.log('Campaign:',   window.personyzeCampaign);
  console.log('Action:',     window.personyzeAction);
  console.log('Group:',      window.personyzeActiongroup);
  console.log('Campaign ID:', window.personyzeCampaignId);
  console.log('Action ID:',   window.personyzeActionId);
}]);

Oder nach einer kurzen Verzögerung prüfen

setTimeout(function() {
  if (window.personyzeCampaign) {
    // campaign rendered
  }
}, 500);

Häufige Anwendungsfälle

An Google Analytics oder GTM weitergeben

(window.personyze = window.personyze || []).push(['ready', function() {
  if (!window.personyzeCampaign) return;
  // GA4 example
  gtag('event', 'personyze_campaign_view', {
    campaign_name: window.personyzeCampaign,
    action_name:   window.personyzeAction,
    campaign_id:   window.personyzeCampaignId,
  });
}]);

Eigene Conversion-Zuordnung

// On purchase, record which Personyze campaign the user saw
function trackPurchase(orderId) {
  myAnalytics.send('purchase', {
    order_id:           orderId,
    personyze_campaign: window.personyzeCampaign || null,
    personyze_action:   window.personyzeAction || null,
  });
}

Debugging

Geben Sie in der Browserkonsole auf einer Seite, auf der eine Personyze-Kampagne laufen sollte, einen der Variablennamen ein. Leere/undefined Werte bedeuten, dass die Kampagne nicht gegriffen hat — prüfen Sie das Zielgruppen-Targeting im QA-Schritt des Assistenten.

Mehrere Kampagnen auf einer Seite.Wenn mehrere Personyze-Kampagnen gleichzeitig rendern, spiegeln die globalen Variablen die zuletzt aufgelöste wider. Für die Zuordnung pro Kampagne in einem Setup mit mehreren Kampagnen nutzen Sie den Callback ready , um die Daten jeder Kampagne beim Auslösen zu erfassen, statt die globalen Variablen später auszulesen.
Did this page answer your question?
Thank you — that goes to whoever maintains this page.