Antwort-Token

Mithilfe von Antworttoken können Sie automatisch Informationen ausgeben, die speziell für Target (Aktivität, Benutzerinformationen, Geo-Informationen usw.) gelten und zum Debugging oder zur Integration mit Drittanbietersystemen (z. B. Clicktale) verwendet werden.

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. Antwort-Token funktionieren auch im Vorschau-Modus.

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.

HINWEIS

Antwort-Token sind mit at.js 1.1 oder höher verfügbar.

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 Plugins werden bei der Verwendung von mbox.js 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. Klicken Sie in Target auf Administration > Antwort-Token.

  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. Beispielsweise enthält die zweite Anforderung auf einer Seite mit zwei Target-Anforderungen, die zwei verschiedene Aktivitäten bereitstellen, beide Aktivitäten.
    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 Aktivitäten mit automatischer Zielgruppe und Automated Personalization.)
    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.

    HINWEIS

    Parameter mit Sonderzeichen werden in der Liste nicht angezeigt. Es werden nur alphanumerische Zeichen und Unterstriche unterstützt.

  4. (Bedingt) Wenn Sie einen Profil-Parameter als Antwort-Token verwenden möchten, der Parameter jedoch nicht über eine Target-Anforderung weitergeleitet wurde und daher nicht in die Benutzeroberfläche der Zielgruppe geladen wurde, können Sie das Profil mit der Schaltfläche Hinzufügen Antwort-Token zur Benutzeroberfläche hinzufügen.

    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.

Verwenden Sie die benutzerdefinierten Ereignis at.js, um die Antwort Target anzuhören und die Antwort-Token zu lesen.

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?

Die Antwort-Token werden an die Antworten auf die at.js-Zielgruppe gesendet, nicht jedoch an die Antworten auf mbox.js.

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 alle Target Antworten oder nur durch Target Antworten bereitgestellt, die eine Aktivität liefern?

Antworttoken werden nur durch Target-Antworten bereitgestellt, die eine Aktivität liefern.

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 Tutorialzeichen

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.

HINWEIS

Die Menüoberfläche Target Administration (ehemals Setup) wurde überarbeitet, um eine verbesserte Leistung zu bieten, die Wartungszeit zu verkürzen, die bei der Veröffentlichung neuer Funktionen erforderlich ist, und die Benutzererfahrung 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.

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