Zusätzlich zu den Methoden und Datenstrukturen, die von der Activation API bereitgestellt werden, löst die JavaScript-Engine benutzerdefinierte DOM-Ereignisse aus. Diese Ereignisse dienen als ausgezeichnete Einstiegspunkte, um das Verhalten von Kameleoon anzupassen und die Plattform zu erweitern. Lauschen Sie beispielsweise auf das Ereignis Kameleoon::ExperimentTriggered, um benachrichtigt zu werden, wenn ein Experiment ausgelöst wird.
Die folgende Liste beschreibt die derzeit implementierten Ereignisse. Wenn der aktuellen Activation API ein erforderliches Ereignis fehlt, wenden Sie sich an den technischen Support, um eine Verbesserung anzufordern. Es können neue Ereignisse hinzugefügt werden, um spezifische Anforderungen zu erfüllen.
Da es in einer JavaScript-Umgebung nur einen Ausführungs-Thread gibt, werden Ereignisse, die in einem kontinuierlichen synchronen Ausführungsblock ausgelöst werden, gleichzeitig empfangen. Callback-Listener werden ausgeführt, nachdem der gesamte Kameleoon-Codeblock abgeschlossen ist, und nicht genau zu dem Zeitpunkt, an dem der Code das Ereignis auslöst. Beispielsweise können Kameleoon::Loaded und Kameleoon::Started gleichzeitig empfangen werden, wenn das Laden des lokalen Speichers synchron implementiert ist (der typische Fall, außer in einer domänenübergreifenden Konfiguration, wenn sich die aktuelle URL nicht in der Hauptdomäne befindet). Kameleoon::Started und Kameleoon::ExperimentTriggered sind ebenfalls gleichzeitig für Experimente, deren Targeting sofort ausgewertet werden kann.
Liste der Ereignisse
Kameleoon::Loaded
window.addEventListener('Kameleoon::Loaded', function (event) {
var loadTime = event.detail.loadTime;
var timeout = event.detail.timeout;
});
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| loadTime | Number | Zeitpunkt des abgeschlossenen Ladens der Kameleoon-Anwendungsdatei (UTC-Format - ms seit 1. Januar 1970). |
| timeout | Boolean | true, wenn während des (asynchronen) Ladens der Kameleoon-Anwendungsdatei ein Timeout aufgetreten ist. |
Kameleoon::Aborted
window.addEventListener('Kameleoon::Aborted', function (event) {
var reason = event.detail.reason;
});
- BROWSER: Der Browser wird nicht unterstützt.
- PRERENDER: Dies ist eine Prerender-Anfrage (z. B. Chrome-Optimierung), keine von einem Menschen aufgerufene Webseite. Kameleoon wird nicht ausgeführt, um falsche Statistiken zu vermeiden.
- STORAGE: Die technischen Voraussetzungen für den Normalbetrieb, wie z. B. Schreibvorgänge im lokalen Speicher, können nicht erfüllt werden.
- TIMEOUT: Die Ladezeit der Datei hat die zulässige Dauer überschritten, und die Konfiguration erfordert einen Abbruch.
- DISABLED: Kameleoon wurde über die Back-Office-Anwendung deaktiviert. Alle Frontend-Kameleoon-Ladevorgänge werden sofort abgebrochen, wenn dieser Status aktiv ist.
- PARAMETER: Ein spezieller Parameter in der URL (z. B.
kameleoonDisabled=true) bewirkt, dass die Engine die Ausführung zu Debugging- oder Verifizierungszwecken stoppt.
- SCRIPT: Ein benutzerdefiniertes Abbruchskript hat für den aktuellen Ladevorgang true zurückgegeben.
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| reason | String | Grund / Ursache des Abbruchs. |
Kameleoon::Started
window.addEventListener('Kameleoon::Started', function (event) {
var newVisitor = event.detail.newVisitorCode;
});
Kameleoon.API ist lesbar, obwohl einige Daten (z. B. Geolokalisierungsdaten, die über nachfolgende asynchrone Aufrufe abgerufen werden) möglicherweise nicht verfügbar sind. Die Ereignisdaten geben an, ob die Initialisierung einen neuen visitorCode generiert hat.
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| newVisitorCode | Boolean | true, wenn für diesen Besucher ein neuer (zufälliger) visitorCode generiert wurde (unbekannter / neuer Besucher für Kameleoon), sonst 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() initiiert wurde. Dies geschieht beim Abgleich von geräteübergreifenden Verläufen, bei Intelligent Tracking Prevention oder bei Aktualisierungen benutzerdefinierter Daten.
Lesen Sie hier mehr über SSCs.
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| visits | Array | Liste der Visit-Objekte, die diesem Besucher entsprechen und von der Data API zurückgegeben werden. |
| currentVisitOnly | Boolean | true, wenn Kameleoon.API.Data.performRemoteSynchronization() mit dem Argument currentVisitOnly auf true gesetzt aufgerufen wurde, sonst false. |
Kameleoon::LegalConsentUpdated
window.addEventListener('Kameleoon::LegalConsentUpdated', function (event) {
var legalConsentUpdate = event.detail.legalConsentUpdate;
});
Kameleoon.API.Core.enableLegalConsent()) oder Ablehnung (Kameleoon.API.Core.disableLegalConsent()) für die Module AB Testing oder Personalization. Greifen Sie über Kameleoon.API.Visitor.experimentLegalConsent oder Kameleoon.API.Visitor.personalizationLegalConsent auf den aktualisierten Status zu; das Ereignisobjekt enthält die Aktualisierungsdetails.
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| legalConsentUpdate | Object | Aktualisierung, die gerade verarbeitet wurde. Sie folgt dem Format {“AB_TESTING”: true|false, “PERSONALIZATION”: true|false}. Dies könnte also {“AB_TESTING”: false} entsprechen, wenn wir gerade eine Ablehnung nur für das Modul AB Testing registriert haben, oder {“AB_TESTING”: true, “PERSONALIZATION”: true}, wenn eine Akzeptanz für beide Module erfolgt ist. |
Kameleoon::ExperimentTriggered
window.addEventListener('Kameleoon::ExperimentTriggered', function (event) {
var experiment = event.detail.experiment;
var experimentId = experiment.id;
});
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| experiment | Object | Experiment-Objekt |
Kameleoon::ExperimentActivated
window.addEventListener('Kameleoon::ExperimentActivated', function (event) {
var experiment = event.detail.experiment;
var experimentId = experiment.id;
var associatedVariationId = experiment.associatedVariation.id;
});
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| experiment | Object | Experiment-Objekt |
Kameleoon::PersonalizationTriggered
window.addEventListener('Kameleoon::PersonalizationTriggered', function (event) {
var personalization = event.detail.personalization;
var personalizationId = personalization.id;
});
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| personalization | Object | Personalization-Objekt |
Kameleoon::PersonalizationActivated
window.addEventListener('Kameleoon::PersonalizationActivated', function (event) {
var personalization = event.detail.personalization;
var personalizationId = personalization.id;
var associatedVariationId = personalization.associatedVariation.id;
});
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| personalization | Object | Personalization-Objekt |
Kameleoon::CustomDataSet
window.addEventListener('Kameleoon::CustomDataSet', function (event) {
var customDataName = event.detail.name;
var customDataValue = event.detail.value;
});
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| name | String | Name der benutzerdefinierten Daten. |
| value | Any | Wert der benutzerdefinierten Daten. Der Typ hängt vom definierten Typ der benutzerdefinierten Daten ab. |
Kameleoon::ConversionTriggered
window.addEventListener('Kameleoon::ConversionTriggered', function (event) {
var goal = event.detail.goal;
});
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| goal | Object | Goal-Objekt |
Kameleoon::SegmentTriggered
window.addEventListener('Kameleoon::SegmentTriggered', function (event) {
var segment = event.detail.segment;
});
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| segment | Object | Segment-Objekt |
Kameleoon::ConversionScoreComputed
window.addEventListener('Kameleoon::ConversionScoreComputed', function (event) {
var kcs = event.detail.kcs;
var segmentId = event.detail.targetSegment.id;
});
Im Ereignis verfügbare Daten
| Name | Typ | Beschreibung |
|---|
| kcs | Number | KCS (Kameleoon Conversion Score), eine ganze Zahl von 0 bis 100. |
| targetSegment | Object | Segment-Objekt, das dem Schlüsselmoment entspricht, an dem der KCS berechnet wird. |
