Esta página descreve o método appendIdentityToUrl do SDK do Servidor. Para o Web SDK, consulte appendIdentityToUrl.
O método appendIdentityToUrl adiciona a identidade do visitante a uma URL como um parâmetro de sequência de consulta chamado adobe_mc. Quando o visitante segue o URL para outro domínio que você possui, o Web SDK ou o Server SDK nesse domínio lê o parâmetro e mantém a mesma Experience Cloud ID (ECID). Isso impede que o visitante seja contado duas vezes em conjuntos de dados que incluem ambos os domínios.
Em um servidor, um uso comum é adicionar a identidade do visitante a um redirecionamento para outro domínio:
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
const { url } = await visitor.appendIdentityToUrl({
url: "https://shop.example.net/checkout"
});
res.writeHead(302, { Location: url });
res.end();
O URL resultante é semelhante ao seguinte:
https://shop.example.net/checkout?adobe_mc=TS%3D1792711449%7CMCMID%3D34567890123456789012345678901234567890%7CMCORGID%3DADB3LETTERSANDNUMBERS%2540AdobeOrg
Se a SDK ainda não tiver a ECID do visitante, ela solicitará uma da Edge Network primeiro. Esta solicitação não está autenticada. Consulte Definir o tipo de acesso da sequência de dados.
Se o visitante optou por não participar, ou defaultConsent for "out" e o visitante não tiver optado, o método retornará a URL inalterada. Ela também retorna o URL inalterado, em vez de rejeitar, se não conseguir obter a identidade do visitante, por exemplo, devido a um erro de rede. Quando debugging está ativado, o SDK registra um aviso que inclui Unable to append identity to url.
Opções options
O método appendIdentityToUrl aceita um objeto com as seguintes propriedades:
url: Obrigatório. O URL ao qual adicionar a identidade do visitante.edgeConfigOverrides: um objeto de substituição da configuração de sequência de dados para esta solicitação.
Objeto de resultado result
O método appendIdentityToUrl retorna uma promessa. Quando resolvido, o objeto de resultado contém url, a URL com o parâmetro de cadeia de caracteres de consulta adobe_mc adicionado.