Show Menu
TEMAS×

ID declarados

Funcionamiento de los ID declarados, configuración de procedimientos, ejemplos de código y variables.

Orientación a ID declarado

Intercambie y sincronice los ID de usuario con Audience Manager desde dispositivos o navegadores que no utilicen ni acepten mecanismos de almacenamiento persistentes, como cookies de terceros.

Objetivo del objetivo de ID declarado

Algunos exploradores y la mayoría de los dispositivos móviles no aceptan cookies de terceros. Esto dificulta la retención de información sobre los visitantes del sitio o la asignación de ID persistentes. Para resolver este problema, Audience Manager utiliza DIL para permitirle pasar declared IDs una llamada de evento. Además, un declared ID puede actuar como ID universal que se aplica al mismo usuario en todas las soluciones del Experience Cloud. En la tabla siguiente se describe el proceso de coincidencia/establecimiento de objetivos de ID:
Proceso Descripción
Llamada al evento
Para trabajar, necesita DIL y el código del servicio de ID de Experience Cloud en la página. DIL obtiene ID declarados de la función ID de visitante establecida por el servicio de ID de Experience Cloud y lo pasa a Audience Manager .
Id. de coincidencia
Audience Manager intenta hacer coincidir el ID de cliente y de visitante con un ID correspondiente en nuestro sistema. Si no existe un ID coincidente, Audience Manager crea un nuevo ID y lo asocia al ID de cliente y de visitante.
Nota: La asignación más reciente se utiliza si su ID se asigna a más de un ID de Audience Manager.
ID de devolución
Audience Manager escribe su ID sincronizada en una cookie de origen (u otro espacio de almacenamiento direccionable) en el dominio o la aplicación cliente.
Llamadas a eventos posteriores
Las llamadas de evento adicionales leen el ID de Audience Manager desde el dominio del cliente y lo envían a Audience Manager.
Para comenzar, debe configurar el servicio de Experience Cloud ID y DIL las páginas del sitio que desee utilizar para la recopilación de datos. Consulte DIL crear y declarar variables de ID.

Llamadas de exclusión

El declared ID proceso respeta las preferencias de los visitantes del sitio para que el sitio web no pueda optar por la segmentación de Audience Manager. Cuando Audience Manager recibe una solicitud de exclusión, el JSON que devuelve el DCS contiene el código de error 171, con el mensaje "Se encontró la etiqueta de desactivación", en lugar del ID de usuario de Audience Manager.
  • Audience Manager puede pasar una declared ID exclusión junto con Audience Manager UUID en la URL.
  • La declared ID exclusión se almacena en el servidor de caché de perfiles de [(PCS) por socio. No hay ninguna opción de exclusión a nivel de plataforma que utilice declared IDs. Además, Audience Manager excluye al usuario de esa región concreta del borde (la exclusión no cruza DCS las regiones).
Consulte Privacidad de datos para obtener más información sobre la exclusión de la recopilación de datos.

Ejemplos de exclusión de ID declarados

Puede realizar solicitudes de declared ID exclusión con los pares d_cid y d_cid_ic clave-valor. Los parámetros heredados como d_dpid y d_dpuuid siguen funcionando, pero se consideran obsoletos. Consulte CID sustituye DPID y DPUUID . In the examples, italics indicates a variable placeholder.

Opciones de exclusión con CID y CID_IC

Para obtener una descripción y sintaxis, consulte Variables URL y Sintaxis de los ID declarados.
Opción de exclusión mediante Ejemplo de código
ID de proveedor de datos e ID de usuario.
https:// nombre de dominio /demoptout.jpg?d_cid=123%01987...
Código de integración e ID de usuario.
https:// nombre de dominio/demoptout?d_cid_ic=456%01321...
Varios pares d_cid y d_cid_ic clave-valor.
https:// nombre de dominio/demoptout?d_cid=123%01987&d_cid_ic=456%01321...

Opciones de exclusión con DPID, DPUUID y UUID (obsoleto)

Estos métodos siguen funcionando pero se consideran obsoletos. Esta información se proporciona con fines y referencias heredados. Las exclusiones heredadas incluyen:
Opción de exclusión (desaprobada) Ejemplo de código
solo d_uuid
https:// domain /demoptout.jpg?d_uuid=AAM ID
Opción de exclusión a nivel de socio
https://demoptout.jpg?d_dpuuid= de ID de usuario y d_dpid= ID de proveedor de datos
Se almacena una exclusión a nivel de socio para la asignación más reciente de este par dpid + dpuuid a un UUID de AAM. Si no hay ninguna asignación anterior, Audience Manager comprueba si la solicitud contiene un UUID de AAM en la cookie y, en caso afirmativo, lo utiliza para almacenar la exclusión. De lo contrario, Audience Manager genera un nuevo UUID de AAM y almacena la exclusión en él.
d_dpuuid + d_dpid y explícito _uuid
https:// domain /demoptout.jpg?d_uuid= ID de usuario&d_dpuuid= ID de usuario del proveedor de datos& d_dpid=ID del proveedor de datos
d_uuid siempre tiene prioridad. Si la combinación dpid + dpuuid se asigna a otro UUID de AAM, la exclusión se almacena bajo el UUID de AAM pasado en la solicitud ( d_uuid ).

Variables y sintaxis para ID declarados

En la tabla siguiente se muestran los pares clave-valor que pasan el ID de proveedor de datos y los ID de usuario o los códigos de integración, si se utilizan. Audience Manager Note, italics indicates a variable placeholder. Se han agregado espacios para facilitar su lectura.
En cada par clave-valor:
  • El = símbolo separa la clave de sus valores relacionados.
  • El carácter no imprimible ASCII %01 separa los valores.
Variable Descripción
d_cid = ID del proveedor de datos %01 ID del usuario
Contiene un ID de proveedor de datos y un ID de usuario único asociado en un solo par clave-valor. d_cid reemplaza a d_dpid y d_dpuuid , que se consideran obsoletos, pero que siguen siendo compatibles. Consulte CID sustituye DPID y DPUUID .
d_cid_ic = código de integración %01 ID de usuario
Contiene un código de integración y un ID de usuario único asociado en un solo par clave-valor. d_cid_ic reemplaza a d_dpid y d_dpuuid , que están en desuso, pero aún son compatibles. Consulte CID sustituye DPID y DPUUID .

Ejemplo de llamadas a eventos

Dados estos pares clave-valor y su sintaxis requerida, haría llamadas de evento como se muestra a continuación.
La llamada al evento incluye Ejemplo de código
ID de proveedor de datos e ID de usuario.
https:// nombre de dominio/evento?d_cid=123%01987...
Código de integración e ID de usuario.
https:// nombre de dominio/evento?d_cid_ic=456%01321...
Varios pares d_cid y d_cid_ic clave-valor.
https:// nombre de dominio/evento?d_cid=123%01987&d_cid_ic=456%01321...

Variables de ID declaradas

Describe las variables de configuración utilizadas para pasar ID declarados DIL a Audience Manager.

DIL utiliza el servicio Experience Cloud ID para pasar ID declarados

Cuando se utiliza con el servicio Experience Cloud ID, ya no es necesario pasar declared IDs con las variables dpid y dpuuid obsoletas. En su lugar, las versiones actuales de DIL confían en la visitorService función para obtener el declared IDs resultado de la setCustomerIDs función en la Experience Cloud ID Service. Para obtener más información, consulte ID de cliente y estados de autenticación. Llamaría visitorService a DIL.create como se muestra a continuación.
var vDil = DIL.create({
  partner:"partner name",
  visitorService:{
    namespace:"INSERT-MCORG-ID-HERE"
  }
});

En el par namespace clave-valor, MCORG es su identificador Experience Cloud de organización. Si no tiene este ID, puede encontrarlo en la Administration sección del Experience Cloud tablero. Necesita permisos de administrador para ver este tablero. See Administration: Core Services .

Funciones obsoletas

Con las últimas versiones de DIL (6.2 o posterior), no es necesario utilizar estos pares de clave-valor para pasar declared IDs. Esto se debe a que DIL ahora depende de la visitorService función mostrada en el ejemplo de código anterior. Esta función se obtiene declared IDs de la Experience Cloud ID Service. Sin embargo, aquí estamos haciendo referencia a estas variables con fines históricos y heredados. Consulte el código siguiente para ver un ejemplo de cómo configurar DIL.create para obtener un declared ID de Visitor ID Service. En la tabla siguiente se describen las variables heredadas utilizadas por el declaredId objeto:
Nombre Tipo Descripción
dpid Cadena
ID del socio de datos asignado por Audience Manager.
dpuuid Cadena
El ID exclusivo de proveedor de datos para el usuario.

DPID y DPUUID

Audience Manager compara y coincide con el ID de usuario combinado DPID y DPUUID con el ID de usuario correspondiente de nuestro sistema. Si no existe un ID, Audience Manager crea un nuevo ID de usuario y lo sincroniza con la DPID/DPUUID combinación. Una vez que Audience Manager coincide o crea un ID de usuario (el UUID ), devuelve ese ID en la JSON respuesta a la cookie en el dominio del cliente (cookie de origen) u otro almacenamiento local.
Llame a esta función cuando esté utilizando DIL v6.1 o anterior. Sin embargo, esta función se ha desaprobado en favor de la nueva versión que se obtiene declared IDs de la Experience Cloud ID Service.
DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

Tenga en cuenta que debe desarrollar mediante programación el código que proporciona los valores de ID para las d_dpuuid claves y d_dpid .

Pasar ID después de crear instancias de DIL

Si realiza una API llamada con una declaredID combinación diferente, la nueva combinación se utilizará solamente para esa llamada. Las llamadas a eventos regulares adicionales utilizarán la DIL.create combinación original declaredID .
DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

Ejemplos de solicitud/respuesta

La solicitud envía un proveedor de datos y un ID de usuario a Audience Manager:
https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678

La respuesta devuelve el ID de Audience Manager (por ejemplo, UUID ) que se escribe en una cookie de origen en el dominio de la página.
myCallback({
...
   "uuid":"abc123"
})

No segmentar ni rechazar llamadas

El declared ID proceso respeta las preferencias de los visitantes del sitio para que el sitio web no pueda optar por la segmentación de Audience Manager. Cuando Audience Manager recibe una solicitud de exclusión, la DCS devuelve un JSON objeto vacío en lugar del ID de usuario de Audience Manager.