Implementieren von Target ohne einen Tag-Manager
Informationen zur Implementierung von Adobe Target ohne Verwendung eines Tag-Managers oder von Tags in Adobe Experience Platform.
Um auf die Implementierungsseite zuzugreifen, klicken Sie auf Administration > Implementation.
Sie können die folgenden Einstellungen auf dieser Seite angeben:
- Kontodetails
- Implementierungsmethoden
- Profil-API
- Debugger-Tools
- Datenschutz
Kontodetails
Sie können die folgenden Kontodetails anzeigen. Diese Einstellungen können nicht geändert werden.
Um die Entscheidungsfindung auf dem Gerät zu aktivieren, schieben Sie den Umschalter in die Position "Ein".
Mit der Entscheidungsfindung auf dem Gerät können Sie Ihre A/B- und Erlebnis-Targeting-Kampagnen (XT) auf Ihrem Server zwischenspeichern und speicherinterne Entscheidungen bei nahezu null Latenz treffen. Weitere Informationen finden Sie unter Einführung in die Entscheidungsfindung auf dem Gerät.
(Bedingt) Diese Option wird angezeigt, wenn Sie die Entscheidungsfindung auf dem Gerät aktivieren.
Schalten Sie den Umschalter in die "Ein"-Position, wenn Sie möchten, dass alle Ihre Live-Aktivitäten mit dem Status "Target", die für die Entscheidungsfindung auf dem Gerät geeignet sind, automatisch in das Artefakt einbezogen werden.
Wenn Sie diesen Umschalter deaktivieren, 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 Bereich Implementierungsmethoden konfiguriert werden:
Globale Einstellungen
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 in Mbox-Namen verwendet werden.
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 Timeout-Einstellung in XMLHttpRequest. Die Zeitüberschreitung 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.
Tritt der angegebene Timeout vor Erhalt der Antwort ein, wird Standardinhalt angezeigt und der Besucher wird möglicherweise als Teilnehmer an einer Aktivität gezählt, da die gesamte Datenerfassung am Target -Edge erfolgt. Wenn die Anforderung 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.
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.
Wenden Sie sich an den Kundendienst, um die Profillebensdauer-Einstellung zu ändern.
Wichtigste Implementierungsmethode
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 neben der gewünschten at.js-Version auf Edit .
Zusätzlich zu den oben erläuterten Einstellungen sind auch die folgenden spezifischen at.js-Einstellungen verfügbar:
disabled sind (Browser setzen Cookies nur in Ihrer Domäne (Erstanbieter-Cookies), x only (Browser setzen Cookies nur in der Target-Domäne) oder beide durch Auswahl von enabled (Browser legen sowohl Erst- als auch Drittanbieter-Cookies fest). Geben Sie für at.js v2.10 und höher an, ob domänenübergreifende Funktionen enabled (Browser setzen sowohl Erst- als auch Drittanbieter-Cookies ein) oder disabled (Browser setzen keine Drittanbieter-Cookies ein) sind.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 Sie ein Autorisierungstoken zur Verwendung erweiterter Debuggingwerkzeuge vom Typ Target. Klicken Sie auf Generate New Authentication Token.
Datenschutz
Mit diesen Einstellungen können Sie Target unter Einhaltung der geltenden Datenschutzgesetze verwenden.
Wählen Sie die gewünschte Einstellung aus der Dropdownliste Besucher-IP-Adresse verschleiern aus:
- Verschleierung des letzten Oktetts
- Gesamte IP-Verschleierung
- Keine
Weitere Informationen finden Sie unter Datenschutz.
„at.js“ herunterladen
Anleitung zum Herunterladen der Bibliothek über die Oberfläche von Target oder die Download-API.
at.js über die Target -Oberfläche herunterladen
So laden Sie at.js über die Target -Oberfläche herunter:
- Klicken Sie auf Administration > Implementation.
- Klicken Sie im Abschnitt "Implementierungsmethoden"auf die Schaltfläche Download neben der gewünschten at.js-Version.
"at.js"mit der Target Download-API herunterladen
So laden Sie at.js mithilfe der API herunter.
-
So finden Sie Ihren Clientcode.
Ihr Clientcode ist oben auf der Seite Administration > Implementation der Benutzeroberfläche von Target verfügbar.
-
So finden Sie Ihre Administratornummer.
Laden Sie diese URL:
code language-none https://admin.testandtarget.omniture.com/rest/v1/endpoint/<varname>client code</varname>Ersetzen Sie
client codedurch den Clientcode aus Schritt 1.Das Ergebnis nach dem Laden dieser URL sollte in etwa wie im folgenden Beispiel aussehen:
code language-none { "api": "https://admin6.testandtarget.omniture.com/admin/rest/v1" }In diesem Beispiel lautet die Administratornummer „6“.
-
Laden Sie at.js herunter.
Laden Sie diese URL mit der folgenden Struktur. Beim Laden dieser URL wird der Download Ihrer angepassten at.js-Datei gestartet.
code language-none 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 numberdurch Ihre Administratornummer. - Ersetzen Sie
client codedurch den Clientcode aus Schritt 1. - Ersetzen Sie
version numberdurch die gewünschte at.js-Versionsnummer (z. B. 2.2).
- Ersetzen Sie
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:
- Der Doctype HTML5 (z. B.
<!doctype html>) sollte verwendet werden. Nicht unterstützte oder ältere Dokumenttypen konnten dazu führen, dass Target keine Anfrage stellen 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 von der Seite Administration > Implementation 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 Target zur Personalisierung zu verwenden. - Spezielle Target -Funktionen wie
targetPageParams(),targetPageParamsAll(), Datenanbieter undtargetGlobalSettings()sollten definiert werden, nachdem Sie Ihre Datenschicht 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 sie vor Target ein, damit Sie ihre Syntax und Methoden beim Erstellen von Target-Erlebnissen 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“.
-
Fügen Sie auf Ihrer Bestellungsdetailseite das Mbox-Skript ein. Befolgen Sie dabei das folgende Modell:
-
Ersetzen Sie die WORTE IN GROSSBUCHSTABEN entweder durch dynamische oder statische Werte aus Ihrem Katalog.
note tip TIP Sie können Bestellinformationen auch in jeder beliebigen Mbox weitergeben (sie müssen nicht orderConfirmPageheißen). Darüber hinaus können Bestellinformationen auch an mehrere Mboxes innerhalb derselben Kampagne weitergegeben werden.code language-none <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:
Eindeutiger Wert zur Identifizierung einer Bestellung für die Konversionszählung.
Die orderId muss eindeutig sein. Doppelte Bestellungen werden in Berichten ignoriert.
Geldwert des Einkaufs.
Übergeben Sie den Wert ohne Währungssymbol. Verwenden Sie einen Dezimalpunkt (kein Komma), um die Dezimalwerte anzugeben.
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.