DocumentaçãoExperience PlatformTags

Acessar a ECID

Last update: Mon Aug 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Desenvolvedor

O Experience Cloud Identity (ECID) é um identificador persistente atribuído a um usuário quando ele visita seu site. Em determinadas circunstâncias, você pode preferir acessar o ECID (para enviá-lo a terceiros, por exemplo). Outro caso de uso é configurar o ECID em um campo XDM personalizado, além de tê-lo no mapa de identidade.

Você pode acessar a ECID por meio do Preparo de dados para a coleção de dados (recomendado) ou por meio de tags.

Acessar a ECID por meio do Preparo de dados (método preferencial) accessing-ecid-data-prep

Este método usa o Preparo de Dados para a Coleção de Dados para configurar um mapeamento personalizado para o ECID.

Consulte a documentação do Preparo de Dados para a Coleção de Dados para saber como usar este recurso.

Se você deseja definir a ECID em um campo XDM personalizado, além de tê-la no mapa de identidade, faça isso definindo o source para o seguinte caminho:

xdm.identityMap.ECID[0].id

Em seguida, defina o destino como um caminho XDM, onde o campo é do tipo string.

Tags

Se você precisar acessar o ECID no lado do cliente, use a abordagem de tags conforme descrito abaixo.

  1. Verifique se a propriedade está configurada com a habilitação da sequência de componentes da regra.

  2. Crie uma nova regra. Esta regra deve ser usada exclusivamente para capturar o ECID sem nenhuma outra ação importante.

  3. Adicionar um evento Biblioteca carregada à regra.

  4. Adicione uma ação Código personalizado à regra com o seguinte código (supondo que o nome configurado para a instância do SDK seja alloy e já não exista um elemento de dados com o mesmo nome):

    code language-js 
     return alloy("getIdentity")
   .then(function(result) {
     _satellite.setVar("ECID", result.identity.ECID);
   });

  5. Salve a regra.

Você poderá acessar ECID nas regras subsequentes usando %ECID% ou _satellite.getVar("ECID"), como acessaria qualquer outro elemento de dados.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743