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.
ready , um die Daten jeder Kampagne beim Auslösen zu erfassen, statt die globalen Variablen später auszulesen.