DokumentationTargetTarget-Entwicklerhandbuch

Implementieren von Target ohne einen Tag-Manager

Letzte Aktualisierung: 5. Mai 2025
  • Themen:

Erstellt für:

  • Entwickler

Informationen zur Implementierung von Adobe Target ohne einen Tag-Manager oder Tags in Adobe Experience Platform.

HINWEIS
Tags in Adobe Experience Platform sind die bevorzugte Methode zur Implementierung von Target und der at.js-Bibliothek. Die folgenden Informationen sind bei Verwendung von Tags in Adobe Experience Platform zur Implementierung von Target nicht anwendbar.

Um auf die Seite Implementierung zuzugreifen, klicken Sie auf Administration > Implementation.

Sie können die folgenden Einstellungen auf dieser Seite festlegen:

  • Kontodetails
  • Implementierungsmethoden
  • Profil-API
  • Debugger-Tools
  • Datenschutz
HINWEIS
Sie können Einstellungen in der at.js-Bibliothek überschreiben, anstatt sie in der Benutzeroberfläche von Target Standard/Premium oder durch Verwendung von REST-APIs zu konfigurieren. Weitere Informationen finden Sie unter targetGlobalSettings().

Kontodetails

Sie können die folgenden Kontodetails anzeigen. Diese Einstellungen können nicht geändert werden.

Einstellung
Beschreibung
Client Code
Der Client-Code ist eine Client-spezifische Zeichenfolge, die bei der Verwendung der Target-APIs häufig erforderlich ist.
IMS Organization ID
Diese ID verknüpft Ihre Implementierung mit Ihrem Adobe Experience Cloud-Konto.
On-Device Decisioning

Um die geräteinterne Entscheidungsfindung zu aktivieren, schieben Sie den Umschalter auf die Position „ein“.

Die geräteinterne Entscheidungsfindung ermöglicht es Ihnen, Ihre A/B- und Experience Targeting(XT)-Kampagnen auf Ihrem Server zwischenzuspeichern und speicherinterne Entscheidungen mit einer Latenz von nahezu null durchzuführen. Weitere Informationen finden Sie Einführung in die geräteinterne Entscheidungsfindung.

Include all existing on-device decisioning qualified activities in the artifact

(Bedingt) Diese Option wird angezeigt, wenn Sie die geräteinterne Entscheidungsfindung aktivieren.

Schieben Sie den Umschalter auf die Position „Ein“, wenn alle Ihre Live Target-Aktivitäten, die für die Entscheidungsfindung auf dem Gerät qualifiziert sind, automatisch in das Artefakt aufgenommen werden sollen.

Wenn Sie diesen Umschalter deaktiviert lassen, müssen Sie alle Entscheidungsaktivitäten auf dem Gerät neu erstellen und aktivieren, damit sie in das generierte Regelartefakt aufgenommen werden.

Implementierungsmethoden

Die folgenden Einstellungen können im Bedienfeld Implementierungsmethoden konfiguriert werden:

Globale Einstellungen

NOTE
Diese Einstellungen werden auf alle Target JS-Bibliotheken angewendet. Nachdem Sie Änderungen im Abschnitt Implementierungsmethoden vorgenommen haben, müssen Sie die Bibliothek herunterladen und in Ihrer Implementierung aktualisieren.
Einstellung
Beschreibung
Page load enabled (Auto-create global mbox)
Wählen Sie aus, ob der globale Mbox-Aufruf in die Datei at.js integriert werden soll, damit er automatisch bei jedem Laden der Seite aktiviert wird.
Global mbox

Wählen Sie einen Namen für die globale Mbox aus. Der Standardname lautet target-global-mbox.

Sonderzeichen wie kaufmännische Und-Zeichen (&) können in Mbox-Namen mit at.js verwendet werden.

Timeout (seconds)

Falls Target nicht innerhalb des festgelegten Zeitraums mit Inhalten antwortet, erfolgt ein Timeout für den Server-Aufruf und es werden Standardinhalte angezeigt. Während der Sitzung des Besuchers werden weiter Aufrufe durchgeführt. Der Standardwert liegt bei 5 Sekunden.

Die at.js-Bibliothek verwendet die Zeitüberschreitungseinstellung in XMLHttpRequest. Die maximale Wartezeit beginnt, wenn die Anfrage ausgelöst wird, und endet, wenn Target eine Antwort vom Server erhält. Weitere Informationen finden Sie unter XMLHttpRequest.timeout im Mozilla Developer Network.

Wenn die angegebene Zeitüberschreitung vor Erhalt der Antwort eintritt, wird der Standardinhalt angezeigt und der Besucher wird möglicherweise als Teilnehmer einer Aktivität gezählt, da die gesamte Datenerfassung am Target Edge erfolgt. Wenn die Anfrage den Target Edge erreicht, wird der Besucher gezählt.

Beim Konfigurieren der Timeout-Einstellung müssen Sie Folgendes beachten:

  • Wenn der Wert zu niedrig ist, erhalten Besucher wahrscheinlich meist nur den Standardinhalt angezeigt, auch wenn sie möglicherweise als Teilnehmer in einer Aktivität gezählt werden.
  • Ist der Wert zu hoch, werden Besuchern unter Umständen leere Stellen auf Ihrer Webseite oder komplett leere Seiten angezeigt, falls Sie für längere Zeiträume Textausblendung einsetzen.

Genaueres über Mbox-Antwortzeiten erfahren Sie auf der Registerkarte „Netzwerk“ in den Entwicklertools Ihres Browsers. Sie können auch Tools zur Überwachung der Webleistung einsetzen, die von Drittanbietern stammen, wie zum Beispiel Catchpoint.

Hinweis: Die Einstellung visitorApiTimeout stellt sicher, dass Target nicht zu lange auf die Antwort der Besucher-API wartet. Diese Einstellung und die hier beschriebene Timeout-Einstellung für at.js beeinflussen sich nicht gegenseitig.

Profile Lifetime

Mit dieser Einstellung legen Sie fest, wie lange Besucherprofile gespeichert werden. Profile werden standardmäßig zwei Wochen lang gespeichert. Diese Einstellung kann auf 90 Tage erhöht werden.

Um die Einstellung für die Profillebensdauer zu ändern, wenden Sie sich an Kundenunterstützung.

Wichtigste Implementierungsmethode

NOTE
Adobe Target unterstützt sowohl at.js 1.x und in at.js 2.x. Aktualisieren Sie auf die neueste Version einer der Hauptversionen von at.js, um sicherzustellen, dass Sie eine unterstützte Version ausführen.

Um die gewünschte at.js-Version herunterzuladen, klicken Sie auf die entsprechende Schaltfläche Herunterladen.

Um die at.js-Einstellung zu bearbeiten, klicken Sie Edit neben der gewünschten at.js-Version.

WARNING
Bevor Sie diese Standardeinstellungen ändern, wenden Sie sich an Kundenunterstützung, damit Ihre aktuelle Implementierung nicht beeinträchtigt wird.

Zusätzlich zu den oben erläuterten Einstellungen sind auch die folgenden spezifischen at.js-Einstellungen verfügbar:

Einstellung
Beschreibung
Domain-übergreifend
Für at.js v1.x, geben Sie an, ob domänenübergreifende Funktionen disabled sind (Browser setzen Cookies nur in Ihrer Domain (Erstanbieter-Cookies), x only (Browser setzen Cookies nur in der Domain von Target) oder beides, indem Sie enabled auswählen (Browser setzen sowohl Erstanbieter- als auch Drittanbieter-Cookies). Geben Sie für at.js v2.10 und höher an, ob domänenübergreifende Funktionen enabled (Browser setzen sowohl Cookies von Erstanbietern als auch von Drittanbietern) oder disabled (Browser setzen keine Cookies von Drittanbietern) sind.
Benutzerdefinierte Bibliothekskopfzeile
Fügen Sie benutzerdefiniertes JavaScript hinzu, das oben in der Bibliothek aufgeführt wird.
Benutzerdefinierter Bibliotheksfuß
Fügen Sie benutzerdefiniertes JavaScript hinzu, das unten in der Bibliothek aufgeführt wird.

Profil-API

Aktivieren oder deaktivieren Sie die Authentifizierung für Batch-Aktualisierungen via API und generieren Sie ein Token für die Profilauthentifizierung.

Weitere Informationen finden Sie unter Profil-API-Einstellungen.

Debugger-Tools

Generieren eines Autorisierungstokens zur Verwendung erweiterter Target-Debugging-Tools Klicken Sie auf Generate New Authentication Token.

Neues Authentifizierungstoken erstellen

Datenschutz

Mit diesen Einstellungen können Sie Target in Übereinstimmung mit den geltenden Datenschutzgesetzen verwenden.

Wählen Sie die gewünschte Einstellung aus der Dropdown-Liste Besucher-IP-Adresse verschleiern aus:

  • Verschleierung des letzten Oktetts
  • Verschleierung der gesamten IP
  • Keine

Weitere Informationen finden Sie unter Datenschutz.

NOTE
Die Option „Legacy-Browser-Unterstützung“ war in at.js-Version 0.9.3 und früher verfügbar. Diese Option wurde in at.js, Version 0.9.4, entfernt. Eine Liste der von at.js unterstützten Browser finden Sie unter Unterstützte Browser.
Bei älteren Browsern handelt es sich in der Regel um alte Versionen, die CORS (Cross Origin Resource Sharing) nicht vollständig unterstützen. Solche Browser sind zum Beispiel alle Versionen von Internet Explorer vor Version 11 oder Safari Version 6 und ältere Versionen. Wenn die Unterstützung älterer Browser deaktiviert war, haben Target in Berichten über diese Browser keine Inhalte bereitgestellt oder Besucher gezählt. Wenn diese Option aktiviert war, wird empfohlen, eine Qualitätssicherung in älteren Browsern durchzuführen, um ein gutes Kundenerlebnis zu gewährleisten.

„at.js“ herunterladen

Anweisungen zum Herunterladen der Bibliothek mithilfe der Target oder der Download-API.

NOTE
Adobe Experience Platform ist die bevorzugte Methode zum Implementieren von Target und der at.js-Bibliothek. Die folgenden Informationen sind bei Verwendung von Tags in Adobe Experience Platform zur Implementierung von Target nicht anwendbar.
Adobe Target unterstützt sowohl at.js 1.x und in at.js 2.x. Aktualisieren Sie auf die neueste Version einer der Hauptversionen von at.js, um sicherzustellen, dass Sie eine unterstützte Version ausführen. Weitere Informationen zu den Funktionen in den einzelnen Versionen finden Sie unter „at.js“-Versionsdetails.

Herunterladen von at.js über die Target

Herunterladen von at.js über die Target:

  1. Klicken Sie auf Administration > Implementation.
  2. Klicken Sie im Abschnitt Implementierungsmethoden auf die Schaltfläche Download neben der gewünschten at.js-Version.

Herunterladen von at.js mit der Target Download-API

So laden Sie at.js über die API herunter:

  1. So finden Sie Ihren Clientcode.

    Der Client-Code ist oben auf der Seite Administration > Implementation der Target-Benutzeroberfläche verfügbar.

  2. So finden Sie Ihre Administratornummer.

    Laden Sie diese URL:

    https://admin.testandtarget.omniture.com/rest/v1/endpoint/<varname>client code</varname>

    Ersetzen Sie client code durch den Clientcode aus Schritt 1.

    Das Ergebnis nach dem Laden dieser URL sollte in etwa wie im folgenden Beispiel aussehen:

    {
  "api": "https://admin6.testandtarget.omniture.com/admin/rest/v1"
}

    In diesem Beispiel lautet die Administratornummer „6“.

  3. at.js herunterladen.

    Laden Sie diese URL mit der folgenden Struktur. Durch Laden dieser URL wird der Download Ihrer benutzerdefinierten at.js-Datei gestartet.

    https://admin<varname>admin number</varname>.testandtarget.omniture.com/admin/rest/v1/libraries/atjs/download?client=<varname>client code</varname>&version=<version number>
    • Ersetzen Sie admin number durch Ihre Administratornummer.
    • Ersetzen Sie client code durch den Clientcode aus Schritt 1.
    • Ersetzen Sie version number durch die gewünschte at.js-Versionsnummer (z. B. 2.2).
WARNING
Das Target-Team verwaltet nur zwei Versionen von at.js - die aktuelle Version und die zweitneueste Version. Bitte aktualisieren Sie at.js nach Bedarf, um sicherzustellen, dass Sie eine unterstützte Version ausführen. Weitere Informationen zu den Funktionen in den einzelnen Versionen finden Sie unter „at.js“-Versionsdetails.

at.js-Implementierung

at.js sollte im <head>-Element jeder Seite Ihrer Website implementiert werden.

Eine typische Implementierung von Target, die keinen Tag-Manager verwendet, z. B. Tags in Adobe Experience Platform sieht wie folgt aus:

<!doctype html>
<html>
<head>
    <meta charset="utf-8">
    <title>Title of the Page</title>
    <!--Preconnect and DNS-Prefetch to improve page load time-->
    <link rel="preconnect" href="//<client code>.tt.omtrdc.net">
    <link rel="dns-prefetch" href="//<client code>.tt.omtrdc.net">
    <!--/Preconnect and DNS-Prefetch-->
    <!--Data Layer to enable rich data collection and targeting-->
    <script>
        var digitalData = {
            "page": {
                "pageInfo": {
                    "pageName": "Home"
                }
            }
        };
    </script>
    <!--/Data Layer-->
    <!-- targetPageParams(), targetPageParamsAll(), Data Providers or targetGlobalSettings() functions to enrich the visitor profile or modify the library settings-->
    <script>
        targetPageParams = function() {
            return {
                "a": 1,
                "b": 2,
                "pageName": digitalData.page.pageInfo.pageName,
                "profile": {
                    "age": 26,
                    "country": {
                        "city": "San Francisco"
                    }
                }
            };
        };
    </script>
    <!--/targetPageParams()-->

    <!--jQuery or other helper libraries should be implemented before at.js if you would like to use their methods in Target-->
    <script src="jquery-3.3.1.min.js"></script>
    <!--/jQuery-->
    <!--Target's JavaScript SDK, at.js-->
    <script src="at.js"></script>
    <!--/at.js-->
</head>
<body>
    The default content of the page
</body>
</html>

Beachten Sie folgende wichtige Hinweise:

  • Verwenden Sie den Doctype HTML5 (z. B. <!doctype html>). Nicht unterstützte oder ältere Doctypes konnten dazu führen, dass Target keine Anfrage stellen konnten.
  • Mit den Optionen zum Vorabladen und Vorabruf können Sie die Seitenladezeiten reduzieren. Wenn Sie diese Konfigurationen verwenden, stellen Sie sicher, dass Sie <client code> durch Ihren eigenen Client-Code ersetzen, den Sie auf der Seite Administration > Implementation erhalten können.
  • Wenn Sie über einen Daten-Layer verfügen, empfiehlt es sich, einen möglichst großen Teil im <head> Ihrer Seiten zu definieren, bevor „at.js“ geladen wird. Diese Platzierung bietet die maximale Möglichkeit, diese Informationen in Target für die Personalisierung zu verwenden.
  • Spezielle Target wie targetPageParams(), targetPageParamsAll(), Datenanbieter und targetGlobalSettings() sollten nach dem Laden Ihrer Datenschicht und vor dem Laden von at.js definiert werden. Alternativ können diese Funktionen auch im Abschnitt Bibliothekskopfzeile der Seite at.js-Einstellungen bearbeiten gespeichert und als Teil der at.js-Bibliothek selbst gespeichert werden. Weitere Informationen zu diesen Funktionen finden Sie unter at.js-Funktionen.
  • Wenn Sie JavaScript-Hilfsbibliotheken wie jQuery verwenden, schließen Sie diese vor dem Target ein, damit Sie beim Erstellen Target Erlebnisse deren Syntax und Methoden verwenden können.
  • Fügen Sie „at.js“ im <head> Ihrer Seiten hinzu.

Konversionen verfolgen

Mit der Mbox für Auftragsbestätigungen werden Informationen zu Bestellungen auf Ihrer Seite gesammelt und die Berichterstellung basierend auf Umsatz und Aufträgen ermöglicht. Mit der Mbox für Auftragsbestätigungen können zudem Empfehlungsalgorithmen abgeleitet werden, beispielsweise „Personen, die x kauften, kauften auch y“.

NOTE
Wenn Benutzer auf Ihrer Website Einkäufe tätigen, empfiehlt Adobe die Implementierung einer Mbox für Auftragsbestätigungen, auch wenn Sie Analytics for Target (A4T) für Ihr Reporting verwenden.

  1. Fügen Sie auf Ihrer Bestellungsdetailseite das Mbox-Skript ein. Befolgen Sie dabei das folgende Modell:

  2. Ersetzen Sie die WORTE IN GROSSBUCHSTABEN entweder durch dynamische oder statische Werte aus Ihrem Katalog.

    TIP
    Sie können Bestellungsinformationen auch in jeder Mbox übergeben (sie muss nicht orderConfirmPage benannt werden). Darüber hinaus können Bestellinformationen auch an mehrere Mboxes innerhalb derselben Kampagne weitergegeben werden.
    <script type="text/javascript">
adobe.target.trackEvent({
    "mbox": "orderConfirmPage",
    "params":{
        "orderId": "ORDER ID FROM YOUR ORDER PAGE",
        "orderTotal": "ORDER TOTAL FROM YOUR ORDER PAGE",
        "productPurchasedId": "PRODUCT ID FROM YOUR ORDER PAGE, PRODUCT ID2, PRODUCT ID3"
    }
});
</script>
NOTE
Trennen Sie in der Mbox für Bestellbestätigungen mehrere Produkt-IDs durch Kommas.

Die Mbox für die Auftragsbestätigung verwendet die folgenden Parameter:

Parameter
Beschreibung
orderId

Eindeutiger Wert zur Identifizierung einer Bestellung für die Konversionszählung.

Die orderId muss eindeutig sein. Doppelte Bestellungen werden in Berichten ignoriert.

orderTotal

Geldwert des Einkaufs.

Übergeben Sie den Wert ohne Währungssymbol. Verwenden Sie einen Dezimalpunkt (kein Komma), um die Dezimalwerte anzugeben.

productPurchasedId (optional)

Kommagetrennte Liste von Produkt-IDs, die innerhalb der Bestellung gekauft wurden.

Diese Produkt-IDs werden im Audit-Bericht angezeigt, um zusätzliche Berichtsanalysen zu unterstützen.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3