Obter IDs de usuário e regiões por meio do Adobe Experience Platform Identity Service 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 DCS Chamadas de API.

A variável Serviço de identidade da Adobe Experience Platform O atribui IDs de visitante e região aos usuários que chegam ao site. Essas IDs identificam os usuários em todas as soluções da Experience Cloud e eles são necessários se você quiser fazer DCS chamadas.

  • A variável user ID O é necessário para identificar e associar dados a um visitante específico.
  • A variável region ID é necessário porque está vinculado a um nome de servidor regional, ao qual você precisa enviar dados para o DCS. A variável DCS O armazena informações em data centers geograficamente mais próximos dos 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.

Código no itálico representa um espaço reservado para variável.

Tarefa
Descrição
1. Verifique o seu Experience Cloud status

Você precisa de um Experience Cloud conta para usar o serviço de ID. Se você tiver uma Experience Cloud conta, ótimo!

Se você não fizer parte do Experience Cloud, em seguida, inscreva-se. Adoraríamos tê-lo e sempre há espaço para mais. Para obter instruções sobre como configurar uma conta, consulte Ativação de suas soluções para os serviços principais.

2. Configurar o Serviço de ID
A variável Serviço de ID O consiste no código JavaScript que é colocado em cada página que você deseja usar para a coleta de dados do. Consulte o serviço de ID guias de implementação para obter mais informações.
3. Leia o Serviço de ID cookie

A variável Serviço de ID O armazena a ID do usuário e da região no cookie AMCV. O nome completo do cookie é AMCV_###@AdobeOrg. A variável ### Os elementos do são espaços reservados para a ID da organização. Consulte Cookies e a ID do Experience Cloud para obter detalhes.

Analise o cookie AMCV para esses pares de valores chave:

  • mid=user ID: esse par de valores chave contém a variável Experience Cloud ID de usuário.
  • aamlh=region ID: esse par de valores chave contém a ID da região (às vezes chamada de dica de localização) que está associado a um nome de servidor regional.

Você pode fazer chamadas para a variável DCS depois de ter as IDs de usuário e região.

4. Recuperar o ID do Experience Cloud com getMarketingCloudVisitorID

(Opcional) Esta função retorna a variável Experience Cloud ID de visitante. Ele foi projetado para soluções personalizadas e casos de uso específicos. Consulte Trabalhar com getMarketingCloudVisitorID abaixo e o documentação do serviço de ID relacionado.

Não é necessário usar se você obter as IDs de usuário e de local do cookie do serviço de ID.

Trabalhar com getMarketingCloudVisitorID working-with-getmarketingcloudvisitorid

Outra maneira de obter a ID de visitante é com o getMarketingCloudVisitorID função. Quando invocada, essa função consulta o ID service e retorna uma ID. getMarketingCloudVisitorID aceita o opcional callback 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 uma Experience Cloud cookie no navegador. Se o cookie do visitante estiver ausente ou um visitante não tiver uma ID, a função retornará um cookie vazio () objeto. 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 para verificar 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 se ela for gravada no navegador do visitante posteriormente.

Próximas etapas next-steps

Depois de ter a ID do usuário e da região, você pode começar a enviar e receber DCS dados. Consulte Como fazer chamadas de DCS API.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695