Os clientes do serviço de ID devem consultar esta seção para obter informações sobre como ler o cookie do visitante para as IDs necessárias para efetuar chamadas de API DCS.
O Adobe Experience Platform Identity Service atribui IDs de visitante e região a usuários que acessam seu site. Essas IDs identificam os usuários em todas as soluções em Experience Cloud e são necessárias se você deseja fazer chamadas DCS.
Os clientes do serviço de ID podem extrair essas informações do cookie do serviço de ID ou chamando uma função. A tabela abaixo descreve as tarefas ou etapas que você precisa concluir para começar.
O código em italics representa um espaço reservado variável.
Tarefa | Descrição |
---|---|
1. Verifique seu status Experience Cloud |
Você precisa de uma conta Experience Cloud para usar o serviço de ID. Se você tiver uma conta Experience Cloud, ótimo! Se você não fizer parte do Experience Cloud , inscreva-se. Adoraríamos tê-lo e sempre há espaço para mais. Para obter instruções sobre como configurar uma conta, consulte Ativando suas soluções para os principais serviços. |
2. Configurar o serviço de ID |
O serviço de ID consiste em um código JavaScript que é colocado em cada página que você deseja usar para a coleta de dados. Consulte os guias de implementação do serviço de ID para obter mais informações. |
3. Leia o cookie do serviço de ID |
O serviço de ID armazena a ID de usuário e região no cookie AMCV. O nome completo do cookie é Analise o cookie AMCV para estes pares de valores chave:
Você pode fazer chamadas para o DCS depois que tiver as IDs de usuário e região. |
4. Recupere a ID do Experience Cloud com getMarketingCloudVisitorID |
(Opcional) Essa função retorna a ID de visitante da Experience Cloud. Ele foi projetado para soluções personalizadas e casos de uso específicos. Consulte Trabalhando com getMarketingCloudVisitorID abaixo e a documentação do serviço de ID relacionada. Não é necessário usar isso se você obter as IDs de usuário e local do cookie do serviço de ID. |
getMarketingCloudVisitorID
Outra maneira de obter a ID do visitante é com a função getMarketingCloudVisitorID
. Quando chamada, essa função query ID service e retorna uma ID. getMarketingCloudVisitorID
aceita o callback
argumento opcional como mostrado:
var analyticsID = visitor.getAnalyticsVisitorID(callback)
callback
é opcional. Essa função funciona sem ela, mas retorna uma ID somente quando um visitante tem um cookie [!DNL Experience Cloud] em seu navegador. Se o cookie do visitante estiver ausente ou um visitante não tiver uma ID, a função retornará um objeto ()
vazio. Isso pode ocorrer mesmo depois que a página é carregada e o visitante recebe uma nova ID. Para evitar isso, callback
força essa função a verificar a existência de uma ID de visitante após o carregamento da página. Sem callback
, a função de ID do visitante não retornará uma ID, mesmo se ela for gravada no navegador do visitante posteriormente.
Depois de ter a ID de usuário e região, você pode start enviando e recebendo dados DCS. Consulte Efetuar chamadas de API DCS.