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 o trabajar con nuestro código JavaScript o SDK. Esto incluye dispositivos como consolas de juegos, televisores inteligentes u otros dispositivos habilitados para 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 Atributos admitidos para las llamadas API de DCS.

El servicio de ID admite llamadas HTTP y HTTPS. Utilice HTTPS para pasar datos de una página segura.

Solicitud de ejemplo

Su solicitud podría ser similar al ejemplo que se muestra a continuación. Se han abreviado las variables largas.

Respuesta de ejemplo

El servicio de ID devuelve datos en un objeto JSON como se muestra a continuación. Su respuesta puede ser diferente.

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

Parámetros de solicitud y respuesta definidos

Parámetros de solicitud

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 distribuido geográficamente y con equilibrio de carga. 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 fragmento 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 respuesta

Algunos parámetros de respuesta forman parte de la solicitud y se han definido en la sección anterior.

Parámetro Descripción

id_sync_ttl

Intervalo de resincronización, especificado en segundos. El intervalo predeterminado es de 604 800 segundos (7 días).

En esta página