Antwort-Token

Last update: Tue Jan 28 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Administration und Konfiguration

Erstellt für:

Admin

Mit Antwort-Token können Sie automatisch Informationen ausgeben, die für die Adobe Target auf der Web-Seite Ihrer Marke spezifisch sind. Diese Informationen können Details zur Aktivität, zum Angebot, zum Erlebnis, zum Benutzerprofil, zu geografischen Informationen und mehr enthalten. Diese Details enthalten zusätzliche Antwortdaten, die für interne Tools oder Tools von Drittanbietern freigegeben oder zum Debugging verwendet werden können.

Mit Antwort-Token können Sie auswählen, welche Variablen (in Schlüsselwertpaaren) verwendet werden sollen, und dann aktivieren, dass sie als Teil einer Target-Antwort gesendet werden können. 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 Preview.

Ein wichtiger Unterschied zwischen Plug-ins und Antwort-Token besteht darin, dass Plug-ins JavaScript an die Seite senden, die beim Versand ausgeführt wird. Antwort-Token liefern jedoch ein -Objekt, das dann mithilfe von Ereignis-Listenern gelesen und bearbeitet werden kann. Der Ansatz mit Antwort-Token ist sicherer und ermöglicht eine einfachere Entwicklung und Wartung von Drittanbieter-Integrationen.

NOTE

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 Platform Web SDK Version 2.6.0 oder höher verwenden. Informationen zum Herunterladen der neuesten Version von Platform Web SDK finden Sie unter SDK installieren im Handbuch Platform Web SDK - Übersicht. Weitere Informationen zu den neuen Funktionen der einzelnen Versionen von Platform Web SDK finden Sie unter Versionshinweise im Handbuch Platform Web SDK - Übersicht.

at.js

Stellen Sie sicher, dass Sie at.js der Version 1.1 oder neuer verwenden. Informationen zum Herunterladen der neuesten Version von at.js finden Sie unter Herunterladen von at.js. 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 sich auf interne Methoden stützen, die in mbox.js (inzwischen nicht mehr unterstützt), aber nicht in at.js vorhanden waren, werden bereitgestellt, schlagen jedoch fehl.

Verwenden von Antwort-Token section_A9E141DDCBA84308926E68D05FD2AC62

Stellen Sie sicher, dass Sie Platform Web SDK Version 2.6.0 (oder höher) oder at.js Version 1.1 (oder höher) verwenden.

Weitere Informationen:
- Platform Web SDK: Siehe Installieren von SDK im Platform Web SDK - Übersicht.
- at.js: Siehe ".js herunterladen.
Klicken Sie Target auf Administration > Response Tokens.

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

Die folgenden Parameter sind standardmäßig verfügbar:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3
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-Anfragen, die zwei verschiedene Aktivitäten liefern, enthält die zweite Anfrage 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` `offer.name` `offer.id`	Details der aktuellen Aktivität. Beachten Sie, dass Werte für Angebotsparameter auf Erlebnisebene ausgewertet werden.
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-Target und Automated Personalization Aktivitäten.)	`experience.trafficAllocationId`	Gibt 0 zurück, wenn ein Besucher ein Erlebnis aus Kontroll-Traffic erhalten hat, und 1, wenn ein Besucher ein Erlebnis aus der Targeting-Traffic-Verteilung erhalten hat.
	`experience.trafficAllocationType`	Gibt „Kontrolle“ oder „Targeting“ zurück.

Benutzerprofil- und Kundenattribute werden ebenfalls in der Liste angezeigt.

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

(Bedingt) Um einen Profilparameter als Antwort-Token zu verwenden, der Parameter jedoch nicht über eine Target-Anfrage weitergeleitet wurde und daher nicht in die Target-Benutzeroberfläche geladen wurde, können Sie die Schaltfläche Add Response Token verwenden, um das Profil zur Benutzeroberfläche hinzuzufügen.

Klicken Sie auf Add Response Token, geben Sie den Token-Namen ein und klicken Sie dann auf Activate.
Erstellen Sie eine Aktivität.

Überwachen von Antworten und Lesen von Antwort-Token

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

Platform Web SDK Verwendung der Handle-Objektklasse platform-web-sdk

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

Im folgenden Antwortbeispiel wird ein Platform Web SDK benutzerdefinierter Ereignishandler direkt 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-Anbieter getroffen wurde.

Entscheidungsanbieter - TGT

TGT-Target. Target stellt die Metadaten und Werte des Antwort-Tokens für die Seite bereit.

at.js mit benutzerdefinierten Ereignissen

Verwenden Sie at.js benutzerspezifische Ereignisse, um auf die Target Antwort zu warten 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>

Häufig gestellte Fragen zu Antwort-Token section_3DD5F32C668246289CDF9B4CDE1F536D

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

Antwort-Token können nur von Benutzenden 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?

Die Antwort-Token werden angezeigt, aber at.js kann sie nicht verwenden.

Kann ich Target Classic Plug-ins und Antwort-Token gleichzeitig aktivieren?

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 liefern?

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

Mein Target Classic-Plug-in enthielt JavaScript. Wie reproduziere ich diese Funktionalität mithilfe von Antwort-Token?

Bei der Migration zu Antwort-Token muss dieser JavaScript-Typ in Ihrer Code-Basis oder Tag-Management-Lösung beibehalten werden. Sie können diesen Trigger mit Platform Web SDK oder at.js benutzerspezifischen Ereignissen erstellen und die Werte des Antwort-Tokens 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. Die Daten werden nur aktualisiert, wenn die Seite mit den Antwort-Token aufgerufen wird. Wenn Ihre Parameter nicht in der Liste der Antwort-Token angezeigt werden, hat Target die Daten noch nicht aktualisiert.

Wenn Ihr Parameter außerdem keine nicht alphanumerischen 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.

Liefert das Antwort-Token weiterhin Inhalte, 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 verfügen weiterhin über Daten, die dem Profilskript entsprechen. Das Antwort-Token stellt den Inhalt weiterhin bereit. Für Benutzende, die diese Informationen nicht in ihrem Profil gespeichert haben, oder für neue Besucher wird dieses Token nicht bereitgestellt, da die Daten nicht in ihren Profilen vorhanden sind.

Target schaltet das Token nicht automatisch aus. 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 den Benutzern, die Ihre Website besucht haben, der alte Wert des Profilskripts 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.

Wenn sich meine Attribute geändert haben, wann werden sie dann aus der Liste entfernt?

Target führt in regelmäßigen Abständen eine Aktualisierung der Attribute durch. Attribute, die nicht aktiviert sind, werden bei der nächsten Aktualisierung entfernt. Wenn Sie jedoch über ein Attribut verfügen, das aktiviert wurde und entfernt wurde, wird dieses Skript erst aus der Attributliste entfernt, wenn Sie es deaktivieren. Beispielsweise haben Sie ein Profilskript entfernt, das als Token verwendet wurde. Target entfernt nur die ausgeschalteten Attribute 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 4 senden. Daten, die über Antwort-Token gesendet werden, können auch an andere Drittanbieter-Integrationen gesendet werden.

Senden von Daten an Google Analytics über Platform Web SDK

Google Analytics-Daten können über Platform Web SDK Version 2.6.0 (oder höher) gesendet werden, indem der folgende Code auf der HTML-Seite hinzugefügt wird.

NOTE

Stellen Sie sicher, dass sich das Wertpaar des Antwort-Token-Schlüssels unter dem alloy("sendEvent" befindet.

<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></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"]);
        });

        gtag('config', 'TAG_ID');
        gtag('event', 'action_name', {'eventCategory': 'target',
            'eventAction': experienceNames, 'eventLabel': activityNames
        });
    });
</script>

Senden von Daten an Google Analytics über at.js section_04AA830826D94D4EBEC741B7C4F86156

Daten können via at.js an Google Analytics gesendet werden, indem Sie auf der HTML-Seite den folgenden Code hinzufügen:

<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></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"]);
        });

        gtag('config', 'TAG_ID');
        gtag('event', 'action_name', {'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:

Google Analytics und Debugging

Mit dem folgenden Code können Sie mit Google Analytics debuggen:

<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></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"]);
      });

      gtag('config', 'TAG_ID');
      gtag('event', 'action_name', {'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 mit dem Äquivalent 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["offer.id"],
        'OfferName': token["offer.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 section_3AA0A6C8DBD94A528337A2525E3E05D5

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

NOTE

Die Benutzeroberfläche des Target Administration-Menüs (früher Setup) wurde überarbeitet, um eine verbesserte Leistung zu erzielen, die Wartungszeit bei der Veröffentlichung neuer Funktionen zu reduzieren und das Benutzererlebnis im gesamten Produkt zu verbessern. Die Informationen im folgenden Video sind korrekt, die Optionen befinden sich jedoch an etwas anderen Stellen.

Im Video werden option.name und option.id erwähnt, die durch offer.name bzw. offer.id ersetzt wurden.

video poster

https://video.tv.adobe.com/v/33825?captions=ger

recommendation-more-help

3d9ad939-5908-4b30-aac1-a4ad253cd654