Dokumentation Target Användarhandbok om Target

Svarstoken

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Administration och konfiguration

Skapat för:

Administratör

Med svarstoken kan du automatiskt skicka information som är specifik för Adobe Target till ditt varumärkes webbsida. Den här informationen kan innehålla information om aktivitet, erbjudande, upplevelse, användarprofil, geo-information med mera. De här detaljerna innehåller extra svarsdata som kan delas med interna eller externa verktyg eller som kan användas för felsökning.

Med svarstoken kan du välja vilka variabler (i nyckelvärdepar) som ska användas och sedan aktivera att de skickas som en del av ett Target-svar. Du aktiverar en variabel med växeln och variabeln skickas med Target svar, som kan valideras i nätverksanrop. Svarstoken fungerar även i Preview-läge.

En viktig skillnad mellan plugin-program och svarstoken är att plugin-program levererar JavaScript till den sida som körs vid leverans. Svarstoken levererar emellertid ett objekt som sedan kan läsas och hanteras med händelseavlyssnare. Svarstoken är säkrare och gör det enklare att utveckla och underhålla tredjepartsintegreringar.

IMPORTANT

Från och med den 22 april 2025 kan bara Product- och Solutions-administratörer uppdatera inställningarna i Administration -avsnitten, oavsett vilka roller de har i Target -arbetsytorna. Användare utan den här behörigheten har skrivskyddad åtkomst till Administration-avsnitten. Mer information finns i Behörigheter som krävs för att redigera Administration-inställningar.

NOTE

Svarstoken är tillgängliga med at.js version 1.1 eller senare.

SDK

Föreslagna åtgärder

Adobe Experience Platform Web SDK

Kontrollera att du använder Platform Web SDK version 2.6.0 eller senare. Information om hur du hämtar den senaste versionen av Platform Web SDK finns i Installera SDK i översiktshandboken Platform Web SDK. Information om de nya funktionerna i de olika versionerna av Platform Web SDK finns i Versionsinformation i översiktshandboken för Platform Web SDK.

at.js

Kontrollera att du använder at.js version 1.1 eller senare. Information om hur du hämtar den senaste versionen av at.js finns i Hämta på.js. Mer information om nya funktioner i varje version av at.js finns i at.js Versionsinformation.
Kunder som använder at.js uppmuntras att använda svarstoken och gå bort från plugin-program. Vissa plugin-program som förlitar sig på interna metoder som fanns i mbox.js (som nu är inaktuellt), men inte i at.js, levereras men misslyckas.

Använda svarstoken section_A9E141DDCBA84308926E68D05FD2AC62

Kontrollera att du använder Platform Web SDK version 2.6.0 (eller senare) eller at.js version 1.1 (eller senare).

Mer information:
- Platform Web SDK: See Install the SDK in the Platform Web SDK overview guide.
- at.js: See Download at.js.
I Target klickar du på Administration > Response Tokens.

Aktivera önskade svarstoken, till exempel activity.id och offer.id.

Följande parametrar är tillgängliga som standard:

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	Anteckningar
Built-in Profiles	`profile.activeActivities`	Returns an array of the `activityIds` the visitor is qualified for. It increments as users are qualified. For example, on a page with two Target requests delivering two different activities, the second request includes both activities.
	`profile.isFirstSession`	Returnerar "true" eller "false".
	`profile.isNewSession`	Returnerar "true" eller "false".
	`profile.daysSinceLastVisit`	Returnerar antalet dagar sedan besökarens senaste besök.
	`profile.tntId`	Returnerar besökarens tntID
	`profile.marketingCloudVisitorId`	Returnerar besökarens Experience Cloud Visitor-ID.
	`profile.thirdPartyId`	Returnerar besökarens tredjeparts-ID.
	`profile.categoryAffinity`	Returns the visitor's favorite category.
	`profile.categoryAffinities`	Returns an array of the visitor's top 5 categories as strings.
Aktivitet	`activity.name` `activity.id` `experience.name` `experience.id` `offer.name` `offer.id`	Details of the current activity. Note that values for offer parameters are evaluated on the experience level.
Geo	`geo.country` `geo.state` `geo.city` `geo.zip` `geo.dma` `geo.domainName` `geo.ispName` `geo.connectionSpeed` `geo.mobileCarrier`	Mer information om hur du använder geomål i aktiviteter finns i Geo.
Trafikallokeringsmetod (Gäller endast för Auto-Target- och Automated Personalization-aktiviteter.)	`experience.trafficAllocationId`	Returnerar 0 om en besökare har fått en upplevelse av att vara i"kontrolltrafik" och 1 om en besökare har fått en upplevelse av den"riktade" trafikfördelningen.
	`experience.trafficAllocationType`	Returnera"control" eller"target".

User profile attributes and Customer Attributes also display in the list.

note note
NOTE
Parametrar med specialtecken visas inte i listan. Endast alfanumeriska tecken och understreck stöds.

(Villkorligt) Om du vill använda en profilparameter som en svarstoken, men parametern inte har skickats via en Target-begäran och därför inte har lästs in i Target UI, kan du använda knappen Add Response Token för att lägga till profilen i användargränssnittet.

Klicka på Add Response Token, ange tokennamnet och klicka sedan på Activate.
Skapa en aktivitet.

Lyssna efter svar och läs svarstoken

Den process som du använder för att avlyssna Target svar och läsa svarstoken skiljer sig åt beroende på om du har en Platform Web SDK - eller at.js-implementering.

Platform Web SDK med objektklassen Handle platform-web-sdk

Använd objektklassen Handle, som har ett metadata-objekt och ett dataobjekt som lyssnar efter Target svar och läser svarstoken.

I följande svarsexempel läggs en Platform Web SDK anpassad händelsehanterare till direkt på HTML-sidan (tabellen förklarar vilka objekt som används i koden):

Objekt

Information

Typ - Personalization.Decision

Anger om beslutet fattades av Target- eller Offer Decisioning-providern.

DecisionProvider - TGT

TGT-Target. Target tillhandahåller metadata och värden för svarstoken till sidan.

at.js med anpassade händelser

Använd anpassade at.js-händelser för att lyssna efter Target-svaret och läsa svarstoken.

I följande kodexempel läggs en anpassad at.js-händelsehanterare till direkt på HTML-sidan:

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

Vanliga frågor om svarstoken section_3DD5F32C668246289CDF9B4CDE1F536D

Vilken roll krävs för att aktivera eller inaktivera svarstoken?

Svarstoken kan bara aktiveras eller inaktiveras av användare med rollen Target Administrator.

Vad händer om jag kör Platform Web SDK 2.6.0 (eller tidigare)?

Du har inte åtkomst till svarstoken.

Vad händer om jag kör på .js 1.0 (eller tidigare)?

Svarstoken visas, men at.js kan inte använda dem.

Kan jag ha både Target Classic plugin-program och svarstoken aktiva samtidigt?

Plugin-program och svarstoken är tillgängliga parallellt, men plugin-program kommer att bli inaktuella i framtiden.

Levereras svarstoken via alla Target svar eller endast via Target svar som levererar en aktivitet?

Response tokens are delivered only through Target responses delivering an activity.

My Target Classic plugin included JavaScript. Hur replikerar jag funktionaliteten med hjälp av svarstoken?

När du migrerar till svarstoken måste den här typen av JavaScript finnas i din kodbas- eller tagghanteringslösning. Du kan utlösa den här koden med Platform Web SDK eller at.js anpassade händelser och skicka svarstokenvärden till dina JavaScript-funktioner.

Varför visas inte min profil-/kundattributparameter i svarstokenlistan?

Target uppdaterar normalt parametrar var 15:e minut. Den här uppdateringen är beroende av användaråtgärder och data uppdateras bara när du visar svarstokensidan. Om dina parametrar inte visas i svarstokenlistan har Target inte uppdaterat data än.

Om parametern innehåller något annat än icke-alfanumeriska tecken eller någon annan symbol än understreck, visas inte parametern i listan. För närvarande stöds endast alfanumeriska tecken och understreck.

Levererar svarstoken fortfarande innehåll om den använder ett borttaget profilskript eller en profilparameter?

Svarstoken extraherar information från användarprofiler och skickar sedan informationen. Om du tar bort ett profilskript eller en parameter innebär det inte att informationen har tagits bort från användarprofilerna. Användarprofilerna har fortfarande data som motsvarar profilskriptet. Svarstoken fortsätter att leverera innehållet. För användare som inte har den informationen sparad i sina profiler, eller för nya besökare, levereras inte denna token eftersom informationen inte finns i deras profiler.

Target inaktiverar inte token automatiskt. Om du tar bort ett profilskript och inte längre vill att variabeln ska levereras, måste du inaktivera variabeln själv.

Jag har bytt namn på mitt profilskript, men varför är token som använder skriptet fortfarande aktiv med det gamla namnet?

Som nämnts ovan fungerar svarstoken på den profilinformation som har sparats för användare. Även om du har bytt namn på ditt profilskript kommer användare som har besökt din webbplats att spara det gamla profilskriptvärdet i sina profiler. Token fortsätter att hämta det gamla värdet som redan har sparats i användarprofilerna. If you now want to deliver content on the new name, you must toggle off the previous token and toggle on the new token.

If my attributes have changed, when are they be removed from the list?

Target performs a refresh of attributes at regular intervals. Any attribute that is not toggled on is removed during the next refresh. However, if you have an attribute that was toggled on and has been removed, that script is not removed from the attribute list until you toggle it off. As an example, you removed a profile script that was used as a token. Target removes only the toggled-off attributes from the list when they are deleted or renamed.

Skicka data till Google Analytics

I följande avsnitt beskrivs hur du skickar Target-data till Google Analytics 4. Data som skickas av svarstoken kan också skickas till andra tredjepartsintegreringar.

Skicka data till Google Analytics via Platform Web SDK

Google Analytics kan skickas via Platform Web SDK version 2.6.0 (eller senare) genom att följande kod läggs till på HTML-sidan.

NOTE

Make sure the response token key value pair are under the alloy("sendEvent" object.

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

Sending data to Google Analytics via at.js section_04AA830826D94D4EBEC741B7C4F86156

Google Analytics kan skicka data via at.js genom att lägga till följande kod på HTML-sidan:

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

Felsökning

I följande avsnitt finns information om felsökning av svarstoken:

Google Analytics och felsökning

Med följande kod kan du felsöka med Google Analytics:

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

Felsöka med motsvarigheten till plug-inen ttMeta

Motsvarigheten till ttMeta-plugin-programmet för felsökning kan skapas genom att följande kod läggs till på HTML-sidan:

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

Utbildningsvideo: Response Tokens och at.js Custom Events section_3AA0A6C8DBD94A528337A2525E3E05D5

I följande video förklaras hur du använder svarstoken och anpassade at.js-händelser för att dela profilinformation från Target till tredjepartssystem.

NOTE

Gränssnittet för Target Administration-menyn (tidigare Setup) har gjorts om för att ge bättre prestanda, minska den underhållstid som krävs när nya funktioner släpps och för att förbättra användarupplevelsen i hela produkten. Informationen i följande video är korrekt, men alternativen finns på något olika platser.

I videon omnämns option.name och option.id, som har ersatts med offer.name respektive offer.id.

video poster

https://video.tv.adobe.com/v/23253/

recommendation-more-help

3d9ad939-5908-4b30-aac1-a4ad253cd654