Token di risposta

I token di risposta consentono di inviare automaticamente informazioni specifiche a 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 inviarle come parte di un Target risposta. Abilita una variabile utilizzando lo switch e la variabile viene inviata con Target che possono essere convalidate nelle chiamate di rete. I token di risposta funzionano anche in Anteprima modalità.

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.

Utilizzo dei token di risposta

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

   Per ulteriori informazioni:

   • Platform Web SDK: vedi Installare l’SDK nel Panoramica di Platform Web SDK guida.
   • at.js: vedi Scarica at.js.

2. In entrata Target, fai clic su Amministrazione > Token di risposta.

   

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

   Per impostazione predefinita sono disponibili i seguenti parametri:

   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 Target richieste 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 dell’offerta 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 a Targeting automatico e Automated Personalization solo attività).	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.

   NOTA

   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 un Target e non è stato quindi caricato in Target UI, puoi utilizzare il Aggiungi token di risposta per aggiungere il profilo all’interfaccia utente.

   Clic Aggiungi token di risposta, specifica il nome del token, quindi fai clic su Attiva.

   

5. Crea un’attività.

Ascoltare le risposte e leggere i token di risposta

Processo utilizzato per l'ascolto Target risposte e token di risposta di lettura variano a seconda che si disponga di un Platform Web SDK o implementazione at.js.

Platform Web SDK utilizzo della classe oggetto Handle

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

L’esempio di risposta seguente aggiunge una Platform Web SDK gestore eventi personalizzato direttamente nella pagina HTML (la tabella spiega gli oggetti utilizzati nel codice):

<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 utilizzando eventi personalizzati

Usa gli eventi personalizzati di at.js per ascoltare la risposta della e leggere i token di risposta.Target

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

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

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

Cosa succede se eseguo Platform Web SDK 2.6.0 (o 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.

Target ClassicÈ possibile avere attivi allo stesso tempo sia plug-in di che i 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 tutti Target risposte o solo tramite Target risposte che forniscono un’attività?

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

I miei Target Classic Il plug-in 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 soluzione di base di codice o di gestione dei tag. Puoi attivare questo codice utilizzando Platform Web SDK o at.js personalizza gli eventi e passa 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 in genere aggiorna 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 ancora 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 disattivati quando vengono eliminati o rinominati.

Invia dati a Google Analytics

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

Invio di dati a 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.

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

Invio di dati a Google Analytics tramite at.js

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

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: Token di risposta ed eventi personalizzati at. js

Il video seguente spiega 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.