Documentación Audience Manager Guía del usuario de Audience Manager

Declared IDs

Última actualización: 20 de julio de 2024

Temas:

Cómo funcionan declared IDs, configurar procedimientos, ejemplos de código y variables.

Declared ID Objetivo

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

Objetivo del direccionamiento de Declared ID

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 usa DIL para permitirle pasar declared IDs en una llamada de evento. Además, un declared ID puede actuar como un identificador universal que se aplica al mismo usuario en todas las soluciones del Experience Cloud. En la tabla siguiente se describe el proceso de segmentación/coincidencia de ID:

Proceso	Descripción
Llamada de evento	Para trabajar, necesita el DIL y el código del servicio de identidad de Adobe Experience Platformen la página. El DIL obtiene ID declarados de la función `setVisitorID` proporcionada por el servicio de identidad de Adobe Experience Platform y pasa esto al Audience Manager de .
ID de coincidencia	El Audience Manager intenta hacer coincidir el ID de cliente y el ID de visitante con un ID correspondiente en nuestro sistema. Si no existe ningún ID coincidente, Audience Manager crea un nuevo ID y lo asocia al ID de cliente y al ID de visitante. Nota: Se utilizará la asignación más reciente si el ID se asigna a más de un ID de Audience Manager.
Identificador de devolución	El Audience Manager escribe su ID sincronizado en una cookie de origen (u otro espacio de almacenamiento direccionable) en el dominio o la aplicación del cliente.
Llamadas de evento subsiguientes	Las llamadas de evento adicionales leen el ID de Audience Manager del dominio del cliente y lo envían al Audience Manager.

Para empezar, debe configurar el servicio de ID de Experience Cloud y DIL en todas las páginas del sitio que desee usar para la recopilación de datos. Ver DIL crear y Variables de ID declaradas.

Llamadas de exclusión

El proceso de declared ID respeta las preferencias de los visitantes del sitio para no participar en la segmentación de Audience Manager por parte del sitio web. Cuando Audience Manager recibe una solicitud de exclusión, el JSON devuelto por el DCS contiene el código de error 171, con el mensaje Encountered opt out tag, en lugar del ID de usuario Audience Manager.

Audience Manager puede pasar una exclusión de declared ID junto con un Audience Manager UUID en URL.
La exclusión de declared ID se almacena en Profile Cache Server (PCS) por socio. No hay exclusión a nivel de plataforma al usar declared IDs. Además, Audience Manager excluye al usuario de esa región en particular del perímetro (la exclusión no cruza DCS regiones).

Consulte Privacidad de datos para obtener más información sobre la exclusión de la recopilación de datos.

Declared ID ejemplos de exclusión

Puede realizar una solicitud de exclusión de declared ID con los pares clave-valor d_cid y d_cid_ic. Los parámetros heredados como d_dpid y d_dpuuid siguen funcionando, pero se consideran obsoletos. Consulte CID reemplaza DPID y DPUUID. En los ejemplos, la cursiva indica un marcador de posición para una variable.

Exclusiones con CID y CID_IC

Para obtener una descripción y sintaxis, consulte variables de URL y Sintaxis para ID declarados.

Opción de exclusión mediante	Ejemplo de código
ID de proveedor de datos e ID de usuario.	`https://domain name/demoptout.jpg?d_cid=123%01987...`
Código de integración e ID de usuario.	`https://domain name/demoptout?d_cid_ic=456%01321...`
Varios pares de clave-valor `d_cid` y `d_cid_ic` .	`https://domain name/demoptout?d_cid=123%01987&d_cid_ic=456%01321...`

Exclusiones con DPID, DPUUID y UUID (obsoleto)

Estos métodos siguen funcionando, pero se consideran obsoletos. Esta información se proporciona con fines heredados y de referencia. Las exclusiones heredadas incluyen:

Opción de exclusión (obsoleta) Ejemplo de código

Solo d_uuid https://domain/demoptout.jpg?d_uuid=AAM ID

Opción de exclusión de nivel de socio

Opción de exclusión (obsoleta)	Ejemplo de código
Solo `d_uuid`	`https://domain/demoptout.jpg?d_uuid=AAM ID`
Opción de exclusión de nivel de socio	`https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID` AAM 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. Si no hay ninguna asignación existente anteriormente, el Audience Manager AAM comprueba si la solicitud contiene un UUID de en la cookie y, si lo tiene, la utiliza para almacenar la exclusión. De lo contrario, Audience Manager AAM genera un nuevo UUID de UUID y almacena la exclusión en él.
`d_dpuuid` + `d_dpid` y `d_uuid` explícito	`https://domain/demoptout.jpg?d_uuid= user ID&d_dpuuid= data provider's user ID&d_dpid=data provider ID` `d_uuid` siempre tiene prioridad. AAM AAM Si la combinación `dpid` + `dpuuid` se asigna a otro UUID de, la exclusión se almacena en el UUID de la pasado en la solicitud ( `d_uuid` ).

https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID

AAM 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. Si no hay ninguna asignación existente anteriormente, el Audience Manager AAM comprueba si la solicitud contiene un UUID de en la cookie y, si lo tiene, la utiliza para almacenar la exclusión. De lo contrario, Audience Manager AAM genera un nuevo UUID de UUID y almacena la exclusión en él.

d_dpuuid + d_dpid y d_uuid explícito

https://domain/demoptout.jpg?d_uuid= user ID&d_dpuuid= data provider's user ID&d_dpid=data provider ID

d_uuid siempre tiene prioridad. AAM AAM Si la combinación dpid + dpuuid se asigna a otro UUID de, la exclusión se almacena en el UUID de la pasado en la solicitud ( d_uuid ).

Variables y sintaxis para Declared IDs

En la tabla siguiente se enumeran los pares de clave-valor que pasan su identificador de proveedor de datos Audience Manager y los identificadores de usuario o códigos de integración, si se utilizan. Tenga en cuenta que cursiva indica un marcador de posición de variable. Se han agregado espacios para facilitar la lectura.

En cada par clave-valor:

El símbolo = separa la clave de sus valores relacionados.
El carácter ASCII no imprimible %01 separa los valores.

Variable	Descripción
`d_cid =data provider ID %01user ID`	Contiene un ID de proveedor de datos y un ID de usuario único asociado en un único par clave-valor. `d_cid` reemplaza a `d_dpid` y a `d_dpuuid` , que se consideran obsoletos pero que siguen siendo compatibles. Consulte CID reemplaza DPID y DPUUID.
`d_cid_ic =integration code %01user ID`	Contiene un código de integración y un ID de usuario único asociado en un único par clave-valor. `d_cid_ic` reemplaza a `d_dpid` y `d_dpuuid` , que están en desuso, pero siguen siendo compatibles. Consulte CID reemplaza DPID y DPUUID.

Llamadas de evento de muestra

Dados estos pares clave-valor y su sintaxis requerida, realizaría llamadas de evento como se muestra a continuación.

La llamada de evento incluye	Ejemplo de código
ID de proveedor de datos e ID de usuario.	`https://domain name/event?d_cid=123%01987...`
Código de integración e ID de usuario.	`https://domain name/event?d_cid_ic=456%01321...`
Varios pares de clave-valor `d_cid` y `d_cid_ic` .	`https://domain name/event?d_cid=123%01987&d_cid_ic=456%01321...`

Declared ID Variables

Describe las variables de configuración utilizadas para pasar declared IDs a través de DIL a Audience Manager.

DIL usa Adobe Experience Platform Identity Service para pasar Declared IDs

Cuando se usa con el servicio de identidad de Adobe Experience Platform, ya no necesita pasar declared IDs con las variables dpid y dpuuid obsoletas. En su lugar, las versiones actuales de DIL dependen de la función visitorService para obtener declared IDs de la función setCustomerIDs en Adobe Experience Platform Identity Service. Para obtener más información, consulte ID de cliente y estados de autenticación. Llamaría a visitorService en DIL.create como se muestra a continuación.

var vDil = DIL.create({
  partner:"partner name",
  visitorService:{
    namespace:"INSERT-MCORG-ID-HERE"
  }
});

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

Funciones obsoletas

Con las últimas versiones de DIL (6.2 o posterior), no necesita usar estos pares clave-valor para pasar declared IDs. Esto se debe a que DIL ahora depende de la función visitorService que se muestra en el ejemplo de código anterior. Esta función obtiene declared IDs de Adobe Experience Platform Identity Service. Sin embargo, aquí hacemos 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 que usa el objeto declaredId:

Nombre

Tipo

Descripción

dpid

Cadena

ID del socio de datos asignado por el Audience Manager.

dpuuid

Cadena

El ID único de proveedor de datos para el usuario.

DPID y DPUUID

Audience Manager compara y hace coincidir la combinación de DPID y DPUUID con el ID de usuario correspondiente en nuestro sistema. Si no existe ningún identificador, Audience Manager crea un nuevo identificador de usuario y lo sincroniza con la combinación DPID/DPUUID. Una vez que Audience Manager coincide o crea un id. de usuario (el UUID), devuelve ese id. en la respuesta JSON a cookie en el dominio del cliente (cookie de origen) u otro almacenamiento local.

Llame a esta función cuando esté usando DIL v6.1 o una versión anterior. Sin embargo, esta función ha quedado obsoleta en favor de la nueva versión que obtiene declared IDs de Adobe Experience Platform Identity Service.

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

NOTE

Debe desarrollar mediante programación el código que proporciona los valores de identificador para las claves d_dpuuid y d_dpid.

Pasar los ID después de DIL instancias

NOTE

Si realiza una llamada de API con una combinación de declaredID diferente, la nueva combinación solo se utilizará para esa llamada. Las llamadas de evento regulares adicionales usarán la combinación DIL.create declaredID original.

DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

Ejemplos de solicitudes/respuestas

La solicitud envía un proveedor de datos y un identificador 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 del Audience Manager (por ejemplo, UUID) que se escribe en una cookie de origen en el dominio de página.

myCallback({
...
   "uuid":"abc123"
})

Llamadas de no segmentación y de exclusión

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

recommendation-more-help