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.
Obter a ID de usuário do cookie do serviço de ID get-user-ids-from-service-cookie
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.
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.
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.
(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.