Show Menu
THEMEN×

Launch-Objektreferenz

In vielen Formularfeldern der Launch-Benutzeroberfläche können Sie die %% -Syntax verwenden, um auf Variablen zu verweisen. So muss _satellite.getVar() seltener aufgerufen werden. Beispielsweise dient %product% dem Zugriff auf den Wert des Produktdatenelements oder der benutzerdefinierten Variable.

Launch-Objektreferenz

Diese Referenz dokumentiert das Objekt _satellite und die Elemente, mit denen Sie arbeiten können.

track

Code

_satellite.track(identifier: string [, detail: *] )

Beispiel

_satellite.track('contact_submit', { name: 'John Doe' });

Löst alle Regeln mithilfe des Ereignistyps „Direktaufruf“ aus der Haupterweiterung aus, die mit der angegebenen ID 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.
In vielen Formularfeldern der Launch-Benutzeroberfläche können Sie die %% -Syntax verwenden, um auf Variablen zu verweisen. So muss _satellite.getVar() seltener aufgerufen werden. Beispielsweise dient %product% dem Zugriff auf den Wert des Produktdatenelements oder der benutzerdefinierten Variable.

setVar

Code

_satellite.setVar(name: string, value: *)

Beispiel

_satellite.setVar('product', 'Circuit Pro');

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 Property 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.');

Protokolliert eine Nachricht in der Browser-Konsole. Die Meldung wird nur dann angezeigt, wenn das Launch-Debugging durch den Benutzer aktiviert wird (per Aufruf von _satellite.setDebug(true) oder Verwendung einer entsprechenden Browser-Erweiterung).

buildInfo

Code

_satellite.buildInfo

Dieses Objekt enthält Informationen zum Build der aktuellen Launch-Laufzeitbibliothek. Das Objekt enthält die folgenden Eigenschaften:

turbineVersion

Die in der aktuellen Bibliothek verwendete Turbine -Version

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.

Umgebung

Die Umgebung, für die diese Bibliothek erstellt wurde. Die möglichen Werte sind:
  • development
  • staging
  • production
Dieses Beispiel zeigt die Objektwerte:
{
  turbineVersion: "14.0.0",
  turbineBuildDate: "2016-07-01T18:10:34Z",
  buildDate: "2016-03-30T16:27:10Z",
  environment: "development"
}

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!');

Protokolliert eine Nachricht in der Browser-Konsole. Die Meldung wird nur dann angezeigt, wenn das Launch-Debugging durch den Benutzer aktiviert wird (per Aufruf von _satellite.setDebug(true) oder Verwendung einer entsprechenden Browser-Erweiterung).
Es kann eine optionale Protokollebene übergeben werden, die die Formatierung und Filterung der protokollierten Nachricht betrifft. 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.

Debugging-Funktionen

Der Zugriff auf die folgenden Funktionen sollte nicht über den Produktionscode erfolgen. Sie dienen nur Debugging-Zwecken und ändern sich mit der Zeit nach Bedarf.

Personen gibt

Code

_satellite._container

Beispiel

Der Zugriff auf diese Funktion sollte nicht über den Produktionscode 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 Produktionscode erfolgen. Sie dient lediglich Debugging-Prozessen und ändert sich bei Bedarf im Laufe der Zeit.

Beispiel

Fügen dem HTML-Code einer Webseite, auf der eine Launch-Bibliothek ausgeführt wird, einen Codeausschnitt hinzu. In der Regel wird der Code im <head> -Tag hinzugefügt – vor dem <script> -Tag, das die Launch-Bibliothek lädt. Dadurch kann der Monitor die frühesten Systemereignisse in der Launch-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 Launch-Bibliothek noch nicht geladen wurde, wird im ersten Skript-Tag das erste _satellite -Objekt erstellt und ein _satellite._monitors -Array initialisiert. Das Skript fügt diesem Array dann ein Monitorobjekt hinzu. Das Monitorobjekt kann die folgenden Methoden angeben, die später von der Launch-Bibliothek aufgerufen werden:

ruleTriggered

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

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 Ereignisobjekt, das an ruleCompleted übergeben wird, enthält Informationen zu der abgeschlossenen Regel.

ruleConditionFailed

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 ). Launch funktioniert mit allen unterstützten Methoden, die vom Monitor bereitgestellt wurden.

Testen des Monitors

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 Launch-Bibliothek ein:
  1. Eine Regel mit einem Klick-Ereignis und eine Browser-Bedingung, die nur dann übergeben wird, wenn der Browser Chrome ist.
  2. Eine Regel mit einem Klick-Ereignis und eine Browser-Bedingung, die nur dann übergeben wird, wenn der Browser Firefox ist.
Wenn Sie die Seite in Chrome anzeigen, die Browserkonsole ö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.