Integração direta com o serviço de identidade da Experience Cloud direct-integration-with-the-experience-cloud-id-service

Essa implementação permite que os clientes usem o serviço de ID em dispositivos que não podem aceitar ou trabalhar com nosso código JavaScript ou SDK. Isso inclui dispositivos como consoles de jogos, TVs inteligentes ou outros dispositivos habilitados para a Internet. Consulte esta seção para obter sintaxe, exemplos de código e definições.

Sintaxe section-a4754afec5ad40b6be00d6f1011d68bb

Os dispositivos que não podem usar VisitorAPI.js ou as bibliotecas de código do SDK podem fazer chamadas diretamente para os servidores de coleta de dados (DCS) usados pelo serviço de ID. Para fazer isso, é necessário chamar dpm.demdex.net e formatar a solicitação como mostrado abaixo. Itálico indica um marcador de posição variável.

Neste exemplo de sintaxe, o d_ prefixo identifica os pares de valores chave na chamada como uma variável do sistema. Você pode passar alguns d_ parâmetros para o serviço de ID, mas manter o foco nos pares de valores chave como mostrado no código acima. Para obter mais informações sobre outras variáveis, consulte Atributos compatíveis para chamadas de API DCS.

O serviço de ID suporta chamadas HTTP e HTTPS. Use HTTPS para enviar dados de uma página segura.

Exemplo de solicitação section-26302b8851704888b6f8e6b2071bcdb0

Sua solicitação pode ser semelhante à amostra exibida abaixo. Variáveis longas foram encurtadas.

Exemplo de resposta section-89bc103b3e9e4a8b98e74c32897b1200

O serviço de ID retorna dados em um objeto JSON, como mostrado abaixo. A sua resposta pode ser diferente.

{
     "d_mid":"12345",
     "dcs_region":"6",
     "id_sync_ttl":"604800",
     "d_blob":"wxyz5432"
}

Parâmetros de solicitação e resposta definidos section-4a9912b545364dc4acad4f1ea5ec641d

Parâmetros da solicitação

Parâmetro
Descrição
dpm.demdex.net
Um domínio herdado controlado pela Adobe. Consulte Compreender as chamadas para o domínio Demdex.
d_mid
A ID do visitante da Experience Cloud. Consulte Cookies e o serviço de identidade da Experience Cloud.
d_orgid
Sua ID da organização da Experience Cloud. Para obter ajuda para encontrar essa ID, consulte Requisitos do serviço de identidade da Experience Cloud.
d_cid

Um parâmetro opcional que passa a ID do provedor de dados (DPID), o identificador de usuário único (DPUUID) e uma ID de estado autenticada para o serviço de ID. Como mostrado na amostra de código, separe a DPID e a DPUUID com o caractere de controle não imprimível, %01.

DPID e DPUUID

No parâmetro d_cid, atribua cada combinação de DPID e DPUUID relacionada ao mesmo parâmetro d_cid. Isso permite que você retorne diversos conjuntos de IDs em uma única solicitação. Além disso, separe a DPID, a DPUUID e o sinalizador de autenticação opcional com o caractere de controle não imprimível, %01. Nos exemplos abaixo, o provedor e as IDs do usuário são destacadas com texto em negrito.

  • Sintaxe: ...d_cid=DPID%01DPUUID%01estado de autenticação...
  • Exemplo: ...d_cid=123%01456%011...

Estado de autenticação

Essa é uma ID opcional no parâmetro d_cid. Expressa como um inteiro, identifica os usuários de acordo com o status de autenticação como mostrado abaixo:

  • 0 (Desconhecido)
  • 1 (Autenticado)
  • 2 (Logout realizado)

Para especificar um estado de autenticação, você define esse sinalizador após a variável da ID de usuário (UUID). Separe a UUID e o sinalizador de autenticação com o caractere de controle não imprimível, %01. Nos exemplos abaixo, as IDs de autenticação estão destacadas com texto em negrito.

Sintaxe: ...d_cid=DPID%01DPUUID%01estado de autenticação

Exemplos:

  • Desconhecido: ...d_cid=123%01456%010...
  • Autenticado: ...d_cid=123%01456%011...
  • Logout: ...d_cid=123%01456%012...
dcs_region
O serviço de ID é um sistema distribuído geograficamente e com balanceamento de carga. A ID identifica a região do data center que manipula a chamada. Consulte IDs da região do DCS, locais e nomes de host.
d_cb
(Opcional) Um parâmetro de retorno de chamada que permite a você executar uma função do JavaScript no corpo da solicitação.
d_blob
Um pedaço criptografado de metadados JavaScript. As restrições de tamanho limitam o blob a 512 bytes ou menos.
d_ver
Obrigatório. Isso define o número de versão da API. Deixe essa opção configurada como d_ver=2.

Parâmetros de resposta

Alguns parâmetros de resposta fazem parte da solicitação e foram definidos na seção acima.

Parâmetro
Descrição
id_sync_ttl
O intervalo de re-sincronização, especificado em segundos. O intervalo padrão é de 604.800 segundos (7 dias).
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a