Show Menu
TOPICS×

Integración directa con el servicio de servicio de identidad de Experience Cloud

Esta implementación permite a los clientes utilizar el servicio de ID en dispositivos que no pueden aceptar ni trabajar con nuestro código JavaScript o SDK. Esto incluye dispositivos, como las consolas de videojuegos, los televisores inteligentes u otras aplicaciones compatibles con Internet. Consulte esta sección para obtener información sobre sintaxis, ejemplos de código y definiciones.

Sintaxis

Los dispositivos que no pueden utilizar las bibliotecas de códigos VisitorAPI.js o SDK pueden hacer llamadas directamente a los servidores de recopilación (DCS) utilizados por el servicio de ID. Para ello, llamaría a
dpm.demdex.net
y daría formato a su solicitud, tal como se muestra a continuación. La letra en
cursiva
indica un marcador de posición de variable.
En este ejemplo de sintaxis, el
d_
prefijo identifica los pares clave-valor de la llamada como una variable de nivel del sistema. Puede pasar bastantes
d_
parámetros al servicio de ID, pero céntrese en los pares clave-valor, tal como se muestra en el código de más arriba. Para obtener más información sobre otras variables, consulte Supported Attributes for DCS API calls (Atributos admitidos para llamadas de API de DCS).
El servicio de ID admite las llamadas de HTTP y HTTPS. Utilice HTTPS para pasar datos desde una página segura.

Solicitud de ejemplo

Su solicitud puede asemejarse al ejemplo que se muestra a continuación. Se han reducido las variables largas.

Respuesta de ejemplo

El servicio de ID devuelve datos en un objeto JSON, tal como se muestra a continuación. Su respuesta puede ser distinta.
{ "d_mid":"12345", "dcs_region":"6", "id_sync_ttl":"604800", "d_blob":"wxyz5432" }

Parámetros de solicitud y respuesta definidos

Parámetros de respuesta
Parámetro
Descripción
dpm.demdex.net
Un dominio heredado controlado por
Adobe
. Consulte Explicación de las llamadas al dominio Demdex .
d_mid
El ID de visitante de Experience Cloud. Consulte la información relativa a las cookies y el servicio de servicio de identidad de Experience Cloud .
d_orgid
Su ID de organización de Experience Cloud. Para obtener ayuda sobre cómo encontrar este ID, consulte Requisitos del servicio de servicio de identidad de Experience Cloud .
d_cid
Un parámetro opcional que pasa el ID de proveedor de datos (DPID), el ID de usuario único (DPUUID) y un ID de estado autenticado al servicio de ID. Como se muestra en el ejemplo de código, separe el DPID y el DPUUID con el carácter de control no imprimible,
%01
.
DPID y DPUUID
En el parámetro
d_cid
, asigne cada combinación relacionada de DPID y DPUUID con el mismo parámetro
d_cid
. De esta forma, puede devolver varios conjuntos de ID en una única solicitud. Asimismo, separe el DPID, el DPUUID y el indicador de autenticación opcional con el carácter no imprimible,
%01
. En los ejemplos siguientes, el proveedor y los ID de usuario aparecen resaltados con el texto en
negrita
.
  • Sintaxis:
    ...d_cid=DPID%01DPUUID%01authentication state...
  • Ejemplo:
    ...d_cid=123%01456%011...
Estado de autenticación
Se trata de un ID opcional en el parámetro
d_cid
. Se expresa como un entero e identifica a los usuarios en función de su estado de autenticación, como se muestra a continuación:
  • 0
    (Desconocido)
  • 1
    (Autenticado)
  • 2
    (Desconectado)
Para especificar un estado de autenticación, se establece este indicador después de la variable de ID usuario (UUID). Separe el UUID y el indicador de autenticación con el carácter de control no imprimible,
%01
. En los ejemplos siguientes, los ID de autenticación aparecen resaltados con el texto en
negrita
.
Sintaxis:
...d_cid=DPID%01DPUUID%01authentication state
Ejemplos:
  • Desconocido:
    ...d_cid=123%01456%010...
  • Autenticado:
    ...d_cid=123%01456%011...
  • Desconectado:
    ...d_cid=123%01456%012...
dcs_region
El servicio de ID es un sistema geográficamente distribuido y de carga equilibrada. El ID identifica la región del centro de datos que gestiona la llamada. Consulte DCS Region IDs, Locations, and Host Names (ID de región de DCS, ubicaciones y nombres de host).
d_cb
(Opcional)
Un parámetro de rellamada le permite ejecutar una función de JavaScript en el cuerpo de solicitud.
d_blob
Un bloque cifrado de metadatos de JavaScript. Las restricciones de tamaño limitan el blob a 512 bytes o menos.
d_ver
Requerido. Esto establece el número de versión de la API. Deje esto establecido como
d_ver=2
.
Parámetros de repuesta
Algunos parámetros de respuesta forman parte de la solicitud y se han definido en la sección de más arriba.
Parámetro
Descripción
id_sync_ttl
El intervalo de resincronización, especificado en segundos. El intervalo predeterminado es 604 800 segundos (7 días).