Adobe Target v2-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 Version 2

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 „Erweiterungen“, 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 Adobe Experience Platform 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.

Serverdomäne

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

DSGVO-Opt-in

Sofern aktiviert, bietet Adobe Target eine Opt-in-Funktion, um Ihre Strategie für das Genehmigungs-Management zu unterstützen. Mit der Opt-in-Funktion können Kunden steuern, wie und wann das Target-Tag ausgelöst wird. Weitere Informationen zur Adobe-Teilnahme finden Sie unter Datenschutz und Datenschutz-Grundverordnung (DSGVO).

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.

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 Platform 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. Adobe empfiehlt, die Aktion „Target laden“ nur zu verwenden, wenn ihr ein Target-Aufruf vorangestellt ist. Andernfalls könnten Fehler auftreten, wie z. B. die Verzögerung des Analytics-Aufrufs.

Es ist keine Konfiguration erforderlich.

Hinzufügen von Parametern zu allen Anfragen

Fügen Sie allen Target-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 Symbol zum Hinzufügen, um weitere Parameter hinzuzufügen.

Hinzufügen von Parametern zur Seitenladeanfrage

Fügen Sie nur Ihren Seitenladeanfragen 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 Symbol zum Hinzufügen, um weitere Parameter hinzuzufügen.

Auslösen einer Seitenladeanfrage

Lösen Sie eine Target-Anfrage aus, wenn Ihre Seite geladen wird. 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 zu body{display:none}.

Weitere Informationen finden Sie in der Onlinehilfe zu Target.

Auslösen einer Ansicht

Auslösen einer Ansicht für Ihre einseitigen Anwendungen.

1. Geben Sie den Namen der Ansicht an, die ausgelöst werden muss.
2. Geben Sie an, ob das Auslösen der Ansicht einer Impression für das Reporting zugewiesen werden soll, indem Sie das Seitenkontrollkästchen markieren. Wenn die Ansicht mit einer Komponente korreliert wird, die erneut gerendert wird, und nicht einer Impression für das Reporting zugeschrieben wird, lassen Sie das Seitenkontrollkästchen deaktiviert.

Weitere Informationen zum Auslösen einer Ansicht finden Sie in der triggerView() Hilfedokumentation.

Grundlegende Adobe Target-Implementierung

Nachdem die Target-Erweiterung installiert wurde, erstellen Sie mindestens eine Regel, um sie ordnungsgemäß zu implementieren. Sie müssen zuerst die Target-Bibliothek (at.js) laden, die Parameter angeben, die Sie mit der Seitenladeanfrage verwenden möchten, und die Seitenladeanfrage 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, damit Sie das Verhalten testen können.

Adobe Target-Erweiterung mit einer asynchronen Implementierung

Platform Launch kann asynchron bereitgestellt werden. Wenn Sie die Platform 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 Platform 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 Platform Launch-Kopfzeilen-Codes hinzugefügt werden.
• Dieser Code kann von Platform 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 Seitenladeantwort empfangen wurde
  • Wenn für die Seitenladeanfrage eine Zeitüberschreitung eintritt
  • Wenn für den Ausschnitt selbst eine Zeitüberschreitung eintritt
• Die Aktion „Seitenladeanfrage 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.
• Das Ausblenden des Textkörpers muss auch in der Seitenladeregel in der Aktion „Seitenladeanfrage“ aktiviert sein, die Sie für Target in Platform Launch verwenden. Andernfalls bleiben alle Seitenladevorgänge während der Timeout-Zeit ausgeblendet.

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.