Show Menu
THEMEN×

Adobe Target-Erweiterung

Verwenden Sie diese Referenz, um Informationen zu den verfügbaren Optionen beim Erstellen einer Regel mithilfe dieser Erweiterung zu erhalten.

Konfigurieren der Adobe Target-Erweiterung

Für die Adobe Target-Erweiterung ist at.js erforderlich. „mbox.js“ wird nicht unterstützt.
Wenn die Adobe Target-Erweiterung noch nicht installiert ist, öffnen Sie die Eigenschaft, klicken Sie dann auf Extensions > Catalog , bewegen Sie den Mauszeiger über die Target-Erweiterung und klicken Sie auf Install .
Öffnen Sie zum Konfigurieren der Erweiterung die Registerkarte Extensions, bewegen Sie den Mauszeiger über die Erweiterung und klicken Sie dann auf Configure .

at.js-Einstellungen

All Ihre at.js-Einstellungen mit Ausnahme der Zeitüberschreitung. werden automatisch aus Ihrer at.js-Konfiguration in der Target-Benutzeroberfläche abgerufen. Mithilfe dieser Erweiterung werden nur Einstellungen von der Target-Benutzeroberfläche abgerufen, wenn sie erstmalig hinzugefügt wird. Daher sollten alle Einstellungen in der Launch-Benutzeroberfläche verwaltet werden, wenn zusätzliche Updates nötig sind.
Die folgenden Konfigurationsoptionen sind verfügbar:

Clientcode

Der Client-Code ist die Kontokennung von Target. Der entsprechende Wert sollte nahezu immer als Standardwert beibehalten werden.
Kann mithilfe von Datenelementen geändert werden.

Organisations-ID

Diese ID ordnet die Implementierung Ihrem Adobe Experience Cloud-Konto zu. Der entsprechende Wert sollte nahezu immer als Standardwert beibehalten werden.
Kann mithilfe von Datenelementen geändert werden.

Globaler Mbox-Name

Zeigt den Namen Ihrer globalen Target-Anfrage an. Standardmäßig lautet dieser Name „target-global-mbox“, es sei denn, Sie haben den Namen auf der Target-Benutzeroberfläche vor dem Hinzufügen der Erweiterung geändert.
Kann mithilfe von Datenelementen geändert werden.

Serverdomäne

Die Domäne, an die Target-Anfragen gesendet werden. Der entsprechende Wert sollte nahezu immer als Standardwert beibehalten werden.

Domänenübergreifend

Legt fest, wo Target Cookies in den Browsern einrichtet.
  • Deaktiviert: Legt die Cookies nur für die Erstanbieterdomäne fest. Dies ist die typische Einstellung.
  • Aktiviert: Richtet Cookies sowohl auf der Erstanbieterdomäne als auch auf der Target-Drittanbieterdomäne (der „Serverdomäne“) ein.

Zeitüberschreitung (ms)

Wenn die Antwort von Target nicht innerhalb des definierten Zeitraums empfangen wird, erfolgt eine Zeitüberschreitung für die Anfrage, und der Standardinhalt wird angezeigt. Während der Sitzung des Besuchers wird weiter versucht, Anfragen vorzunehmen. Die Standardeinstellung lautet 3000 ms und kann von der auf der Target-Benutzeroberfläche konfigurierten Zeitüberschreitung abweichen.
Weitere Informationen zur Funktionsweise der Zeitüberschreitungseinstellung finden Sie in der Hilfe zu Adobe Target .

Weitere auf der Target-Benutzeroberfläche verfügbare at.js-Einstellungen

Verschiedene Einstellungen, die auf der Edit at.js settings-Seite der Target-Benutzeroberfläche verfügbar sind, sind nicht Teil der Target-Erweiterung. Die Vorschläge für die Problemumgehung lauten wie folgt:
  • Globale Mbox automatisch erstellen – Diese Einstellung wird durch die Aktion „Globale Mbox auslösen“ in der Target-Erweiterung ersetzt.
  • Bibliothekskopfzeile – Diese Einstellung ist nicht Teil der Target-Erweiterung. Fügen Sie vor der Verwendung der Aktion „Target laden“ Code, der vor at.js geladen werden muss, in eine Aktion vom Typ „Haupterweiterung>Benutzerdefinierter Code“ ein.
  • Bibliotheksfußfzeile – Diese Einstellung ist nicht Teil der Target-Erweiterung. Fügen Sie nach Verwendung der Aktion „Target laden“ Code, der nach at.js geladen werden muss, in eine Aktion vom Typ „Haupterweiterung>Benutzerdefinierter Code“ ein.

Aktionstypen für die Target-Erweiterung

In diesem Abschnitt werden die in der Target-Erweiterung verfügbaren Aktionstypen beschrieben.
Die Target-Erweiterung enthält die folgenden Aktionen im Dann-Teil einer Regel:

Target laden

Fügen Sie diese Aktion Ihrer Launch-Regel hinzu, wenn es im Kontext Ihrer Regel sinnvoll ist, Target zu laden. Dadurch wird die at.js-Bibliothek in die Seite geladen. Bei den meisten Implementierungen sollte Target auf jeder Seite Ihrer Site geladen werden.
Es ist keine Konfiguration erforderlich.

Hinzufügen von Mbox-Parametern

Fügen Sie allen Mbox-Anfragen Parameter hinzu. Die Aktion „Target laden“ muss vorher verwendet werden.
  1. Geben Sie den Namen und den Wert eines beliebigen Parameters an, den Sie hinzufügen möchten.
  2. Klicken Sie auf das Plus-Symbol, um weitere Parameter hinzuzufügen.

Hinzufügen globaler Mbox-Parameter

Fügen Sie nur Ihren globalen Mbox-Anfragen Parameter hinzu. Die Aktion „Target laden“ muss vorher verwendet werden.
  1. Geben Sie den Namen und den Wert eines beliebigen Parameters an, den Sie hinzufügen möchten.
  2. Klicken Sie auf das Plus-Symbol, um weitere Parameter hinzuzufügen.

Globale Mbox auslösen

Lösen Sie die globale Mbox auf Ihrer Seite aus. Die Aktion „Target laden“ muss vorher verwendet werden.
Geben Sie an, ob Sie die Ausblendung des Textkörpers aktivieren möchten, um Flackern zu verhindern. Geben Sie außerdem den Stil an, der beim Ausblenden des Textkörperelements verwendet wird.
Die folgenden Optionen sind verfügbar:
  • Ausblendung des Textkörpers: Sie können diese Einstellung aktivieren oder deaktivieren. Der Standardwert lautet „Aktiviert“, was bedeutet, dass der HTML-TEXTKÖRPER ausgeblendet wird.
  • Ausgeblendeter Textkörperstil: Der Standardwert lautet body{opacity:0} . Dieser Wert kann abgeändert werden, beispielsweise in body{display:none} .
Weitere Informationen finden Sie in der Onlinehilfe zu Target .

Grundlegende Adobe Target-Implementierung

Nachdem die Target-Erweiterung installiert wurde, müssen Sie mindestens eine Regel erstellen, um sie ordnungsgemäß zu implementieren. Sie müssen zuerst die Target-Bibliothek (at.js) laden, die Parameter angeben, die Sie mit der globalen Mbox verwenden möchten, und die globale Mbox auslösen.
Eine Target-Regel mit dieser grundlegenden Implementierung sieht folgendermaßen aus:
Nach dem Speichern dieser Regel müssen Sie sie einer Bibliothek hinzufügen und erstellen/bereitstellen, sodass Sie das Verhalten testen können.

Adobe Target-Erweiterung mit einer asynchronen Implementierung

Launch kann asynchron bereitgestellt werden. Wenn Sie die Launch-Bibliothek asynchron mit Target darin laden, wird Target ebenfalls asynchron geladen. Dieses Szenario wird vollständig unterstützt. Es muss jedoch eine weitere Tatsache beachtet werden.
In asynchronen Implementierungen ist es möglich, dass die Seite das Rendern der Standardinhalte fertig stellt, bevor die Target-Bibliothek vollständig geladen wurde und den Tausch des Inhalts durchgeführt hat. Dies kann zum so genannten „Flimmern“ führen. Dabei wird der Standardinhalt kurz angezeigt, bevor er durch den von Target angegebenen personalisierten Inhalt ersetzt wird. Wenn Sie dieses Flimmern verhindern möchten, empfehlen wir, einen vorab ausgeblendeten Ausschnitt zu verwenden und das Launch-Bündel asynchron zu laden, damit es nicht zu einem Flimmern der Inhalte kommt.
Nachfolgend werden einige Aspekte aufgeführt, die Sie bei Verwendung des vorab ausgeblendeten Ausschnitts beachten sollten:
  • Der Ausschnitt muss vor dem Laden des eingebetteten Launch-Kopfzeilencodes hinzugefügt werden.
  • Dieser Code kann von Launch nicht verwaltet werden. Daher muss er der Seite direkt hinzugefügt werden.
  • Die Seite wird angezeigt, wenn das früheste der folgenden Ereignisse eintritt:
    • Wenn die globale Mbox-Antwort empfangen wurde
    • Wenn für die globale Mbox-Anfrage eine Zeitüberschreitung eintritt
    • Wenn für den Ausschnitt selbst eine Zeitüberschreitung eintritt
  • Die Aktion „Globale Mbox auslösen“ sollte auf allen Seiten verwendet werden, bei denen der vorab ausgeblendete Ausschnitt zum Einsatz kommt, um die Dauer der Vorab-Ausblendung zu minimieren.
Der vorab ausgeblendete Codeausschnitt lautet wie folgt und kann minimiert werden. Die konfigurierbaren Optionen befinden sich am Ende:
;(function(win, doc, style, timeout) {
  var STYLE_ID = 'at-body-style';

  function getParent() {
    return doc.getElementsByTagName('head')[0];
  }

  function addStyle(parent, id, def) {
    if (!parent) {
      return;
    }

    var style = doc.createElement('style');
    style.id = id;
    style.innerHTML = def;
    parent.appendChild(style);
  }

  function removeStyle(parent, id) {
    if (!parent) {
      return;
    }

    var style = doc.getElementById(id);

    if (!style) {
      return;
    }

    parent.removeChild(style);
  }

  addStyle(getParent(), STYLE_ID, style);
  setTimeout(function() {
    removeStyle(getParent(), STYLE_ID);
  }, timeout);
}(window, document, "body {opacity: 0 !important}", 3000));

Standardmäßig wird durch den Ausschnitt der gesamte HTML-TEXTKÖRPER vorab ausgeblendet. In einigen Fällen sollten nur bestimmte HTML-Elemente vorab ausgeblendet werden und nicht die gesamte Seite. Dazu können Sie den Stilparameter anpassen. Führen Sie eine Ersetzung aus, durch die nur bestimmte Teile der Seite vorab ausgeblendet werden.
Wenn beispielsweise zwei Regionen durch die IDs „container-1“ und „container-2“ identifiziert werden, kann der Stil wie folgt ersetzt werden:
#container-1, #container-2 {opacity: 0 !important}

Anstelle der Standardeinstellung:
body {opacity: 0 !important}

Standardmäßig tritt für den Ausschnitt bei 3000 ms bzw. 3 Sekunden eine Zeitüberschreitung ein. Dieser Wert kann angepasst werden.