Antwort-Token

Mithilfe von Antwort-Token können Sie Adobe Target-spezifische Informationen automatisch an die Webseite Ihrer Marke ausgeben. Diese Informationen können Details zur Aktivität, zum Angebot, zum Erlebnis, zum Benutzerprofil, zu geografischen Informationen und mehr enthalten. Diese Details bieten zusätzliche Antwortdaten, um sie für interne oder Drittanbieter-Tools freizugeben oder für das Debugging zu verwenden.

Mithilfe von Antwort-Token können Sie festlegen, welche Variablen (in Schlüssel/Wert-Paaren) verwendet werden sollen, und dann aktivieren, dass sie als Teil einer Target-Antwort gesendet werden. Sie aktivieren eine Variable mithilfe des Schalters und die Variable wird mit Target-Antworten gesendet, die in Netzwerkaufrufen validiert werden können. Antwort-Token funktionieren auch im Modus Vorschau .

Ein wichtiger Unterschied zwischen Plug-ins und Antwort-Token besteht darin, dass Plug-ins JavaScript für die Seite bereitstellen, die bei der Bereitstellung ausgeführt wird. Antwort-Token stellen jedoch ein Objekt bereit, das dann gelesen und mithilfe von Ereignis-Listenern bearbeitet werden kann. Der Antwort-Token-Ansatz ist sicherer und ermöglicht eine einfachere Entwicklung und Wartung von Drittanbieter-Integrationen.

HINWEIS

Antwort-Token sind in at.js , Version 1.1 oder neuer verfügbar.

Target SDK Vorgeschlagene Aktionen
Adobe Experience Platform Web SDK Stellen Sie sicher, dass Sie die Platform Web SDK-Version 2.6.0 oder höher verwenden. Informationen zum Herunterladen der neuesten Version des Platform Web SDK finden Sie unter Installieren des SDK im Handbuch Übersicht über das Platform Web SDK . Informationen zu neuen Funktionen in den einzelnen Versionen des Platform Web SDK finden Sie unter Versionshinweise im Handbuch Übersicht über das Platform Web SDK .
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 waren, werden zwar bereitgestellt, schlagen jedoch fehl.

Verwenden von Antwort-Token

  1. Stellen Sie sicher, dass Sie die Platform Web SDK-Version 2.6.0 (oder neuer) oder at.js-Version 1.1 (oder neuer) verwenden.

    Für weitere Informationen:

  2. Klicken Sie in Target auf Administration > Antwort-Token.

  3. Aktivieren Sie die gewünschten Antwort-Token, z. B. activity.id und option.id.

    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. Auf einer Seite mit zwei Target -Anforderungen, die zwei verschiedene Aktivitäten bereitstellen, enthält die zweite Anforderung beispielsweise 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 Automatisches Targeting 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 er ein Erlebnis aus der "gezielten"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 Profilparameter als Antwort-Token verwenden möchten, der Parameter jedoch nicht über eine Target-Anforderung übergeben wurde und daher nicht in die Target-Benutzeroberfläche geladen wurde, können Sie die Schaltfläche Antwort-Token hinzufügen verwenden, um das Profil zur Benutzeroberfläche hinzuzufügen.

    Klicken Sie auf Antwort-Token hinzufügen, geben Sie den Namen des Tokens ein und klicken Sie dann auf Aktivieren.

  5. Erstellen Sie eine Aktivität.

Antworten und Antwort-Token lesen

Der Prozess, mit dem Sie auf Target-Antworten und Antwort-Token warten, hängt davon ab, ob Sie über eine Platform Web SDK- oder at.js-Implementierung verfügen.

Adobe Experience Platform Web SDK- Platform Web SDK Badgeusing the Handle object class

Verwenden Sie die Handle-Objektklasse, die über ein Metadaten-Objekt und ein Datenobjekt verfügt, um auf Target-Antworten zu warten und die Antwort-Token zu lesen.

Im folgenden Antwortbeispiel wird direkt ein Platform Web SDK benutzerdefinierter Ereignishandler zur HTML-Seite hinzugefügt (in der Tabelle werden die im Code verwendeten Objekte erläutert):

Objekt Informationen
Typ - Personalization.decision Ob die Entscheidung vom Target- oder Offer decisioning-Provider getroffen wurde.
DecisionProvider - TGT TGT-Target. Target stellt die Metadaten und Werte des Antwort-Tokens für die Seite bereit.
Meta An die Seite übergebene Metadaten.
Daten Werte der Metadaten, die an die Seite übergeben werden.
<html>

<head>
 ...
 <script src="alloy.js"></script>
 <script>
  {
   "requestId": "4d0a7cfd-952c-408c-b3b8-438edc38250a",
   "handle": [{
    "type": "personalization:decisions",
    "payload": [{
     "id": "....",
     "scope": "__view__",
     "scopeDetails": {
      "decisionProvider": "TGT",
      "activity": {
       "id": "..."
      },
      "experience": {
       "id": "...."
      }
     },
     "items": [{
      "id": "123",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
       "activity.id": "...",
       "activity.name": "...",
       "profile.foo": "...",
       "profile.bar": "..."
      },
      "data": {
       "id": "123",
       "type": "setHtml",
       "selector": "#foo",
       "prehidingSelector": "#foo",
       "content": "<div>Hello world</div>"
      }
     }]
    }]
   }]
  }
  });
 </script>
</head>

<body>
 ...
</body>

</html>

at.js badgeat.js mithilfe benutzerdefinierter Ereignisse

Verwenden Sie benutzerdefinierte at.js-Ereignisse, um die Target-Antwort zu überwachen 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>

FAQs zu Antwort-Token

Welche Rolle wird zum Aktivieren oder Deaktivieren von Antwort-Token benötigt?

Antwort-Token können nur von Benutzern mit der Rolle Target Administrator aktiviert oder deaktiviert werden.

Was passiert, wenn ich Platform Web SDK 2.6.0 (oder früher) verwende?

Sie haben keinen Zugriff auf Antwort-Token.

Was passiert, wenn ich at.js 1.0 (oder früher) verwende?

Sie sehen die Antwort-Token, at.js kann sie jedoch nicht verwenden.

Können beide Target Classic Plug-ins und Antwort-Token gleichzeitig aktiv sein?

Plug-ins und Antwort-Token sind parallel verfügbar. Plug-ins werden jedoch in Zukunft nicht mehr unterstützt.

Werden Antwort-Token über alle Target Antworten oder nur über Target Antworten bereitgestellt, die eine Aktivität bereitstellen?

Antwort-Token werden nur über Target-Antworten bereitgestellt, die eine Aktivität bereitstellen.

Mein Target Classic Plugin enthielt 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 Tag-Management-Lösung beibehalten werden. Sie können diesen Code mithilfe von benutzerdefinierten Ereignissen vom Typ Platform Web SDK oder at.js Trigger 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 Parameter normalerweise alle 15 Minuten. Diese Aktualisierung hängt von der Benutzeraktion ab und die Daten werden nur aktualisiert, wenn Sie die Antwort-Token-Seite anzeigen. Wenn Ihre Parameter nicht in der Liste der Antwort-Token angezeigt werden, hat Target die Daten noch nicht aktualisiert.

Wenn Ihr Parameter außer nicht alphanumerischen Zeichen oder anderen Symbolen als Unterstrichen etwas enthält, wird der Parameter nicht in der Liste angezeigt. Momentan werden nur alphanumerische Zeichen und Unterstriche unterstützt.

Stellt das Antwort-Token weiterhin Inhalte bereit, wenn es ein gelöschtes Profilskript oder einen Profilparameter verwendet?

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 den Inhalt weiterhin bereit. Für Benutzer, die diese Informationen nicht in ihren Profilen gespeichert haben, oder für neue Besucher wird dieses Token nicht bereitgestellt, da die Daten nicht in ihren 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, wird für Benutzer, die Ihre Website besucht haben, der alte Profilskriptwert in ihren Profilen gespeichert. Das Token nimmt 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. Jedes Attribut, das nicht aktiviert wird, wird bei der nächsten Aktualisierung entfernt. Wenn Sie jedoch über ein Attribut verfügen, das aktiviert wurde und entfernt wurde, wird dieses Skript erst dann aus der Attributliste entfernt, wenn Sie es deaktivieren. Beispielsweise haben Sie ein Profilskript entfernt, das als Token verwendet wurde. Target entfernt die deaktivierten Attribute erst aus der Liste, wenn sie gelöscht oder umbenannt werden.

Daten an Google Analytics senden

In den folgenden Abschnitten wird beschrieben, wie Sie Target-Daten an Google Analytics senden. Daten, die von Antwort-Token gesendet werden, können auch an andere Drittanbieter-Integrationen gesendet werden.

AEP- BadgeSenden von Daten an Google Analytics über Platform Web SDK

Google Analytics können Daten über die Platform Web SDK-Version 2.6.0 (oder höher) senden, indem Sie den folgenden Code auf der HTML-Seite hinzufügen.

HINWEIS

Stellen Sie sicher, dass sich das Schlüsselwertpaar des Antwort-Tokens unter dem alloy(“sendEvent” -Objekt befindet.

<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">
   alloy("sendEvent", {
   
   
   })
   .then(({ renderedPropositions, nonRenderedPropositions }) => {
   // concatenate all the propositions
   const propositions = [...renderedPropositions, ...nonRenderedPropositions];
   // extractResponseTokens() extract the meta from item -> meta
   const tokens = extractResponseTokens(propositions);
   const activityNames = []; 
   const experienceNames = []; 
   const uniqueTokens = distinct(tokens); 
   
   
   uniqueTokens.forEach(token => { 
   activityNames.push(token["activity.name"]); 
   experienceNames.push(token["experience.name"]); 
   }); 
   
   
   ga('send', 'event', { 
   eventCategory: "target", 
   eventAction: experienceNames, 
   eventLabel: activityNames 
   }); 
   
   
   });
</script>

at.js badgeSenden von Daten an Google Analytics über 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

Die folgenden Abschnitte enthalten Informationen zum Debugging von Antwort-Token:

at.js- BadgeGoogle Analytics und Debugging

Mit dem folgenden Code können Sie das Debugging mit Google Analytics durchführen:

<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]; }); 
  } 

Debugging mit der Entsprechung des ttMeta-Plug-ins

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>

at. jsTraining-Video: Antwort-Token und benutzerdefinierte at.js-Ereignisse

Im folgenden Video wird erläutert, wie Sie mithilfe von Antwort-Token und benutzerdefinierten at.js-Ereignissen Profilinformationen von Target an Drittanbietersysteme weitergeben können.

HINWEIS

Die Menübenutzeroberfläche Target Administration (ehemals Setup) wurde überarbeitet, um eine verbesserte Leistung, eine Verkürzung der Wartungszeit bei der Veröffentlichung neuer Funktionen und eine produktübergreifende Verbesserung des Benutzererlebnisses zu erzielen. Die Informationen im folgenden Video sind korrekt. Die Optionen befinden sich jedoch an etwas anderen Orten.

Auf dieser Seite