Show Menu
TÓPICOS×

Integração direta com o serviço de identidade da Experience Cloud

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

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.

Solicitação de exemplo

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

Resposta de exemplo

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

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), a ID de usuário exclusiva (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).