Experiment and personalization objects - Kameleoon Documentation

Diese Objekte beschreiben Experimente und Personalisierungen sowie, ob jede davon im aktuellen Besuch aktiviert wurde.

Experiment

Ein Experiment-Objekt stellt einen Kameleoon A/B-Test dar. Zu den Kerneigenschaften gehören das Segment und die zugeordneten Variationen. Variationen enthalten den JavaScript- und CSS-Code, der die Änderungen implementiert. Properties

Name	Type	Description
id	Number	ID des Experiments.
name	String	Name des Experiments.
dateLaunched	Number	Zeitpunkt des ersten Starts des Experiments (UTC-Format – ms seit dem 1. Januar 1970).
dateModified	Number	Zeitpunkt der letzten Änderung des Experiments (UTC-Format – ms seit dem 1. Januar 1970).
targetSegment	Object	Segment-Objekt, das dem Experiment zugeordnet ist.
variations	Array	Liste von Variation objects für dieses Experiment.
trafficDeviation	Object	Zuordnung der aktuellen Traffic-Abweichung des Experiments. Die Schlüssel sind Varianten-IDs (ID 0 ist die Referenz). Die Werte sind Prozentsätze (0–100). Die Summe kann 100 nicht erreichen, wenn ein Teil des Traffics nicht zugewiesen ist.
untrackedTrafficReallocationTime	Number	Zeitpunkt der letzten Neuzuweisung für nicht erfassten Traffic (UTC-Format, ms seit dem 1. Januar 1970). Hat die Engine nie eine Neuzuweisung durchgeführt, ist der Wert null.
goals	Array	Liste der Goal-Objekte, die für das Experiment erfasst werden.
mainGoal	Object	Goal-Objekt, das das Hauptziel des Experiments darstellt.
triggered	Boolean	Entspricht true, wenn das Experiment auf der Seite ausgelöst wurde, sonst false.
active	Boolean	Boolean gleich true, wenn das Experiment derzeit auf der Seite aktiv ist, sonst false.
triggeredInVisit	Boolean	Entspricht true, wenn das Experiment im aktuellen Besuch ausgelöst wurde, sonst false. Ein Auslösen im Besuch bedeutet, dass der Besuch irgendwann die Segmentbedingungen des Experiments erfüllt hat.
activatedInVisit	Boolean	Wenn true, hat die Engine das Experiment im aktuellen Besuch aktiviert. Ein Auslösen garantiert keine Aktivierung; Faktoren wie Traffic-Ausschluss oder Capping können die Aktivierung verhindern.
nonExpositionReason	String	Hat die Engine das Experiment ausgelöst, es aber nicht aktiviert, gibt dieses Feld den Grund an. Mögliche Werte: `EXPERIMENT_EXCLUSION` (der Besucher gehört zur vom Experiment ausgeschlossenen Gruppe, zählt also nicht zu den Ergebnissen) und `VISITOR_CAPPING` (der Besucher hat ein Capping-Limit erreicht, das die Aktivierung verhindert). Diese Eigenschaft ist verfügbar, wenn die Engine das Experiment auf der aktuellen Seite ausgelöst hat und `active` false ist.
associatedVariation	Object	Variation-Objekt, das für den jeweiligen Besucher mit dem Experiment verknüpft ist. Ist das Experiment noch nicht aktiviert, ist dieser Wert in der Regel null, außer die Engine hat eine Variante vorab zugewiesen.
redirectProcessed	Boolean	Wenn true, hat auf der vorherigen Seite eine URL-Weiterleitung für dieses Experiment stattgefunden. Sie setzen diese Eigenschaft über processRedirect() oder über eine manuelle Konfiguration. Bei JavaScript-basierten Integrationen können Weiterleitungen die weitere Ausführung von Code abbrechen; prüfen Sie diese Eigenschaft, um Netzwerkanfragen auf der Zielseite bei Bedarf erneut zu senden.

Personalization

Ein Personalisierungs-Objekt stellt eine Kameleoon-Personalisierungsaktion für ein bestimmtes Segment dar. Zu den Kerneigenschaften gehören das Segment und die zugeordnete einzelne Variation. Das Variation-Objekt enthält den JavaScript- und CSS-Code, der die Personalisierungsaktion implementiert. Properties

Name	Type	Description
id	Number	ID der Personalisierung.
name	String	Name der Personalisierung.
dateLaunched	Number	Zeitpunkt des ersten Starts der Personalisierung (UTC-Format – ms seit dem 1. Januar 1970).
dateModified	Number	Zeitpunkt der letzten Änderung der Personalisierung (UTC-Format – ms seit dem 1. Januar 1970).
targetSegment	Object	Segment-Objekt, das der Personalisierung zugeordnet ist.
goals	Array	Liste der Goal-Objekte, die für die Personalisierung erfasst werden.
mainGoal	Object	Goal-Objekt, das das Hauptziel der Personalisierung darstellt.
triggered	Boolean	Wenn true, wurde die Personalisierung auf der Seite ausgelöst.
active	Boolean	Wenn true, ist die Personalisierung auf der Seite aktiv (angezeigt).
triggeredInVisit	Boolean	Wenn true, wurde die Personalisierung während des aktuellen Besuchs ausgelöst. Dies zeigt an, dass der Besuch die Segmentbedingungen der Personalisierung erfüllt hat.
activatedInVisit	Boolean	Wenn true, hat die Engine die Aktion der Personalisierung im aktuellen Besuch angezeigt. Ein Auslösen garantiert nicht, dass die Engine die Aktion anzeigt; Capping oder die Zugehörigkeit zur Kontrollgruppe können die Anzeige verhindern.
nonExpositionReason	String	Grund für Non-Exposition, wenn ausgelöst, aber nicht angezeigt. Mögliche Werte: `GLOBAL_EXCLUSION`, `PERSONALIZATION_EXCLUSION`, `PRIORITY`, `SCHEDULE`, `PERSONALIZATION_CAPPING`, `VISITOR_CAPPING`, `SCENARIO` und `SIMULATION`. Diese Eigenschaft ist verfügbar, wenn die Personalisierung auf der aktuellen Seite ausgelöst wurde und `active` ist false.
associatedVariation	Object	Zugehöriges Variation-Objekt. Diese Eigenschaft verweist bei Personalisierungen immer auf ein gültiges Objekt.

ExperimentActivation

Ein ExperimentActivation-Objekt stellt ein Experiment dar, das bei einem bestimmten Besuch aktiviert wurde. Da Besuche auch historisch sein können, wurde das zugehörige Experiment möglicherweise inzwischen beendet. In diesem Fall fügt die Engine die Metadaten des Experiments (Name, Startdatum, Segment) nicht in die Anwendungsdatei ein, weshalb sie über die API nicht verfügbar sind. Die IDs bleiben jedoch verfügbar. Properties

Name	Type	Description
experimentID	Number	ID des Experiments.
associatedVariationID	Number	ID der zugeordneten Variation. Wenn die zugeordnete Variation die Referenz (Kontrolle) ist, ist die ID gleich 0.
associatedVariation	Object	Zugeordnetes Variation-Objekt. Diese Eigenschaft ist null, wenn das Experiment oder die Variation nicht mehr aktiv ist (beendet oder pausiert).
times	Array	Liste von Aktivierungszeiten für dieses Experiment bei diesem Besuch (UTC-Format – ms seit dem 1. Januar 1970).

PersonalizationActivation

Ein PersonalizationActivation-Objekt stellt eine Personalisierung dar, die während eines bestimmten Besuchs aktiviert wurde. Wie bei Experimenten sind Metadaten nicht verfügbar, wenn die Personalisierung beendet wurde, obwohl IDs zugänglich bleiben. Properties

Name	Type	Description
personalizationID	Number	ID der Personalisierung.
associatedVariationID	Number	ID des associated variation.
personalization	Object	Zugeordnetes Personalisierungs-Objekt. Diese Eigenschaft ist null, wenn die Personalisierung nicht mehr aktiv ist (beendet oder pausiert).
associatedVariation	Object	Zugeordnetes Variation-Objekt. Diese Eigenschaft ist null, wenn die Personalisierung oder Variation nicht mehr aktiv ist (beendet oder pausiert).
times	Array	Liste von Aktivierungszeiten für diese Personalisierung bei diesem Besuch (UTC-Format – ms seit dem 1. Januar 1970).

Variation

Ein Variation-Objekt stellt eine Komponente eines Experiment-Objekts dar. Ein A/B-Test enthält mehrere Variationen, wie etwa einen A/B-Test mit einer Variation plus Referenz oder einen A/B/C-Test mit zwei plus Referenz. Personalisierungen werden einem einzelnen Variation-Objekt zugeordnet.

Bei der Ausführung von Variationscode verweist das Schlüsselwort this auf das entsprechende Variation-Objekt. Verwenden Sie diesen Verweis, um in der Objekthierarchie zu navigieren (z. B. über die Eigenschaft associatedCampaign).

Properties

Name	Type	Description
id	Number	Eindeutige ID der Variation. Wenn die Variation die Referenz (Kontrolle) darstellt, ist die ID gleich 0.
name	String	Name der Variation. Wenn die Variation die Referenz (Kontrolle) darstellt, ist der Name gleich “Referenz”.
associatedCampaign	Object	Das mit dieser Variation verknüpfte Experiment- oder Personalisierungs-Objekt.
instantiatedTemplate	Object	Instantiated-template-Objekt, aus dem diese Variante erzeugt wurde, sofern zutreffend. Stammt die Variante nicht aus einer Vorlage, ist diese Eigenschaft null.
reallocationTime	Number	Zeitpunkt der letzten Traffic-Neuzuweisung für die Variante (UTC-Format, ms seit dem 1. Januar 1970). Hat die Engine nie eine Neuzuweisung für die Variante durchgeführt, ist der Wert null.

Template

Ein Template-Objekt stellt eine instanziierte Widget-Vorlage dar. Verwenden Sie Vorlagen, um Variationen aus einer gemeinsamen Codebasis über die Kameleoon-App-Schnittstelle zu generieren. Ein Template-Objekt enthält vordefinierte Felder und ihre Werte für die zugehörige Variation. Properties

Name	Type	Description
name	String	Name des base template.
customFields	Object	Map der Template-Daten. Die Schlüssel sind die Namen der in der Basis-Template definierten Felder. Die Werte sind die instantiierten Werte, die Sie für die zugeordnete Variation eingegeben haben. Beispielsweise, wenn Sie eine Template mit einem einzelnen Textfeld “currentDiscount” erstellt haben, könnte `customFields` gleich `{"currentDiscount": "-10% auf alle Bestellungen heute!"}` sein.

APIs

​Experiment

​Personalization

​ExperimentActivation

​PersonalizationActivation

​Variation

​Template

Experiment

Personalization

ExperimentActivation

PersonalizationActivation

Variation

Template