Svarstoken

Med svarstoken kan du automatiskt få ut information som är specifik för Adobe Target på ert 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 en Target svar. Du aktiverar en variabel med växeln och variabeln skickas med Target svar, som kan valideras i nätverksanrop. Svarstoken fungerar också i Preview läge.

En viktig skillnad mellan plugin-program och svarstoken är att plugin-program levererar JavaScript till sidan 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.

Använda svarstoken

1. 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: Se Installera SDK i SDK för plattform guide.
   • at.js: Se Ladda ned på.js.

2. I Target, klicka Administration > Response Tokens.

   

3. Aktivera önskade svarstoken, t.ex. activity.id och offer.id.

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

   Typ	Parameter	Anteckningar
   Inbyggda profiler	profile.activeActivities	Returnerar en array med activityIds besökaren är kvalificerad för detta. Det ökar efterhand som användarna kvalificerar sig. Till exempel på en sida med två Target begäran som levererar två olika aktiviteter, den andra begäran innehåller båda aktiviteterna.
   	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	Returnerar besökarens favoritkategori.
   	profile.categoryAffinities	Returnerar en array med besökarens fem populäraste kategorier som strängar.
   Aktivitet	activity.name activity.id experience.name experience.id offer.name offer.id	Information om den aktuella aktiviteten. Observera att värdena för parametrarna för erbjudanden utvärderas på erfarenhetsnivå.
   Geo	geo.country geo.state geo.city geo.zip geo.dma geo.domainName geo.ispName geo.connectionSpeed geo.mobileCarrier	Se Geo om du vill ha mer information om hur du använder geolokalisering i aktiviteter.
   Trafikallokeringsmetod (Gäller för Auto-Target och Automated Personalization endast 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".

   Attribut för användarprofiler och kundattribut visas också i listan.

   OBSERVERA

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

4. (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 Gränssnitt, du kan använda Add Response Token för att lägga till profilen i användargränssnittet.

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

   

5. Skapa en aktivitet.

Lyssna efter svar och läs svarstoken

Processen som du använder för att avlyssna Target svar och lässvar varierar beroende på om du har en Platform Web SDK eller implementering av at.js.

Platform Web SDK med objektklassen Handle

Använd objektklassen Handle, som har ett metadata-objekt och ett dataobjekt att avlyssna Target svar och läsa svarstoken.

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

<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 med anpassade händelser

Använd at.js, anpassade händelser att lyssna efter Target svara och läsa svarstoken.

Följande kodexempel lägger till en at.js anpassad händelsehanterare direkt till 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

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

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

Vad händer om jag springer? 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 få båda Target Classic aktiva plugin-program och svarstoken samtidigt?

Plugins och svarstoken finns tillgängliga parallellt. plugin-program kommer dock att bli inaktuella i framtiden.

Levereras svarstoken via alla Target eller bara via Target svar på en aktivitet?

Svarstoken levereras endast via Target svar som levererar en aktivitet.

Min Target Classic plugin-programmet innehåller JavaScript. Hur replikerar jag funktionaliteten med svarstoken?

När du migrerar till svarstoken måste den här typen av JavaScript finnas i kodbas- eller tagghanteringslösningen. Du kan aktivera 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 parametrarna inte visas i svarslistan, Target har ännu inte uppdaterat data.

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 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 tar inte bort 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 den 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. Om du nu vill leverera innehåll med det nya namnet måste du inaktivera den tidigare variabeln och aktivera den nya variabeln.

Om mina attribut har ändrats, när tas de bort från listan?

Target uppdaterar attribut med regelbundna intervall. Alla attribut som inte är aktiverade tas bort under nästa uppdatering. Om du har ett attribut som har aktiverats och tagits bort tas det skriptet inte bort från attributlistan förrän du har inaktiverat det. Du tog till exempel bort ett profilskript som användes som token. Target tar endast bort de inaktiverade attributen från listan när de tas bort eller byter namn.

Skicka data till Google Analytics

I följande avsnitt beskrivs hur du skickar Target data till Google Analytics. 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 lägga till följande kod på HTML-sidan.

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

Skicka data till Google Analytics via at.js

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

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

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

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: Svarstoken och anpassade at.js-händelser

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 system från tredje part.

Resurser för Business.Adobe.com

Ab Multivariate Testing Enterprise Governance Website Personalization Behavioral Targeting Multivariate Testing Ab Testing