Target ohne Tag-Manager implementieren

Informationen zur Implementierung von Adobe Target ohne Verwendung eines Tag-Managers (Adobe Experience Platform Launch).

HINWEIS

Adobe Experience Platform Launchis ist die bevorzugte Methode zum Implementieren von Zielgruppe und der at.js-Bibliothek. Die folgenden Informationen gelten nicht, wenn Adobe Platform launch zur Implementierung der Zielgruppe verwendet wird.

Um die Seite Implementierung aufzurufen, klicken Sie auf Administration > Implementierung.

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

  • Kontodetails
  • Implementierungsmethoden
  • Profil-API
  • Debugger-Tools
  • Datenschutz
HINWEIS

Sie können Einstellungen der „at.js“-Bibliothek überschreiben, anstatt die Einstellungen in der Oberfläche von Target Standard/Premium oder durch Verwendung von REST-APIs zu bearbeiten. Weitere Informationen finden Sie unter targetGlobalSettings().

Kontodetails

Die folgenden Kontodetails können Ansicht werden. Diese Einstellungen können nicht geändert werden.

Einstellung Beschreibung
Clientcode Der Clientcode ist eine clientspezifische Folge von Zeichen, die oft benötigt wird, wenn die Target-APIs zum Einsatz kommen.
IMS-Organisations-ID Diese ID ordnet Ihre Implementierung Ihrem Adobe Experience Cloud-Konto zu.
Geräteinterne Entscheidungsfindung Schieben Sie den Umschalter an die Position "Ein", um die Entscheidung auf dem Gerät zu aktivieren.
Mit der On-Device-Entscheidungsfindung können Sie Ihre A/B- und Erlebnis-Targeting (XT)-Kampagnen auf Ihrem Server zwischenspeichern und Speicherentscheidungen mit einer Latenz von nahezu null durchführen. Weitere Informationen finden Sie unter Einführung in die geräteinterne Entscheidungsfindung im Handbuch Adobe Target SDKs.
Schließen Sie alle vorhandenen qualifizierten Aktivitäten für die geräteinterne Entscheidungsfindung in das Artefakt ein. (Bedingt) Diese Option wird angezeigt, wenn Sie die Geräteentscheidung aktivieren.
Schieben Sie den Umschalter an die "An"-Position, wenn alle Aktivitäten der Live-Zielgruppe, die für eine Geräteentscheidung infrage kommen, automatisch in das Artefakt aufgenommen werden sollen.
Wenn Sie diesen Umschalter deaktivieren, müssen Sie alle auf dem Gerät befindlichen Entscheidungsfunktionen neu erstellen und aktivieren, damit sie in das Artefakt der generierten Aktivitäten aufgenommen werden.

Implementierungsmethoden

Die folgenden Einstellungen können im Bereich "Implementierungsmethoden"konfiguriert werden:

Globale Einstellungen

HINWEIS

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
Seitenladung aktiviert (globale Mbox automatisch erstellen) 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.
Globale Mbox Wählen Sie einen Namen für die globale Mbox aus. Der Standardname lautet target-global-mbox.
Sonderzeichen wie das kaufmännische Und (&) können mit at.js für Mbox-Namen verwendet werden.
Timeout (Sekunden) 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 Bibliothek at.js verwendet die Timeout-Einstellung in XMLHttpRequest. Der Timeout beginnt, wenn die Anforderung ausgelöst wird, und endet, wenn Target eine Antwort von dem Server erhält. Weitere Informationen dazu finden Sie unter XMLHttpRequest.timeout im Mozilla Developer Network.
Tritt der festgelegte Timeout vor Erhalt der Antwort ein, wird dem Besucher ein Standardinhalt angezeigt, und der Besucher wird möglicherweise als Teilnehmer in einer Aktivität gezählt, da die gesamte Datenerfassung am Target-Edge erfolgt. Erreicht die Anforderung den Target-Edge, 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.
Profillebensdauer Mit dieser Einstellung legen Sie fest, wie lange Besucherprofile gespeichert werden. Profile werden standardmäßig zwei Wochen lang gespeichert. Diese Einstellung kann auf bis zu 90 Tage erhöht werden.
Wenden Sie sich an den Kundendienst, wenn Sie die Profillebensdauer ändern möchten.

Wichtigste Implementierungsmethode

WICHTIG

Das Zielgruppe-Team unterstützt "at.js 1".x und at.js 2.x. Aktualisieren Sie auf das neueste Update 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 at.js-Einstellungen zu bearbeiten, klicken Sie auf Bearbeiten neben der gewünschten at.js-Version.

WICHTIG

Bevor Sie diese Standardeinstellungen ändern, wenden Sie sich bitte an den Kundendienst, damit Sie keine Auswirkungen auf Ihre aktuelle Implementierung haben.

Zusätzlich zu den oben erläuterten Einstellungen stehen die folgenden spezifischen at.js-Einstellungen zur Verfügung:

Einstellung Beschreibung
Benutzerdefinierte Bibliothekskopfzeile Fügen Sie benutzerdefiniertes JavaScript hinzu, das oben in der Bibliothek aufgeführt wird.
Benutzerdefinierte Bibliotheksfußzeile 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

Erstellen Sie ein Autorisierungstoken, um erweiterte Debuggingwerkzeuge zu verwenden. Target Klicken Sie auf Neues Authentifizierungstoken erstellen.

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 IP-Adresse des Besuchers verschleiern:

  • Verwirrung des letzten Oktetts
  • Gesamte IP-Verschleierung
  • Keine

Weitere Informationen finden Sie unter Datenschutz.

HINWEIS

Die Option "Unterstützung älterer Browser"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, stellte Zielgruppe keine Inhalte bereit oder zählte keine Besucher in Berichten in diesen Browsern. Wenn diese Option aktiviert wurde, wird empfohlen, eine Qualitätssicherung in allen älteren Browsern durchzuführen, um eine gute Kundenerfahrung sicherzustellen.

„at.js“ herunterladen

Anweisungen zum Herunterladen der Bibliothek mit der Target-Schnittstelle oder der Download-API.

HINWEIS
  • Adobe Experience Platform Launchis ist die bevorzugte Methode zum Implementieren von Zielgruppe und der at.js-Bibliothek. Die folgenden Informationen gelten nicht, wenn Adobe Platform launch zur Implementierung der Zielgruppe verwendet wird.

  • Das Zielgruppe-Team unterstützt "at.js 1".x und at.js 2.x. Bitte aktualisieren Sie auf das neueste Update 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.

at.js mit der Target-Schnittstelle herunterladen

So können Sie at.js über die Target-Oberfläche herunterladen:

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

at.js mit der Target Download-API herunterladen

So laden Sie at.js mithilfe der API herunter.

  1. So finden Sie Ihren Clientcode.

    Ihr Client-Code ist oben auf der Seite Administration > Implementierung der Target-Schnittstelle 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. Download at.js.

    Laden Sie diese URL mit der folgenden Struktur:

    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).
    WICHTIG

    Das Target-Team pflegt nur zwei Versionen von at.js – die aktuelle Version und die zweitneueste Version. Führen Sie bei Bedarf ein Upgrade von at.js durch, 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.

    Wenn Sie diese URL laden, wird der Download Ihrer angepassten at.js-Datei initiiert.

at.js-Implementierung

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

Eine typische Implementierung von Zielgruppe, die keinen Tag-Manager wie Adobe Platform launch verwendet, 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="//%3Cclient%20code%3E.tt.omtrdc.net?lang=de"> 
    <link rel="dns-prefetch" href="//%3Cclient%20code%3E.tt.omtrdc.net?lang=de"> 
    <!--/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:

  • Der HTML5-Dokumenttyp (z. B. <!doctype html>) sollte verwendet werden. Nicht unterstützte oder ältere Doctypes können dazu führen, dass Target keine Anfragen senden kann.
  • 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 Clientcode ersetzen, den Sie auf der Seite Administration > **Implementierung abrufen 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 Zielgruppe für die Personalisierung zu verwenden.
  • Spezielle Funktionen wie z. B. targetPageParams(), targetPageParamsAll(), Datenanbieter und targetGlobalSettings() sollten definiert werden, nachdem Sie Ihren Daten-Layer definiert haben und bevor „at.js“ geladen wird. Alternativ können diese Funktionen 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 der Zielgruppe ein, damit Sie ihre Syntax und Methoden beim Erstellen von Zielgruppen verwenden können.
  • Fügen Sie „at.js“ im <head> Ihrer Seiten hinzu.

Verfolgen von Konvertierungen

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“.

HINWEIS

Wenn Benutzer auf Ihrer Website Einkäufe tätigen, empfiehlt Adobe die Implementierung einer Auftragsbestätigungs-mbox, auch wenn Sie Analytics für die Zielgruppe (A4T) für Ihren Berichte 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.

    HINWEIS

    Trennen Sie mehrere Produkt-IDs mithilfe von Kommas.

    Tipp: Sie können Informationen auch in beliebigen anderen Mboxes senden (sie müssen nicht orderConfirmPage genannt 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> 
    

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.
orderId muss eindeutig sein. Doppelte Bestellungen werden in Berichten ignoriert.
orderTotal Geldwert des Einkaufs.
Das Währungssymbol wird nicht übergeben. 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 die zusätzliche Berichtanalyse zu unterstützen.

Auf dieser Seite

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now