Tokens de resposta

Response tokens let you automatically output information specific to Target (activity details, user profile information, geo information, and so forth) to use in debugging or integrating with 3rd-party systems (such as Clicktale).

Os tokens de resposta permitem que você escolha quais variáveis serão aproveitadas e, em seguida, permite que sejam enviadas como parte de uma resposta do Público alvo. Para fazer isso, basta ativar uma variável usando o switch e a variável será enviada com respostas de Público alvo, que podem ser validadas em chamadas de rede. Response tokens work in Preview mode as well.

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.

Biblioteca do Target em uso	Ações sugeridas
at.js	Certifique-se de que você esteja usando a at.js versão 1.1 ou posterior. Para obter informações sobre como baixar a versão mais recente do at.js, consulte Baixar o at.js. Para obter informações sobre a nova funcionalidade em cada versão do at.js, consulte Detalhes da versão do at.js. Os clientes que usam a at.js são incentivados a usarem os tokens de resposta e a evitarem os plugins. Alguns plugins que dependem de métodos internos existentes na mbox.js, mas não na at.js, serão entregues, mas apresentarão falha. Para obter mais informações, consulte Limitações do at.js.
mbox.js	Os plugins continuarão a ser suportados e entregues no uso da mbox.js. No entanto, os clientes que usam mbox.js e plugins são incentivados a mudar para at.js e tokens de resposta. Para obter informações sobre as vantagens do uso de at.js em mbox. js, consulte Perguntas frequentes do at.js. Para obter informações sobre a migração, consulte Migrar para at.js do mbox.js. Após a desativação do Target Classic (novembro de 2017), você pode entrar em contato com o Atendimento ao cliente para editar ou desativar os plugins existentes. Você deveria ter auditado os plugins antes da desativação do Target Classic e desativado os plugins indesejados. Você não pode criar novos plugins no Target Standard/Premium. Em vez disso, use os tokens de resposta. Os plug-ins antigos do SiteCatalyst devem ser desativados e substituídos pelo Adobe Analytics como a fonte de relatórios do Adobe Target (A4T). O plugin ttMeta deve ser desativado e substituído pelo depurador da Adobe Experience Cloud.

Utilização 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. In Target, click Administration > Response Tokens.

   

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. For example, on a page with two Target requests delivering two different activities, the second request includes both activities.
   	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 ao Público alvo automático e ao Automated Personalization atividade.)	experience.trafficAllocationId	Retorna 0 se um visitante recebeu uma experiência de estar no tráfego de "controle" e 1 se um visitante recebeu uma experiência da distribuição de tráfego "direcionada".
   	experience.trafficAllocationType	Retorna "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. (Conditional) If you want to use a profile parameter as a response token, but the parameter has not been passed through a Target request and, thus, has not loaded into the Target UI, you can use the Add Response Token button to add the profile to the UI.

   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>

As instruções a seguir mostram como adicionar um manipulador de evento da at.js usando o Gerenciador dinâmico de tags de Adobe (DTM):

1. Faça logon no DTM.

2. Navegue até a propriedade apropriada.

3. Abra a ferramenta Target.

   Como o DTM originalmente não suporta at.js, você precisará usar o editor de código.

4. No editor de código, anexe o seguinte código à at.js:

   document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) { 
     console.log("Request succeeded", e.detail); 
   });
   

Você pode adicionar o seguinte trecho ao rodapé da biblioteca da páginas de configuração do at.js se quiser que tudo seja um único arquivo.

document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) { 
  console.log("Request succeeded", e.detail); 
});

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?

Response tokens will be delivered to the at.js Target responses, but not to the mbox.js responses.

Posso fazer com que ambos plugins e tokens de resposta do Target Classic 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 fornecem uma atividade?

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

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.