Tokens de resposta

Os tokens de resposta permitem gerar automaticamente informações específicas para Target (detalhes da atividade, informações de perfil do usuário, informações geográficas e assim por diante) para usar na depuração ou na integração com sistemas de terceiros (como o Clicktale).

Os tokens de resposta permitem que você escolha quais variáveis serão aproveitadas e, em seguida, permitem que sejam enviadas como parte de uma resposta do Target. Para fazer isso, basta habilitar uma variável usando o switch e a variável será enviada com respostas do Target, que podem ser validadas em chamadas de rede. Os tokens de resposta funcionam no modo Preview também.

Uma diferença importante entre os plugins e os tokens de resposta é que os plugins entregam o JavaScript para a página de execução, após a entrega, por sua vez, os tokens de resposta entregam um objeto que pode ser lido e utilizado pelos ouvintes do evento. Para obter mais informações, consulte eventos personalizados de at.js e os exemplos mais adiante neste artigo. A abordagem dos tokens de resposta é mais segura e permite um desenvolvimento e manutenção mais fáceis de integrações de terceiros.

Uso de tokens de resposta

1. Certifique-se de que você esteja usando a at.js versão 1.1 ou posterior.

   Para obter mais informações, consulte Baixar a at.js.

2. Em Target, clique em Administração > Tokens de Resposta.

   

3. Ative os tokens de resposta desejados, como activity.id, option.id e assim por diante.

   Os seguintes parâmetros estão disponíveis por padrão:

   Tipo	Parâmetro	Notas
   Perfis incorporados	profile.activeActivities	Retorna uma matriz do activityIds para o qual os visitantes estão qualificados. Ele é incrementado à medida que os usuários são qualificados. Por exemplo, em uma página com duas solicitações Target que fornecem duas atividades diferentes, a segunda solicitação inclui ambas as atividades.
   	profile.isFirstSession	Retorna "true" ou "false."
   	profile.isNewSession	Retorna "true" ou "false."
   	profile.daysSinceLastVisit	Retorna o número de dias, desde a última visita do visitante.
   	profile.tntId	Retorna tntID do visitante
   	profile.marketingCloudVisitorId	Retorna a ID do visitante da Experience Cloud.
   	profile.thirdPartyId	Retorna a ID de terceiros do visitante.
   	profile.categoryAffinity	Retorna a categoria favorita do visitante.
   	profile.categoryAffinities	Retorna uma matriz das 5 categorias principais do visitante como sequências de caracteres.
   Atividade	activity.name activity.id experience.name experience.id option.name option.id	Detalhes da atividade atual. Observe que "option" equivale a "offer."
   Geografia	geo.country geo.state geo.city geo.zip geo.dma geo.domainName geo.ispName geo.connectionSpeed geo.mobileCarrier	Consulte Geo para obter mais informações sobre como usar o direcionamento geográfico nas atividades.
   Método de alocação de tráfego (Aplica-se somente às atividades Direcionamento automático e Automated Personalization).	experience.trafficAllocationId	Retorna 0 se um visitante recebeu uma experiência de estar em tráfego de "controle" e 1 se um visitante recebeu uma experiência da distribuição de tráfego de "direcionado".
   	experience.trafficAllocationType	Retorne "controle" ou "direcionado".

   Os atributos do perfil do usuário e dos Atributos do cliente também são exibidos na lista.

   OBSERVAÇÃO

   Os parâmetros com caracteres especiais não são exibidos na lista. Somente caracteres alfanuméricos e sublinhados são suportados.

4. (Condicional) Se você quiser usar um parâmetro de perfil como um token de resposta, mas o parâmetro não tiver sido passado por uma solicitação Target e, portanto, não tiver sido carregado na interface do usuário do Target, poderá usar o botão Adicionar token de resposta para adicionar o perfil à interface do usuário.

   Clique em Adicionar Token de Resposta, forneça o nome do token e clique em Ativar.

   

5. Crie uma atividade.

Use Eventos personalizados da at.js para ouvir a resposta da e ler os tokens de resposta.Target

O código de amostra a seguir adiciona um manipulador de evento personalizado da at.js diretamente na página 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>

Perguntas frequentes de tokens de resposta

Qual função é necessária para ativar ou desativar os tokens de resposta?

Resposta podem ser ativados ou desativados apenas por usuários com a função de administrador do Target.

O que acontecerá se eu estiver executando at.js 1.0 ou anterior?

Você verá os tokens de resposta, mas a at.js não poderá usá-los.

O que acontece se eu estiver usando a at.js 1.1 (ou posterior) em algumas páginas, mas a mbox.js em outras páginas?

Os tokens de resposta serão entregues às respostas do at.js Target, mas não às respostas mbox.js.

Target ClassicPosso fazer com que ambos plugins e tokens de resposta do fiquem ativos ao mesmo tempo?

Os plugins e os tokens de resposta serão disponibilizados em paralelo; no entanto, os plugins serão desativados no futuro.

Os tokens de resposta são entregues por meio de todas as Target respostas ou somente por meio de Target respostas que entregam uma atividade do ?

Os tokens de resposta são entregues somente por meio de respostas Target que entregam uma atividade.

Meu plugin do Target Classic está incluído no JavaScript. Como replico a funcionalidade dele usando os tokens de resposta?

Ao migrar para os tokens de resposta, esse tipo de JavaScript precisará ser mantido na sua base de código ou na solução de gerenciamento de tags. Você pode acionar esse código usando os eventos personalizados da at.js e enviar os tokens de resposta às suas funções do JavaScript.

Por que meu parâmetro de perfil/Atributos do cliente não é exibido na lista de tokens de resposta?

O Target normalmente atualiza os parâmetros a cada 15 minutos. Essa atualização depende da ação dos usuários, sendo que os dados são atualizados somente quando você visualiza a página dos tokens de resposta. Se os seus parâmetros não forem exibidos na lista de token de resposta, isso ainda poderá acontecer, porque o Target ainda não atualizou os dados.

Além disso, se o seu parâmetro contém caracteres que não sejam alfanuméricos ou qualquer símbolo que não seja sublinhados, o parâmetro não aparecerá na lista. Atualmente, somente caracteres alfanuméricos e sublinhados são aceitos.

Se eu criar um token de resposta usando um script de perfil ou um parâmetro de perfil e, em seguida, excluir o script de perfil ou parâmetro, o token de resposta ainda entregará o conteúdo?

Os tokens de resposta extraem as informações dos perfis de usuário e, em seguida, as entregam. Se você excluir um script ou parâmetro de perfil, isso n~so significa que as informações foram removidas dos perfis de usuário. Os perfis de usuário ainda terão os dados correspondentes para o script de perfil. O token de resposta continuará a entregar o conteúdo. Para usuários que não têm as informações salvas nos perfis, ou para novos visitantes, esse token não será entregue porque os dados não estão presentes nos perfis.

O Target não desligará o token automaticamente. Se você excluir o script de perfil e não desejar mais que ele seja entregue, você deve desligar o token sozinho.

Renomeei meu script de perfil, mas por que o token está usando o script ainda ativo com o nome herdado?

Conforme mencionado acima os tokens de resposta trabalham nas informações de perfil salvas pelos usuários. Mesmo se você tiver renomeou seu script de perfil, os usuários que visitaram seu site têm o valor antigo de script do perfil salvos nos perfis e o token continuará a escolher o valor antigo que já está salvo nos perfis do usuário. Se você não deseja entregar o conteúdo no novo nom, deve desligar o token anterior e ligar o novo token.

Se meus atributos foram alterados, quando eles serão removidos da lista?

O Target realiza uma atualização de atributos em intervalos regulares. Qualquer atributo que não esteja ligado será demovido durante a próxima atualização. Entretanto, se você tem um atributo que foi ligado e tiver sido removido (por exemplo, você removeu um script de perfil que foi usado como um token), esse script não será removido da lista de atributos, até ele ter sido desligado. O Target remove somente os atributos desligados na lista, quando são excluídos ou renomeados.

Envio de dados para o Google Analytics via at.js

O Google Analytics pode enviar dados via at.js ao adicionar o seguinte código na página HTML:

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

Depuração (similar ao plugin ttMeta)

O equivalente do plugin ttMeta para fins de depuração pode ser criado ao adicionar o seguinte código à página 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["option.id"], 
        'OfferName': token["option.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>

Vídeo de treinamento: tokens de resposta e eventos personalizados do at.js

Assista ao vídeo a seguir para saber como usar tokens de resposta e eventos personalizados de at.js para compartilhar informações de perfil do Target com sistemas de terceiros.