appendIdentityToUrl
O comando appendIdentityToUrl permite adicionar um identificador de usuário à URL como uma cadeia de caracteres de consulta. Essa ação permite que você carregue a identidade de um visitante entre domínios, evitando contagens de visitantes duplicadas para conjuntos de dados que incluem domínios ou canais. Ele está disponível nas versões 2.11.0 ou posteriores do SDK da Web.
A cadeia de consulta gerada e anexada à URL é adobe_mc. Se o SDK da Web não puder encontrar uma ECID, ele chamará o ponto de extremidade /acquire para gerar uma.
Anexar identidade ao URL usando a extensão SDK da Web extension
Anexar uma identidade a um URL é executado como uma ação em uma regra na interface das tags da Coleção de dados da Adobe Experience Platform.
- Faça logon em experience.adobe.com usando suas credenciais da Adobe ID.
- Navegue até Coleção de dados > Marcas.
- Selecione a propriedade de tag desejada.
- Navegue até Regras e selecione a regra desejada.
- Em Ações, selecione uma ação existente ou crie uma ação.
- Defina o campo suspenso Extensão como Adobe Experience Platform Web SDK e defina o Tipo de Ação como Redirecionar com identidade.
- Clique em Manter alterações e execute o fluxo de trabalho de publicação.
Normalmente, esse comando é usado com uma regra específica que ouve cliques e verifica domínios desejados.
Acionado quando um tag de âncora com uma propriedade href é clicado.
- Extensão: principal
- Tipo de evento: clique
- Quando o usuário clicar em: elementos específicos
- Elementos correspondentes ao seletor de CSS:
a[href]
Aciona somente nos domínios desejados.
- Tipo lógico: regular
- Extensão: principal
- Tipo de Condição: Comparação de Valores
- Operando Esquerdo:
%this.hostname% - Operador: Corresponde a Regex
- Operando Direito: uma expressão regular que corresponde aos domínios desejados. Por exemplo,
adobe.com$|behance.com$
Anexe a identidade ao URL.
- Extensão: Adobe Experience Platform Web SDK
- Tipo de ação: redirecionar com identidade
Anexar identidade ao URL usando a biblioteca JavaScript do SDK da Web
Execute o comando appendIdentityToUrl com uma URL como parâmetro. O método retorna um URL com o identificador anexado como uma string de consulta.
alloy("appendIdentityToUrl",document.location);
Você pode adicionar um ouvinte de eventos para todos os cliques recebidos na página e verificar se o URL corresponde a algum domínio desejado. Se isso acontecer, anexe a identidade ao URL e redirecione o usuário.
document.addEventListener("click", event => {
// Check if the click was a link
const anchor = event.target.closest("a");
if (!anchor || !anchor.href) return;
// Check if the link points to the desired domain
const url = new URL(anchor.href);
if (!url.hostname.endsWith(".adobe.com") && !url.hostname.endsWith(".behance.com")) return;
// Append the identity to the URL, then direct the user to the URL
event.preventDefault();
alloy("appendIdentityToUrl", {url: anchor.href}).then(result => {document.location = result.url;});
});
Objeto de resposta
Se você decidir manipular respostas com este comando, o objeto de resposta conterá url, a nova URL com informações de identidade adicionada como parâmetro de sequência de consulta.