En plus des méthodes et des structures de données fournies par l’Activation API, le moteur JavaScript déclenche des événements DOM personnalisés. Ces événements constituent d’excellents points d’entrée pour personnaliser le comportement de Kameleoon et étendre la plateforme. Par exemple, écoutez l’événement Kameleoon::ExperimentTriggered pour recevoir une notification lorsqu’une expérience se déclenche.
La liste suivante détaille les événements actuellement implémentés. Si l’Activation API actuelle ne dispose pas d’un événement requis, contactez le support technique pour demander une amélioration. De nouveaux événements peuvent être ajoutés pour répondre à des exigences spécifiques.
Comme il n’y a qu’un seul thread d’exécution dans un environnement JavaScript, les événements déclenchés dans un bloc d’exécution synchrone continu sont reçus simultanément. Les écouteurs de rappel s’exécutent après la fin complète du bloc de code Kameleoon, plutôt qu’au moment exact où le code déclenche l’événement. Par exemple, Kameleoon::Loaded et Kameleoon::Started peuvent être reçus simultanément si le chargement du stockage local est implémenté de manière synchrone (cas typique, sauf dans une configuration multi-domaines lorsque l’URL actuelle ne se trouve pas sur le domaine principal). Kameleoon::Started et Kameleoon::ExperimentTriggered sont également simultanés pour les expériences dont le ciblage peut être évalué immédiatement.
Liste des événements
Kameleoon::Loaded
window.addEventListener('Kameleoon::Loaded', function (event) {
var loadTime = event.detail.loadTime;
var timeout = event.detail.timeout;
});
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| loadTime | Number | Heure du chargement complet du fichier d’application Kameleoon (format UTC - ms depuis le 1er janvier 1970). |
| timeout | Boolean | true si un timeout s’est produit pendant le chargement (asynchrone) du fichier d’application Kameleoon. |
Kameleoon::Aborted
window.addEventListener('Kameleoon::Aborted', function (event) {
var reason = event.detail.reason;
});
- BROWSER : Le navigateur n’est pas pris en charge.
- PRERENDER : Il s’agit d’une requête de prérendu (par exemple, optimisation Chrome), et non d’une page web consultée par un humain. Kameleoon ne s’exécute pas pour éviter de fausses statistiques.
- STORAGE : Les prérequis techniques pour un fonctionnement normal, tels que les écritures dans le stockage local, ne peuvent pas être satisfaits.
- TIMEOUT : Le temps de chargement du fichier a dépassé la durée autorisée, et la configuration nécessite un abandon.
- DISABLED : Kameleoon a été désactivé via l’application back-office. Tous les chargements front-end Kameleoon sont immédiatement abandonnés lorsque ce statut est actif.
- PARAMETER : Un paramètre spécial dans l’URL (par exemple,
kameleoonDisabled=true) provoque l’arrêt de l’exécution du moteur à des fins de débogage ou de vérification.
- SCRIPT : Un script d’abandon personnalisé a retourné true pour le chargement actuel.
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| reason | String | Raison / cause de l’abandon. |
Kameleoon::Started
window.addEventListener('Kameleoon::Started', function (event) {
var newVisitor = event.detail.newVisitorCode;
});
Kameleoon.API est lisible, bien que certaines données (telles que les données de géolocalisation obtenues via des appels asynchrones ultérieurs) puissent ne pas être disponibles. Les données de l’événement indiquent si l’initialisation a généré un nouveau visitorCode.
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| newVisitorCode | Boolean | true si un nouveau visitorCode (aléatoire) a été généré pour ce visiteur (visiteur inconnu / nouveau pour Kameleoon), sinon false. |
Kameleoon::DataGathered
window.addEventListener('Kameleoon::DataGathered', function (event) {
// At this point, we're guaranteed that the object will be present and correct.
var currentLocation = Kameleoon.API.CurrentVisit.geolocation;
});
window.addEventListener('Kameleoon::RemoteSynchronizationPerformed', function (event) {
var allVisits = event.detail.visits;
});
Kameleoon.API.Data.performRemoteSynchronization(). Cela se produit lors de la réconciliation de l’historique entre appareils, de la prévention du suivi intelligent ou des mises à jour de données personnalisées.
En savoir plus sur les SSC ici.
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| visits | Array | Liste des objets Visit correspondant à ce visiteur, retournés par la Data API. |
| currentVisitOnly | Boolean | true si Kameleoon.API.Data.performRemoteSynchronization() a été appelé avec l’argument currentVisitOnly défini sur true, sinon false. |
Kameleoon::LegalConsentUpdated
window.addEventListener('Kameleoon::LegalConsentUpdated', function (event) {
var legalConsentUpdate = event.detail.legalConsentUpdate;
});
Kameleoon.API.Core.enableLegalConsent()) ou le refus (Kameleoon.API.Core.disableLegalConsent()) pour les modules AB Testing ou Personalization. Accédez au statut mis à jour via Kameleoon.API.Visitor.experimentLegalConsent ou Kameleoon.API.Visitor.personalizationLegalConsent ; l’objet de l’événement contient les détails de la mise à jour.
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| legalConsentUpdate | Object | Mise à jour qui vient d’être traitée. Elle suit le format {“AB_TESTING”: true|false, “PERSONALIZATION”: true|false}. Cela pourrait donc être égal à {“AB_TESTING”: false} si nous venons d’enregistrer un refus uniquement pour le module AB Testing, ou à {“AB_TESTING”: true, “PERSONALIZATION”: true} si une acceptation a eu lieu pour les deux modules. |
Kameleoon::ExperimentTriggered
window.addEventListener('Kameleoon::ExperimentTriggered', function (event) {
var experiment = event.detail.experiment;
var experimentId = experiment.id;
});
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| experiment | Object | Objet Experiment |
Kameleoon::ExperimentActivated
window.addEventListener('Kameleoon::ExperimentActivated', function (event) {
var experiment = event.detail.experiment;
var experimentId = experiment.id;
var associatedVariationId = experiment.associatedVariation.id;
});
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| experiment | Object | Objet Experiment |
Kameleoon::PersonalizationTriggered
window.addEventListener('Kameleoon::PersonalizationTriggered', function (event) {
var personalization = event.detail.personalization;
var personalizationId = personalization.id;
});
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| personalization | Object | Objet Personalization |
Kameleoon::PersonalizationActivated
window.addEventListener('Kameleoon::PersonalizationActivated', function (event) {
var personalization = event.detail.personalization;
var personalizationId = personalization.id;
var associatedVariationId = personalization.associatedVariation.id;
});
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| personalization | Object | Objet Personalization |
Kameleoon::CustomDataSet
window.addEventListener('Kameleoon::CustomDataSet', function (event) {
var customDataName = event.detail.name;
var customDataValue = event.detail.value;
});
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| name | String | Nom de la donnée personnalisée. |
| value | Any | Valeur de la donnée personnalisée. Son type dépend du type défini de la donnée personnalisée. |
Kameleoon::ConversionTriggered
window.addEventListener('Kameleoon::ConversionTriggered', function (event) {
var goal = event.detail.goal;
});
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| goal | Object | Objet Goal |
Kameleoon::SegmentTriggered
window.addEventListener('Kameleoon::SegmentTriggered', function (event) {
var segment = event.detail.segment;
});
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| segment | Object | Objet Segment |
Kameleoon::ConversionScoreComputed
window.addEventListener('Kameleoon::ConversionScoreComputed', function (event) {
var kcs = event.detail.kcs;
var segmentId = event.detail.targetSegment.id;
});
Données disponibles dans l’événement
| Nom | Type | Description |
|---|
| kcs | Number | KCS (Kameleoon Conversion Score), un entier de 0 à 100. |
| targetSegment | Object | Objet Segment correspondant au moment clé où le KCS est calculé. |
