Lorsqu’une campagne Personyze s’affiche sur la page, elle expose son identité via des variables JavaScript globales. Vous pouvez les lire pour transmettre le contexte de la campagne et de l’action à votre plateforme d’analyse, déboguer la variation que voit un utilisateur, ou déclencher une logique personnalisée quand une campagne précise s’exécute.
Variables disponibles
| Variable | Description |
|---|---|
personyzeCampaign |
Nom de la campagne |
personyzeAction |
Nom de l’action |
personyzeActiongroup |
Nom du groupe d’actions |
personyzeCampaignId |
ID de la campagne |
personyzeActiongroupId |
ID du groupe d’actions |
personyzeActionId |
ID de l’action |
Quand elles deviennent disponibles
Les variables sont définies une fois que Personyze a fini d’évaluer les audiences et d’afficher l’action gagnante. Les lire au chargement initial de la page — avant que Personyze ait terminé — renvoie undefined. Deux méthodes fiables :
Attendre le hook ready de Personyze
(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);
}]);
Ou vérifier après un court délai
setTimeout(function() {
if (window.personyzeCampaign) {
// campaign rendered
}
}, 500);
Cas d’usage courants
Transmettre à Google Analytics ou GTM
(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,
});
}]);
Attribution de conversion personnalisée
// 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,
});
}
Débogage
Dans la console du navigateur, sur n’importe quelle page où une campagne Personyze devrait tourner, tapez l’un des noms de variables. Des valeurs vides ou undefined signifient que la campagne n’a pas correspondu — vérifiez le ciblage de l’audience à l’étape QA de l’assistant.
ready pour capturer les données de chaque campagne au moment où elle se déclenche, plutôt que de lire les variables globales plus tard.