Show Menu
THEMEN×

Antwort-Token

Response tokens let you automatically output information specific to Target (activity details, user profile information, geo information, and so forth) to use in debugging or integrating with 3rd-party systems (such as Clicktale).
Mithilfe von Antworttoken können Sie festlegen, welche Variablen genutzt werden sollen, und dann ermöglichen, dass sie als Teil einer Zielgruppe-Antwort gesendet werden. Dazu aktivieren Sie einfach eine Variable mit dem Switch und die Variable wird mit Zielgruppe-Antworten gesendet, die in Netzwerkaufrufen validiert werden können. Response tokens work in Preview mode as well.
Ein wesentlicher Unterschied zwischen Plug-ins und Antwort-Token besteht darin, dass Plug-ins JavaScript für die Seite bereitstellen, das bei Bereitstellung ausgeführt wird, wohingegen Antwort-Token ein Objekt bereitstellen, das anschließend gelesen und auf das mithilfe von Ereignislistenern reagiert werden kann. Weitere Informationen finden Sie unter Benutzerdefinierte at.js-Ereignisse und in den Beispielen im späteren Verlauf dieses Artikels. Der Ansatz der Antwort-Token ist sicherer und ermöglicht eine problemlosere Bereitstellung und Wartung von Drittanbieterintegrationen.
Antwort-Token sind mit at.js 1.1 oder höher verfügbar. mbox.js unterstützt keine Antwort-Token.
Verwendete Target-Bibliothek
Empfohlene Aktionen
at.js
Stellen Sie sicher, dass Sie at.js der Version 1.1 oder neuer verwenden. Weitere Informationen zum Herunterladen der neuesten Version von at.js finden Sie unter Herunterladen von „at.js“ . Weitere Informationen zu neuen Funktionen in den einzelnen Versionen von at.js finden Sie unter „at.js“-Versionsdetails .
Kunden, die at.js verwenden, sollten Antwort-Token nutzen und auf Plug-ins verzichten. Einige Plug-ins, die auf internen Methoden basieren, die in mbox.js, aber nicht in at.js vorhanden sind, werden zwar bereitgestellt, sie schlagen jedoch fehl. Weitere Informationen finden Sie unter Einschränkungen von „at.js“ .
mbox.js
Bei der Verwendung von mbox.js werden Plug-ins weiterhin unterstützt und bereitgestellt.
Kunden, die mit mbox.js und Plug-ins arbeiten, sollten jedoch stattdessen at.js und Antwort-Token verwenden. Weitere Informationen zu den Vorteilen von at.js im Vergleich zu mbox.js finden Sie unter Häufig gestellte Fragen zu at.js . Weitere Informationen zum Migrieren finden Sie unter Migration von „mbox.js“ zu „at.js“ .
Nach der Einstellung von Target Classic (November 2017) müssen Sie sich möglicherweise an den Kundendienst wenden, um vorhandene Plug-ins bearbeiten oder deaktivieren zu können. Sie sollten Ihre Plug-ins geprüft haben, bevor Target Classic veraltet war und unerwünschte Plug-ins deaktiviert wurden.
Sie können keine neuen Plug-ins in Target Standard/Premium erstellen. Verwenden Sie stattdessen Antwort-Token.
Alte SiteCatalyst-Plug-ins sollten deaktiviert und durch Adobe Analytics als Berichtsquelle für Adobe Target (A4T) ersetzt werden. Das ttMeta-Plugin sollte deaktiviert und durch Adobe Experience Cloud Debugger ersetzt werden.

Verwenden von Antwort-Token

  1. Stellen Sie sicher, dass Sie at.js der Version 1.1 oder neuer verwenden.
    Weitere Informationen finden Sie unter at.js herunterladen .
  2. In Target, click Administration > Response Tokens .
  3. Aktivieren Sie die gewünschten Antwort-Token wie activity.id , option.id usw.
    Die folgenden Parameter sind standardmäßig verfügbar:
    Typ
    Parameter
    Hinweise
    Integrierte Profile
    profile.activeActivities
    Gibt eine Reihe an activityIds aus, für die der Besucher qualifiziert ist. Die Inkrementierung erfolgt im Zuge der Benutzerqualifizierung. For example, on a page with two Target requests delivering two different activities, the second request includes both activities.
    profile.isFirstSession
    Gibt „true“ oder „false“ zurück.
    profile.isNewSession
    Gibt „true“ oder „false“ zurück.
    profile.daysSinceLastVisit
    Gibt die Anzahl der Tage seit dem letzten Zugriff des Besuchers zurück.
    profile.tntId
    Gibt die tntID des Besuchers zurück.
    profile.marketingCloudVisitorId
    Gibt die Experience Cloud-ID des Besuchers zurück.
    profile.thirdPartyId
    Gibt die Drittanbieter-ID des Besuchers zurück.
    profile.categoryAffinity
    Gibt die Lieblingskategorie des Besuchers zurück.
    profile.categoryAffinities
    Gibt eine Reihe der Top-5-Kategorien des Besuchers als Zeichenfolgen zurück.
    Aktivität
    activity.name
    activity.id
    experience.name
    experience.id
    option.name
    option.id
    Details der aktuellen Aktivität. Beachten Sie, dass „option“ und „offer“ gleich sind.
    Geo
    geo.country
    geo.state
    geo.city
    geo.zip
    geo.dma
    geo.domainName
    geo.ispName
    geo.connectionSpeed
    geo.mobileCarrier
    Weitere Informationen zur Verwendung von Geo-Targeting in Aktivitäten finden Sie unter Geo .
    Traffic-Zuordnungsmethode
    (gilt nur für Auto-Zielgruppe - und Automated Personalization -Aktivitäten.)
    experience.trafficAllocationId
    Gibt 0 zurück, wenn ein Besucher ein Erlebnis aus dem "Kontroll"-Traffic erhalten hat, und 1, wenn ein Besucher ein Erlebnis aus der "zielgerichteten" Traffic-Verteilung erhalten hat.
    experience.trafficAllocationType
    Gibt "Kontrolle"oder "Targeting"zurück.
    Benutzerprofil- und Kundenattribute werden ebenfalls in der Liste angezeigt.
    Parameter mit Sonderzeichen werden in der Liste nicht angezeigt. Es werden nur alphanumerische Zeichen und Unterstriche unterstützt.
  4. (Conditional) If you want to use a profile parameter as a response token, but the parameter has not been passed through a Target request and, thus, has not loaded into the Target UI, you can use the Add Response Token button to add the profile to the UI.
    Klicken Sie auf Hinzufügen Antwort-Token , geben Sie den Token-Namen ein und klicken Sie dann auf Aktivieren .
  5. Erstellen Sie eine Aktivität.
Use at.js custom events to listen for the Target response and read the response tokens.
Mit dem folgenden Code-Beispiel wird direkt ein benutzerdefinierter at.js-Eventhandler auf der HTML-Seite hinzugefügt:
<html> 
  <head> 
    .... 
    <script src="at.js"></script> 
    <script> 
      document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) { 
        console.log("Request succeeded", e.detail); 
      }); 
    </script> 
  <head> 
  <body> 
  ... 
  </body> 
</html>

Die folgenden Anweisungen zeigen, wie Sie mit dem dynamischer Tag-Manager (DTM) einen benutzerdefinierten at.js-Eventhandler hinzufügen:
  1. Anmelden in DTM.
  2. Gehen Sie zur gewünschten Eigenschaft.
  3. Öffnen Sie das Target-Tool.
    Da DTM keine native Unterstützung für at.js bietet, müssen Sie den Code-Editor verwenden.
  4. Hängen Sie im Code-Editor den folgenden Code an at.js an:
    document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) { 
      console.log("Request succeeded", e.detail); 
    });
    
    
Sie können das folgende Snippet zur at.js-Setupseite der Bibliotheksfußzeile hinzufügen, wenn Sie alles in einer Datei haben möchten.
document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) { 
  console.log("Request succeeded", e.detail); 
});

Häufig gestellte Fragen zu Antwort-Token

Welche Rolle wird zum Aktivieren oder Deaktivieren von Antwort-Token benötigt?
Antwort-Token können nur von Benutzern mit der Target-Admin-Rolle aktiviert oder deaktiviert werden.
Was geschieht, wenn ich at.js 1.0 oder niedriger verwende?
Die Antwort-Token werden zwar angezeigt, at.js kann sie jedoch nicht verwenden.
Was geschieht, wenn ich at.js 1.1 (oder neuer) auf einigen Seiten meiner Site verwende, während ich auf anderen Seiten mbox.js nutze?
Response tokens will be delivered to the at.js Target responses, but not to the mbox.js responses.
Können Target Classic-Plug-ins und Antwort-Token gleichzeitig aktiv sein?
Plug-ins und Antwort-Token sind parallel verfügbar, Plug-ins werden jedoch in der Zukunft eingestellt.
Werden Antworttoken durch alleTargetAntworten oder nur durchTargetAntworten bereitgestellt, die eine Aktivität liefern?
Response tokens are delivered only through Target responses delivering an activity.
Mein Target Classic-Plug-in beinhaltet JavaScript. Wie reproduziere ich diese Funktionalität mithilfe von Antwort-Token?
Bei der Migration zu Antwort-Token muss dieser JavaScript-Typ in Ihrer Codebase oder der Tag-Management-Lösung beibehalten werden. Sie können diesen Code mithilfe von benutzerdefinierten at.js-Ereignissen auslösen und die Antwort-Token-Werte an Ihre JavaScript-Funktionen übergeben.
Warum wird mein Profil-/Kundenattribut-Parameter nicht in der Liste der Antwort-Token angezeigt?
Target aktualisiert die Parameter normalerweise aller 15 Minuten. Diese Aktualisierung ist von der Benutzeraktion abhängig, und die Daten werden nur dann aktualisiert, wenn Sie die Antwort-Token-Seite anzeigen. Wenn Ihre Parameter nicht in der Antwort-Token-Liste angezeigt werden, kann die Ursache dafür sein, dass Target die Daten noch nicht aktualisiert hat.
Wenn Ihr Parameter etwas anderes als nicht-alphanumerische Zeichen oder andere Symbole als Unterstriche enthält, wird der Parameter nicht in der Liste angezeigt. Momentan werden nur alphanumerische Zeichen und Unterstriche unterstützt.
Stellt der Antwort-Token weiterhin Inhalt bereit, wenn ich ein Antwort-Token mit einem Profilskript oder Profilparameter erstelle und dieses Profilskript oder diesen Parameter dann lösche?
Antwort-Token extrahieren Informationen aus Benutzerprofilen und stellen diese Informationen dann bereit. Wenn Sie ein Profilskript oder einen Profilparameter löschen, heißt das nicht, dass die Informationen aus den Benutzerprofilen entfernt wurden. Die Benutzerprofile enthalten weiterhin Daten, die dem Profilskript entsprechen. Das Antwort-Token stellt weiterhin den Inhalt bereit. Dieses Token wird nicht für neue Besucher oder Benutzer bereitgestellt, die diese Informationen nicht in ihren Profilen gespeichert haben, weil die Daten nicht in den Profilen vorhanden sind.
Target deaktiviert das Token nicht automatisch. Wenn Sie ein Profilskript löschen und das Token nicht mehr bereitgestellt werden soll, müssen Sie das Token selbst deaktivieren.
Ich habe mein Profilskript umbenannt. Warum ist das Token, das dieses Skript verwendet, weiterhin mit dem alten Namen aktiv?
Wie zuvor erwähnt, agieren Antwort-Token mit den für Benutzer gespeicherten Profilinformationen. Obwohl Sie Ihr Profilskript umbenannt haben, ist für Benutzer, die Ihre Website besucht haben, der alte Profilskriptwert in deren Profilen gespeichert. Das Token ruft weiterhin den alten Wert auf, der bereits in den Benutzerprofilen gespeichert ist. Wenn Sie den Inhalt nun für den neuen Namen bereitstellen möchten, müssen Sie das vorherige Token deaktivieren und das neue Token aktivieren.
Wann werden meine Attribute aus der Liste entfernt, wenn sie sich geändert haben?
Target führt in regelmäßigen Abständen eine Aktualisierung der Attribute durch. Nicht aktivierte Attribute werden bei der nächsten Aktualisierung entfernt. Wenn jedoch ein Attribut vorhanden ist, das aktiviert und entfernt wurde (wenn Sie beispielsweise ein als Token verwendetes Profilskript entfernt haben), wird dieses Skript erst nach dessen Deaktivierung aus der Attributliste entfernt. Target entfernt die deaktivierten Attribute erst aus der Liste, wenn sie gelöscht oder umbenannt werden.

Senden von Daten an Google Analytics via at.js

Daten können via at.js an Google Analytics gesendet werden, indem Sie auf der HTML-Seite den folgenden Code hinzufügen:
<script type="text/javascript"> 
  (function(i, s, o, g, r, a, m) { 
    i['GoogleAnalyticsObject'] = r; 
    i[r] = i[r] || function() { 
      (i[r].q = i[r].q || []).push(arguments) 
    }, i[r].l = 1 * new Date(); 
    a = s.createElement(o), 
      m = s.getElementsByTagName(o)[0]; 
    a.async = 1; 
    a.src = g; 
    m.parentNode.insertBefore(a, m) 
  })(window, document, 'script', 'https://www.google-analytics.com/analytics.js', 'ga'); 
  ga('create', 'Google Client Id', 'auto'); 
</script> 
 
<script type="text/javascript"> 
  document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) { 
    var tokens = e.detail.responseTokens; 
 
    if (isEmpty(tokens)) { 
      return; 
    } 
 
    var activityNames = []; 
    var experienceNames = []; 
    var uniqueTokens = distinct(tokens); 
 
    uniqueTokens.forEach(function(token) { 
      activityNames.push(token["activity.name"]); 
      experienceNames.push(token["experience.name"]); 
    }); 
 
    ga('send', 'event', { 
      eventCategory: "target", 
      eventAction: experienceNames, 
      eventLabel: activityNames 
    }); 
  }); 
 
  function isEmpty(val) { 
    return (val === undefined || val == null || val.length <= 0) ? true : false; 
  } 
 
  function key(obj) { 
     return Object.keys(obj) 
    .map(function(k) { return k + "" + obj[k]; }) 
    .join(""); 
  } 
 
  function distinct(arr) { 
    var result = arr.reduce(function(acc, e) { 
      acc[key(e)] = e; 
      return acc; 
    }, {}); 
   
    return Object.keys(result) 
    .map(function(k) { return result[k]; }); 
  } 
</script>

Debugging (ähnelt dem ttMeta-Plug-in)

Das Äquivalent des ttMeta-Plug-ins für Debugging-Zwecke kann durch Hinzufügen des folgenden Codes zu der HTML-Seite erstellt werden:
<script type="text/javascript" > 
  document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function (e) { 
    window.ttMETA= typeof(window.ttMETA)!="undefined" ? window.ttMETA : []; 
 
    var tokens=e.detail.responseTokens; 
 
    if (isEmpty(tokens)) { 
      return; 
    } 
     
    var uniqueTokens = distinct(tokens); 
 
    uniqueTokens.forEach(function(token) { 
      window.ttMETA.push({ 
        'CampaignName': token["activity.name"], 
        'CampaignId' : token["activity.id"], 
        'RecipeName': token["experience.name"], 
        'RecipeId': token["experience.id"], 
        'OfferId': token["option.id"], 
        'OfferName': token["option.name"], 
        'MboxName': e.detail.mbox}); 
      console.log(ttMETA); 
    }); 
  }); 
 
  function isEmpty(val){ 
    return (val === undefined || val == null || val.length <= 0) ? true : false; 
  } 
 
  function key(obj) { 
     return Object.keys(obj) 
    .map(function(k) { return k + "" + obj[k]; }) 
    .join(""); 
  } 
 
  function distinct(arr) { 
    var result = arr.reduce(function(acc, e) { 
      acc[key(e)] = e; 
      return acc; 
    }, {}); 
   
    return Object.keys(result) 
    .map(function(k) { return result[k]; }); 
  } 
</script>

Schulungsvideo: Antwort-Token und benutzerdefinierte at.js-Ereignisse

Sehen Sie sich das folgende Video an, um zu erfahren, wie Sie Antwort-Token und benutzerspezifische at.js-Ereignisse verwenden können, um Profilinformationen aus Target an Drittanbietersysteme zu übergeben.
Die Benutzeroberfläche des Target Administrationsmenüs (früher Setup ) wurde überarbeitet, um die Leistung zu verbessern, die Wartungszeit bei der Veröffentlichung neuer Funktionen zu verkürzen und die Benutzerfreundlichkeit im gesamten Produkt zu verbessern. Die Informationen im folgenden Video sind im Allgemeinen korrekt. Die Optionen befinden sich jedoch möglicherweise an etwas anderen Orten. Aktualisierte Videos werden demnächst veröffentlicht.