Aktionstypen für Web-Erweiterungen
Im Kontext von Datenerfassungs-Tags wird eine Aktion ausgeführt, nachdem ein Regelereignis aufgetreten ist und bei der Auswertung alle Bedingungen erfüllt waren.
Beispielsweise könnte eine Erweiterung einen Aktionstyp „Support-Chat anzeigen“ bereitstellen, der einen Dialog mit dem Support-Chat anzeigen könnte, um Benutzern zu helfen, die beim Auschecken Probleme haben.
In diesem Dokument wird beschrieben, wie Sie Aktionstypen für eine Web-Erweiterung in Adobe Experience Platform definieren.
Aktionstypen bestehen in der Regel aus dem Folgenden:
- 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 Aktion zu ändern.
- Ein Bibliotheksmodul, das in der Tag-Laufzeitbibliothek ausgegeben wird, um die Einstellungen zu interpretieren und eine Aktion durchzuführen.
module.exports = function(settings) {
alert('Thanks for visiting our site!');
};
Damit die Nachricht beispielsweise vom Adobe Experience Platform-Benutzer konfiguriert werden kann, können Sie dem Benutzer die Eingabe und Speicherung einer Nachricht im Einstellungsobjekt ermöglichen. Das Objekt sieht ungefähr so aus:
{
"message": "Thank you for being one of our VIP members!"
}
Um mit der benutzerdefinierten Meldung arbeiten zu können, muss Ihr Modul Folgendes ändern:
module.exports = function(settings) {
alert(settings.message);
}
Kontextbezogene Ereignisdaten
Dann muss ein zweites Argument an Ihr Modul übergeben werden, das die Kontextinformationen über das Ereignis enthält, das die Regel auslöst. Das kann in bestimmten Fällen von Vorteil sein. Auf dieses Argument wird wie folgt zugegriffen:
module.exports = function(settings, event) {
// event contains information regarding the event that fired the rule
};
Das event
-Objekt muss die folgenden Eigenschaften enthalten:
$type
youtube.play
.$rule
Ein Objekt, das Informationen zu der Regel enthält, die derzeit ausgeführt wird. Das Objekt muss die folgenden Untereigenschaften enthalten:
id
: Die ID der derzeit ausgeführten Regel.name
: Der Name der derzeit ausgeführten Regel.
Die Erweiterung, die den Ereignistyp bereitstellt, der die Regel ausgelöst hat, kann optional weitere nützliche Informationen zu diesem event
-Objekt hinzufügen.