Adobe Experience Platform Launch wurde als eine Suite von Datenerfassungstechnologien in Adobe Experience Platform umbenannt. Infolgedessen wurden in der gesamten Produktdokumentation mehrere terminologische Änderungen eingeführt. Eine konsolidierte Übersicht der terminologischen Änderungen finden Sie im folgenden Dokument.
Dieses Dokument dient als Referenz für das Client-seitige _satellite
-Objekt und die verschiedenen Funktionen, die Sie damit ausführen können.
track
Code
_satellite.track(identifier: string [, detail: *] )
Beispiel
_satellite.track('contact_submit', { name: 'John Doe' });
track
löst alle Regeln mit dem Ereignistyp „Direktaufruf“ aus, der mit der angegebenen Kennung aus der Core-Tag-Erweiterung konfiguriert wurde. Das obige Beispiel löst alle Regeln aus, die einen Direktaufruf-Ereignistyp verwenden, bei dem die konfigurierte ID contact_submit
lautet. Darüber hinaus wird ein optionales Objekt übergeben, das zugehörige Informationen enthält. Sie können auf das Detailobjekt zugreifen, indem Sie %event.detail%
in ein Textfeld innerhalb einer Bedingung/Aktion eingeben oder event.detail
im Code-Editor in einer Bedingung/Aktion für benutzerspezifischen Code eingeben.
getVar
Code
_satellite.getVar(name: string) => *
Beispiel
var product = _satellite.getVar('product');
Wenn ein Datenelement mit dem entsprechenden Namen vorhanden ist, wird der Wert des Datenelements zurückgegeben. Wenn kein passendes Datenelement vorhanden ist, wird überprüft, ob zuvor über _satellite.setVar()
eine benutzerdefinierte Variable mit dem jeweiligen Namen festgelegt wurde. Wenn eine passende benutzerdefinierte Variable gefunden wird, wird ihr Wert zurückgegeben.
Sie können Prozentwerte (%
) Syntax, um Variablen für viele Formularfelder in Ihrer Tag-Implementierung zu referenzieren, wodurch der Aufruf von _satellite.getVar()
. Verwenden Sie beispielsweise %product%
greift auf den Wert des Produktdatenelements oder der benutzerdefinierten Variablen zu.
Wenn ein Ereignis eine Regel Trigger, können Sie die entsprechende Regel übergeben event
Objekt in _satellite.getVar()
wie folgt:
// event refers to the calling rule's event
var rule = _satellite.getVar('return event rule', event);
setVar
Code
_satellite.setVar(name: string, value: *)
Beispiel
_satellite.setVar('product', 'Circuit Pro');
setVar()
legt eine benutzerdefinierte Variable mit dem angegebenen Namen und Wert fest. Der Wert der Variablen kann später mithilfe von _satellite.getVar()
abgerufen werden.
Sie können optional mehrere Variablen auf einmal festlegen, indem Sie ein Objekt übergeben, in dem die Schlüssel die Variablennamen und die Werte die zugehörigen Variablenwerte darstellen.
_satellite.setVar({ 'product': 'Circuit Pro', 'category': 'hobby' });
getVisitorId
Code
_satellite.getVisitorId() => Object
Beispiel
var visitorIdInstance = _satellite.getVisitorId();
Wenn die Adobe Experience Cloud ID-Erweiterung in der Eigenschaft installiert ist, gibt diese Methode die Besucher-ID-Instanz zurück. Weitere Informationen finden Sie in der Dokumentation zum Experience Cloud ID-Dienst.
logger
Code
_satellite.logger.log(message: string)
_satellite.logger.info(message: string)
_satellite.logger.warn(message: string)
_satellite.logger.error(message: string)
Beispiel
_satellite.logger.error('No product ID found.');
Das logger
-Objekt ermöglicht die Protokollierung einer Nachricht in der Browser-Konsole. Die Meldung wird nur dann angezeigt, wenn das Tag-Debugging durch den Benutzer aktiviert wird (per Aufruf von _satellite.setDebug(true)
oder Verwendung einer entsprechenden Browser-Erweiterung).
_satellite.logger.deprecation(message: string)
Beispiel
_satellite.logger.deprecation('This method is no longer supported, please use [new example] instead.');
Protokolliert eine Warnung in der Browser-Konsole. Die Meldung wird unabhängig davon angezeigt, ob der Benutzer das Tag-Debugging aktiviert hat.
cookie
_satellite.cookie
enthält Funktionen zum Lesen und Schreiben von Cookies. Dies ist eine offengelegte Kopie des „js-cookie“ der Drittanbieter-Bibliothek. Weitere Informationen zur weitergehenden Verwendung dieser Bibliothek finden Sie in der js-cookie-Dokumentation.
Um ein Cookie zu setzen, verwenden Sie _satellite.cookie.set()
.
Code
_satellite.cookie.set(name: string, value: string[, attributes: Object])
Im alten setCookie
-Methode zum Festlegen von Cookies war das dritte (optionale) Argument für diesen Funktionsaufruf eine Ganzzahl, die die Ablaufzeit des Cookies in Tagen angibt. In dieser neuen Methode wird stattdessen ein Objekt „attributes“ als drittes Argument akzeptiert. Um mithilfe der neuen Methode einen Ablauf für ein Cookie festzulegen, müssen Sie eine expires
-Eigenschaft im Attributobjekt und legen Sie es auf den gewünschten Wert fest. Dies wird im folgenden Beispiel demonstriert.
Beispiel
Der folgende Funktionsaufruf schreibt ein Cookie, das in einer Woche abläuft.
_satellite.cookie.set('product', 'Circuit Pro', { expires: 7 });
Um ein Cookie abzurufen, verwenden Sie _satellite.cookie.get()
.
Code
_satellite.cookie.get(name: string) => string
Beispiel
Der folgende Funktionsaufruf liest ein zuvor festgelegtes Cookie.
var product = _satellite.cookie.get('product');
Um ein Cookie zu entfernen, verwenden Sie _satellite.cookie.remove()
.
Code
_satellite.cookie.remove(name: string)
Beispiel
Mit dem folgenden Funktionsaufruf wird ein zuvor festgelegtes Cookie entfernt.
_satellite.cookie.remove('product');
buildInfo
Code
_satellite.buildInfo
Dieses Objekt enthält Informationen zum Build der aktuellen Tag-Laufzeitbibliothek. Das Objekt enthält die folgenden Eigenschaften:
turbineVersion
Stellt die Turbine-Version bereit, die in der aktuellen Bibliothek verwendet wird.
turbineBuildDate
Das ISO-8601-Datum, an dem die im aktuellen Container verwendete Turbine-Version erstellt wurde.
buildDate
Das ISO-8601-Datum, an dem die aktuelle Bibliothek erstellt wurde.
Dieses Beispiel zeigt die Objektwerte:
{
turbineVersion: "14.0.0",
turbineBuildDate: "2016-07-01T18:10:34Z",
buildDate: "2016-03-30T16:27:10Z"
}
environment
Dieses Objekt enthält Informationen über die Umgebung, in der die aktuelle Tag-Laufzeitbibliothek bereitgestellt wird.
Code
_satellite.environment
Das Objekt enthält die folgenden Eigenschaften:
{
id: "ENbe322acb4fc64dfdb603254ffe98b5d3",
stage: "development"
}
Eigenschaft | Beschreibung |
---|---|
id |
Die ID der Umgebung. |
stage |
Die Umgebung, für die diese Bibliothek erstellt wurde. Die möglichen Werte sind development , staging und production . |
notify
Diese Methode wird nicht mehr unterstützt. Verwenden Sie stattdessen _satellite.logger.log()
.
Code
_satellite.notify(message: string[, level: number])
Beispiel
_satellite.notify('Hello world!');
notify
protokolliert eine Nachricht in der Browser-Konsole. Die Meldung wird nur angezeigt, wenn das Tag-Debugging vom Benutzer aktiviert wurde (durch Abrufen von _satellite.setDebug(true)
oder mit einer entsprechenden Browser-Erweiterung).
Eine optionale Protokollebene kann übergeben werden, die sich auf die Formatierung und Filterung der protokollierten Nachricht auswirkt. Folgende Ebenen werden unterstützt:
3 – Informationsmeldungen
4 – Warnmeldungen
5 – Fehlermeldungen
Wenn Sie keine Protokollebene oder einen anderen Wert als die oben angezeigten angeben, wird die Nachricht als normale Meldung protokolliert.
setCookie
Diese Methode wird nicht mehr unterstützt. Verwenden Sie stattdessen _satellite.cookie.set()
.
Code
_satellite.setCookie(name: string, value: string, days: number)
Beispiel
_satellite.setCookie('product', 'Circuit Pro', 3);
Erstellt ein Cookie im Browser des Benutzers. Das Cookie wird über die angegebene Anzahl an Tagen gespeichert.
readCookie
Diese Methode wird nicht mehr unterstützt. Verwenden Sie stattdessen _satellite.cookie.get()
.
Code
_satellite.readCookie(name: string) => string
Beispiel
var product = _satellite.readCookie('product');
Liest ein Cookie im Browser des Benutzers aus.
removeCookie
Diese Methode wird nicht mehr unterstützt. Verwenden Sie stattdessen _satellite.cookie.remove()
.
Code
_satellite.removeCookie(name: string)
Beispiel
_satellite.removeCookie('product');
Entfernt ein Cookie aus dem Browser des Benutzers.
Der Zugriff auf die folgenden Funktionen sollte nicht über den Produktions-Code erfolgen. Sie dienen nur Debugging-Zwecken und ändern sich mit der Zeit nach Bedarf.
container
Code
_satellite._container
Beispiel
Der Zugriff auf diese Funktion sollte nicht über den Produktions-Code erfolgen. Sie dient lediglich Debugging-Prozessen und ändert sich bei Bedarf im Laufe der Zeit.
monitor
Code
_satellite._monitors
Beispiel
Der Zugriff auf diese Funktion sollte nicht über den Produktions-Code erfolgen. Sie dient lediglich Debugging-Prozessen und ändert sich bei Bedarf im Laufe der Zeit.
Beispiel
Fügen Sie auf Ihrer Web-Seite, auf der eine Tag-Bibliothek ausgeführt wird, dem HTML-Code ein Code-Fragment hinzu. In der Regel wird der Code in das Element <head>
vor dem Element <script>
eingefügt, das die Tag-Bibliothek lädt. Dadurch kann der Monitor die frühesten Systemereignisse in der Tag-Bibliothek erfassen. Beispiel:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
<script>
window._satellite = window._satellite || {};
window._satellite._monitors = window._satellite._monitors || [];
window._satellite._monitors.push({
ruleTriggered: function (event) {
console.log(
'rule triggered',
event.rule
);
},
ruleCompleted: function (event) {
console.log(
'rule completed',
event.rule
);
},
ruleConditionFailed: function (event) {
console.log(
'rule condition failed',
event.rule,
event.condition
);
}
});
</script>
<script src="//assets.adobedtm.com/launch-EN5bfa516febde4b22b3e7c6f96f6b439f.min.js"
async></script>
</head>
<body>
<h1>Click me!</h1>
</body>
</html>
Da die Tag-Bibliothek noch nicht geladen wurde, wird im ersten Skriptelement das anfängliche _satellite
-Objekt erstellt und ein Array wird auf _satellite._monitors
initialisiert. Das Skript fügt diesem Array dann ein Monitorobjekt hinzu. Das Monitorobjekt kann die folgenden Methoden angeben, die später von der Tag-Bibliothek aufgerufen werden:
ruleTriggered
Die Funktion wird aufgerufen, nachdem ein Ereignis eine Regel ausgelöst hat, aber bevor die Bedingungen und Aktionen der Regel verarbeitet wurden. Das Ereignisobjekt, das an ruleTriggered
übergeben wird, enthält Informationen zu der ausgelösten Regel.
ruleCompleted
Diese Funktion wird aufgerufen, nachdem eine Regel vollständig verarbeitet wurde. Das heißt, das Ereignis ist eingetreten, alle Bedingungen wurden übergeben und alle Aktionen ausgeführt. Das an ruleCompleted
übergebene Ereignisobjekt enthält Informationen über die abgeschlossene Regel.
ruleConditionFailed
Diese Funktion wird aufgerufen, nachdem eine Regel ausgelöst wurde und eine der Bedingungen fehlgeschlagen ist. Das Ereignisobjekt, das an ruleConditionFailed
übergeben wird, enthält Informationen zu der ausgelösten Regel und der fehlgeschlagenen Bedingung.
Wenn ruleTriggered
aufgerufen wird, werden kurz darauf auch ruleCompleted
oder ruleConditionFailed
aufgerufen.
Der Monitor muss nicht mehr alle drei Methoden festlegen (ruleTriggered
, ruleCompleted
und ruleConditionFailed
). Tags in Adobe Experience Platform funktionieren mit allen unterstützten Methoden, die vom Monitor bereitgestellt wurden.
Im obigen Beispiel werden alle drei Methoden im Monitor angegeben. Wenn sie aufgerufen werden, zeigt der Monitor relevante Informationen an. Um dies zu testen, richten Sie zwei Regeln in der Tag-Bibliothek ein:
Wenn Sie die Seite in Chrome öffnen, die Browser-Konsole öffnen und auf die Seite klicken, wird Folgendes in der Konsole angezeigt:
Sie können diesen Handlern nach Bedarf zusätzliche Hooks und Informationen hinzufügen.