Obter IDs de usuário e regiões por meio do serviço de identidade da Adobe Experience Platform get-user-ids-and-regions-through-the-experience-cloud-id-service
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 fazer chamadas de API do DCS.
Obter a ID de usuário do cookie do serviço de ID get-user-ids-from-service-cookie
O Adobe Experience Platform Identity Service atribui IDs de visitante e de região aos usuários que chegam ao seu site. Essas IDs identificam usuários em todas as soluções na Experience Cloud e são necessárias se você quiser fazer chamadas para DCS.
- O user ID é necessário para identificar e associar dados a um visitante específico.
- O region ID é necessário porque está vinculado a um nome de servidor regional, que você precisa enviar para o DCS. O DCS armazena informações em data centers geograficamente mais próximos de visitantes do site. Consulte IDs da região do DCS, locais e nomes de host.
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 itálico representa um espaço reservado para variável.
Você precisa de uma conta Experience Cloud para usar o serviço de ID. Se você tem uma conta Experience Cloud, ótimo!
Se você não faz 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 Habilitando suas soluções para os serviços principais.
O serviço de ID armazena a ID de usuário e de região no cookie AMCV. O nome completo do cookie é AMCV_###@AdobeOrg. Os elementos ### são espaços reservados para a ID da organização. Consulte Cookies e a ID de Experience Cloudpara obter detalhes.
Analise o cookie AMCV para esses pares de valores chave:
mid=user ID: Esse par de valor-chave contém a ID de usuário Experience Cloud.aamlh=region ID: esse par de valor-chave contém a ID de região (às vezes chamada de dica de local) que está associada a um nome de servidor regional.
Você pode fazer chamadas para o DCS depois de ter as IDs de usuário e região.
(Opcional) Essa função retorna a ID de visitante Experience Cloud. Ele foi projetado para soluções personalizadas e casos de uso específicos. Consulte Trabalhando com getMarketingCloudVisitorID abaixo e a documentação de serviço de ID relacionada.
Não é necessário usar se você obter as IDs de usuário e de local do cookie do serviço de ID.
Trabalhando Com getMarketingCloudVisitorID working-with-getmarketingcloudvisitorid
Outra maneira de obter a ID de visitante é com a função getMarketingCloudVisitorID. Quando invocada, esta função consulta ID service e retorna uma ID. getMarketingCloudVisitorID aceita o argumento callback opcional como mostrado:
var analyticsID = visitor.getAnalyticsVisitorID(callback)
Uso e finalidade do retorno de chamada callback-usage
callback é opcional. Essa função funciona sem ela, mas retorna uma ID somente quando um visitante tem um cookie 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 acontecer mesmo depois que a página é carregada e o visitante recebe uma nova ID. Para evitar isso, callback força essa função a procurar uma ID de visitante depois que a página é carregada. Sem callback, a função de ID de visitante não retornará uma ID, mesmo que ela seja gravada no navegador do visitante posteriormente.
Próximas etapas next-steps
Depois de ter a ID de usuário e região, você pode começar a enviar e receber dados do DCS. Consulte Fazer chamadas de DCS API.