Bedingungstypen für Edge-Erweiterungen
In einer Tag-Regel wird eine Bedingung ausgewertet, nachdem ein Ereignis aufgetreten ist. Alle Bedingungen müssen „true“ zurückgeben, damit die Regel weiter verarbeitet wird. Bedingungstypen werden von Erweiterungen bereitgestellt und prüfen, ob etwas wahr oder falsch ist, wobei ein boolescher Wert zurückgegeben wird.
Beispielsweise könnte eine Erweiterung einen Bedinungstyp „Viewport enthält“ bereitstellen, bei dem der Benutzer einen CSS-Selektor angeben kann. Wenn diese Bedingung auf der Website des Kunden ausgewertet wird, kann die Erweiterung nach Elementen suchen, die mit der CSS-Auswahl übereinstimmen, und die Information zurückgeben, ob sich eines davon im Ansichtsfenster des Benutzers befindet.
In diesem Dokument wird beschrieben, wie Sie Bedingungstypen für eine Edge-Erweiterung in Adobe Experience Platform definieren.
Bedingungstypen bestehen in der Regel aus Folgendem:
- Eine Ansicht, die in der Experience Platform-Benutzeroberfläche und der Datenerfassungs-Benutzeroberfläche angezeigt wird und es Benutzern ermöglicht, die Einstellungen für die Bedingung zu ändern.
- Ein Bibliotheksmodul, das in der Tag-Laufzeitbibliothek ausgegeben wird, um die Einstellungen zu interpretieren und eine Bedingung auszuwerten.
Wenn Sie z. B. auswerten möchten, ob sich der Benutzer auf dem Host example.com
befindet, könnte Ihr Modul wie folgt aussehen.
module.exports = (context) => {
const URL = context.arc.event.xdm.web.webpageDetails.URL;
return URL.endsWith("adobelaunch.com");
};
Wenn Sie möchten, dass der Host-Name vom Benutzer konfiguriert werden kann, um die Eingabe eines Host-Namens zuzulassen und ihn im settings-Objekt zu speichern, könnte das Objekt in etwa wie im folgenden Beispiel aussehen.
{
"hostname": "example.com"
}
Um mit dem benutzerdefinierten Hostnamen arbeiten zu können, muss das Modul wie folgt geändert werden:
module.exports = (context) => {
const URL = context.arc.event.xdm.web.webpageDetails.URL;
return URL.endsWith(settings.hostname);
};
Bedingungsergebnis
Das von einem Bedingungsmodul zurückgegebene Ergebnis kann eines der folgenden sein:
- Ein boolescher Wert (
true
oderfalse
). - Ein Promise, das nach Auflösung einen booleschen Wert zurückgibt.
Kontext des Bibliotheksmoduls
Alle Bedingungsmodule haben Zugriff auf eine context
-Variable, die beim Aufruf des Moduls bereitgestellt wird. Weitere Informationen finden Sie hier.