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

O Adobe Experience Platform Identity Service atribui IDs de visitante e região a usuários que chegam ao seu site. Essas IDs identificam usuários em todas as soluções no Experience Cloud e são necessárias se você deseja fazer chamadas 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 dados para o DCS. O DCS armazena informações em data centers que são geograficamente os mais próximos aos 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 de variável.

Tarefa Descrição

1. Verifique o 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 ter você e sempre há espaço para mais. Para obter instruções sobre como configurar uma conta, consulte Ativando suas soluções para os serviços principais.

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 na 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 de região no cookie AMCV. O nome completo do cookie é AMCV_###@AdobeOrg. Os elementos ### são marcadores de posição da ID da organização. Consulte Cookies e o Experience Cloud ID para obter detalhes.

Analise o cookie AMCV para esses pares de valores chave:

  • mid=user ID: Esse par de valores chave contém a Experience Cloud ID.
  • aamlh=region ID: Esse par de valor-chave contém a ID de região (às vezes chamada de dica de localização) 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.

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 Trabalhar com getMarketingCloudVisitorID abaixo e a documentação do serviço de ID relacionado.

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

Trabalhar com getMarketingCloudVisitorID

Outra maneira de obter a ID de visitante é com a função getMarketingCloudVisitorID . Quando invocada, essa função consulta o ID service e retorna uma ID. getMarketingCloudVisitorID aceita o callback argumento opcional como mostrado:

var analyticsID = visitor.getAnalyticsVisitorID(callback)

Uso e finalidade do retorno de chamada

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 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 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

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

Nesta página