Token di risposta

I token di risposta consentono di inviare automaticamente informazioni specifiche di Adobe Target alla pagina Web del tuo marchio. Queste informazioni possono includere dettagli sull’attività, l’offerta, l’esperienza, il profilo utente, le informazioni geografiche e altro ancora. Questi dettagli forniscono dati di risposta aggiuntivi da condividere con strumenti interni o di terze parti o da utilizzare per il debug.

I token di risposta consentono di scegliere le variabili (in coppie di valori chiave) da utilizzare e quindi di abilitarne l'invio come parte di una risposta Target. Abilitare una variabile utilizzando il parametro e la variabile viene inviata con Target risposte, che possono essere convalidate in chiamate di rete. I token di risposta funzionano anche in modalità Preview.

Una differenza chiave tra plug-in e token di risposta è che i plug-in forniscono JavaScript alla pagina che viene eseguita al momento della consegna. I token di risposta, tuttavia, forniscono un oggetto che può quindi essere letto e seguito utilizzando i listener di eventi. L’approccio del token di risposta è più sicuro e consente di sviluppare e mantenere più facilmente le integrazioni di terze parti.

NOTE
I token di risposta sono disponibili con at.js versione 1.1 o successiva.
SDK di Target
Azioni suggerite
Adobe Experience Platform Web SDK
Assicurati di utilizzare Platform Web SDK versione 2.6.0 o successiva. Per informazioni sul download della versione più recente di Platform Web SDK, vedere Installare l'SDK nella Panoramica di Platform Web SDK. Per informazioni sulle nuove funzionalità in ogni versione di Platform Web SDK, consulta le note sulla versione nella panoramica di Platform Web SDK.
at.js
Assicurati di utilizzare at.js nella versione 1.1 o successiva. Per informazioni sul download della versione più recente di at.js, consulta Scarica at.js. Per informazioni sulle nuove funzionalità in ogni versione di at.js, consulta Dettagli sulla versione di at.js.
I clienti che utilizzano at.js sono incoraggiati a utilizzare i token di risposta e ad abbandonare i plug-in. Alcuni plug-in che si basano su metodi interni esistenti in mbox.js (ora obsoleto), ma non in at.js, vengono consegnati ma non hanno esito positivo.

Utilizzo dei token di risposta section_A9E141DDCBA84308926E68D05FD2AC62

  1. Assicurati di utilizzare Platform Web SDK versione 2.6.0 (o successiva) o at.js versione 1.1 (o successiva).

    Per ulteriori informazioni:

  2. In Target, fare clic su Administration > Response Tokens.

    token di risposta-nuova immagine

  3. Attiva i token di risposta desiderati, ad esempio activity.id e offer.id.

    Per impostazione predefinita sono disponibili i seguenti parametri:

    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
    Tipo Parametro Note
    Profili incorporati profile.activeActivities Restituisce una matrice dei codici activityIds per i quali il visitatore si qualifica. Viene incrementato man mano che gli utenti si qualificano. Ad esempio, in una pagina con due richieste Target che distribuiscono due attività diverse, la seconda richiesta include entrambe le attività.
    profile.isFirstSession Restituisce “vero” o “falso”.
    profile.isNewSession Restituisce “vero” o “falso”.
    profile.daysSinceLastVisit Restituisce il numero di giorni dall’ultima visita del visitatore.
    profile.tntId Restituisce il codice tntID del visitatore.
    profile.marketingCloudVisitorId Restituisce l’ID visitatore di Experience Cloud per il visitatore in oggetto.
    profile.thirdPartyId Restituisce l’ID di terze parti del visitatore.
    profile.categoryAffinity Restituisce la categoria preferita del visitatore.
    profile.categoryAffinities Restituisce una matrice delle 5 categorie principali del visitatore, sotto forma di stringhe.
    Attività activity.name
    activity.id
    experience.name
    experience.id
    offer.name
    offer.id
    Dettagli dell’attività corrente.
    I valori dei parametri delle offerte vengono valutati a livello di esperienza.
    Geo geo.country
    geo.state
    geo.city
    geo.zip
    geo.dma
    geo.domainName
    geo.ispName
    geo.connectionSpeed
    geo.mobileCarrier
    Consulta Geo per ulteriori informazioni sull’utilizzo del geotargeting nelle attività.
    Metodo di allocazione traffico
    (si applica solo alle attività Auto-Target e Automated Personalization).
    experience.trafficAllocationId Restituisce 0 se un visitatore ha ricevuto un’esperienza dal traffico "di controllo" e 1 se un visitatore ha ricevuto un’esperienza dalla distribuzione del traffico "mirata".
    experience.trafficAllocationType Restituire "di controllo" o "mirato".

    Nell’elenco vengono visualizzati anche gli attributi del profilo utente e gli attributi del cliente.

    note note
    NOTE
    I parametri con caratteri speciali non vengono visualizzati nell’elenco. Sono supportati solo caratteri alfanumerici e il trattino basso.
  4. (Condizionale) Per utilizzare un parametro di profilo come token di risposta, ma il parametro non è stato trasmesso tramite una richiesta Target e, pertanto, non è stato caricato nell'interfaccia utente Target, è possibile utilizzare il pulsante Add Response Token per aggiungere il profilo all'interfaccia utente.

    Fare clic su Add Response Token, fornire il nome del token, quindi fare clic su Activate.

    immagine token di risposta

  5. Crea un’attività.

Ascoltare le risposte e leggere i token di risposta

Il processo utilizzato per ascoltare le risposte Target e leggere i token di risposta varia a seconda che si disponga di un'implementazione di Platform Web SDK o at.js.

Badge Adobe Experience Platform Web SDK Platform Web SDK utilizzando la classe di oggetti Handle platform-web-sdk

Utilizzare la classe Handle object, che dispone di un oggetto metadati e un oggetto dati per ascoltare le risposte Target e leggere i token di risposta.

Nell'esempio di risposta seguente viene aggiunto un gestore eventi personalizzato Platform Web SDK direttamente alla pagina HTML (nella tabella vengono illustrati gli oggetti utilizzati nel codice):

Oggetto
Informazioni
Tipo: Personalization.decision
Se la decisione è stata presa dal provider di Offer decisioning o Target.
DecisionProvider - TGT
TGT-Target. Target fornisce alla pagina i metadati e i valori del token di risposta.
Meta
Metadati passati alla pagina.
Dati
Valori dei metadati passati alla pagina.
<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>

Badge at.js at.js utilizzando eventi personalizzati

Utilizza eventi personalizzati at.js per ascoltare la risposta Target e leggere i token di risposta.

Il codice di esempio seguente aggiunge un gestore di eventi personalizzati di at.js direttamente alla pagina HTML:

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

Domande frequenti sui token di risposta section_3DD5F32C668246289CDF9B4CDE1F536D

Quale ruolo è autorizzato ad attivare o disattivare i token di risposta?

I token di risposta possono essere attivati o disattivati solo dagli utenti con il ruolo Target Administrator.

Cosa succede se eseguo Platform Web SDK 2.6.0 (o versione precedente)?

Non hai accesso ai token di risposta.

Cosa succede se eseguo at.js 1.0 (o versione precedente)?

Puoi visualizzare i token di risposta, ma at.js non può utilizzarli.

È possibile attivare contemporaneamente Target Classic plug-in e token di risposta?

Plug-in e token di risposta sono disponibili in parallelo; tuttavia, i plug-in diventeranno obsoleti in futuro.

I token di risposta vengono consegnati tramite tutte le Target risposte o solo tramite le Target risposte che distribuiscono un'attività?

I token di risposta vengono consegnati solo tramite Target risposte che forniscono un'attività.

Il mio plug-in Target Classic include JavaScript. Come posso riprodurne la funzionalità utilizzando i token di risposta?

Durante la migrazione ai token di risposta, questo tipo di JavaScript deve essere mantenuto nella base di codice o nella soluzione di gestione dei tag. Puoi attivare questo codice utilizzando Platform Web SDK o at.js eventi personalizzati e trasmettere i valori del token di risposta alle funzioni JavaScript.

Perché il mio parametro profilo/attributi del cliente non viene visualizzato nell’elenco dei token di risposta?

Target aggiorna normalmente i parametri ogni 15 minuti. Questo aggiornamento dipende dall’azione dell’utente e i dati vengono aggiornati solo quando viene visualizzata la pagina dei token di risposta. Se i parametri non vengono visualizzati nell'elenco dei token di risposta, Target non ha ancora aggiornato i dati.

Inoltre, se il parametro contiene solo caratteri non alfanumerici o simboli diversi dai caratteri di sottolineatura, il parametro non viene visualizzato nell'elenco. Attualmente sono supportati solo caratteri alfanumerici e il trattino basso.

Il token di risposta fornisce comunque contenuto se utilizza uno script di profilo eliminato o un parametro di profilo?

I token di risposta estraggono informazioni dai profili utente e quindi recapitano tali informazioni. Se elimini uno script o un parametro di profilo, le informazioni non vengono necessariamente rimosse dai profili utente. I profili utente dispongono ancora di dati corrispondenti allo script del profilo. Il token di risposta continua a distribuire il contenuto. Per gli utenti che non hanno tali informazioni salvate nei loro profili o per i nuovi visitatori, tale token non viene consegnato perché i dati non sono presenti nei loro profili.

Target non disattiva automaticamente il token. Se elimini uno script di profilo e non desideri più che il token venga consegnato, devi disattivare il token manualmente.

Ho rinominato il mio script di profilo, ma il token che utilizza lo script è ancora attivo con il vecchio nome. Perché?

Come accennato in precedenza, i token di risposta funzionano sulle informazioni del profilo salvate per gli utenti. Anche se hai rinominato lo script di profilo, gli utenti che hanno visitato il tuo sito web hanno il valore dello script di profilo precedente salvato nei loro profili. Il token continua a raccogliere il vecchio valore già salvato nei profili utente. Se ora desideri consegnare il contenuto del nuovo nome, devi disattivare il token precedente e attivare quello nuovo.

Se gli attributi sono stati modificati, quando verranno rimossi dall'elenco?

Target esegue un aggiornamento degli attributi a intervalli regolari. Qualsiasi attributo non attivato viene rimosso durante il successivo aggiornamento. Tuttavia, se l'attributo è stato attivato e rimosso, lo script non viene rimosso dall'elenco degli attributi fino a quando non viene disattivato. Ad esempio, hai rimosso uno script di profilo utilizzato come token. Target rimuove dall'elenco solo gli attributi attivati quando vengono eliminati o rinominati.

Invia dati a Google Analytics

Nelle sezioni seguenti viene descritto come inviare dati Target alle Google Analytics 4. I dati inviati dai token di risposta possono essere inviati anche ad altre integrazioni di terze parti.

Badge AEP Invio di dati alle Google Analytics tramite Platform Web SDK

È possibile inviare i dati alle Google Analytics tramite Platform Web SDK versione 2.6.0 (o successiva) aggiungendo il seguente codice nella pagina di HTML.

NOTE
Verificare che la coppia di valori chiave del token di risposta si trovi nell'oggetto alloy("sendEvent".
<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>

Badge at.js invio di dati alle Google Analytics tramite at.js section_04AA830826D94D4EBEC741B7C4F86156

Puoi inviare dati a Google Analytics tramite at.js aggiungendo il seguente codice alla pagina HTML:

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

Eseguire il debug

Le sezioni seguenti forniscono informazioni sul debug dei token di risposta:

Google Analytics e debug del badge at.js

Il codice seguente consente di eseguire il debug utilizzando le 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>

Debug con l’equivalente del plug-in ttMeta

L’equivalente del plug-in ttMeta per scopi di debug può essere creato aggiungendo il seguente codice alla pagina HTML:

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

Video di formazione su at.js : token di risposta ed eventi personalizzati at.js section_3AA0A6C8DBD94A528337A2525E3E05D5

Nel video seguente viene illustrato come utilizzare i token di risposta e gli eventi personalizzati at.js per condividere le informazioni del profilo da Target a sistemi di terze parti.

NOTE
L'interfaccia utente del menu Target Administration (in precedenza Setup) è stata riprogettata per fornire prestazioni migliori, ridurre il tempo di manutenzione necessario per il rilascio di nuove funzionalità e migliorare l'esperienza utente nel prodotto. Le informazioni contenute nel video seguente sono corrette; tuttavia, le opzioni si trovano in posizioni leggermente diverse.
Nel video vengono menzionati option.name e option.id, che sono stati sostituiti rispettivamente con offer.name e offer.id.
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654