Show Menu
TOPICS×

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 o SDK. Isso inclui dispositivos como consoles de jogos, smart TVs ou outros dispositivos que se conectam à Internet. Consulte esta seção para saber mais sobre a sintaxe, os exemplos de código e as 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 do DCS .
O serviço de ID oferece suporte às chamadas HTTP e HTTPS. Use HTTPS para passar dados de uma página segura.

Solicitação de exemplo

Sua solicitação pode ser semelhante ao exemplo mostrado abaixo. As variáveis longas foram reduzidas.

Resposta de exemplo

O serviço de ID retorna dados em um objeto JSON, como mostrado abaixo. 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 de 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 e 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 de carga balanceada distribuído geograficamente. A ID identifica a região do data center que processa 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
Uma parte criptografada dos metadados do JavaScript. As restrições de tamanho limitam a bolha 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 da nova sincronização, especificado em segundos. O intervalo padrão é de 604.800 segundos (7 dias).