Cómo declared IDs funciona, configura procedimientos, ejemplos de código y variables.
Intercambie y sincronice los ID de usuario con Audience Manager desde dispositivos o exploradores que no utilicen ni acepten mecanismos de almacenamiento persistentes, como cookies de terceros.
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 visitantes del sitio o la asignación de ID persistentes. Para resolver este problema, Audience Manager utiliza DIL para permitirle pasar declared IDs en 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 de evento | Para trabajar, necesita DIL y el código del servicio de identidad de Adobe Experience Platform en la página. DIL obtiene los ID declarados de la |
Id. de coincidencia | El 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 con el 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 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 comenzar, debe configurar el Experience Cloud servicio de ID y DIL en las páginas del sitio que desee utilizar para la recopilación de datos. Consulte Creación de DIL y Variables de ID declaradas.
El proceso declared ID respeta las preferencias de visitante del sitio para la exclusión de la segmentación 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 Audience Manager identificador de usuario.
Consulte Privacidad de datos para obtener más información sobre la exclusión de la recopilación de datos.
Puede realizar una solicitud de exclusión declared ID con los pares de valor clave 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.
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. |
|
Código de integración e ID de usuario. |
|
Varios pares |
|
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 |
---|---|
|
|
Opción de exclusión a nivel de socio |
Se almacena una exclusión a nivel de socio para la última asignación de este par |
|
|
La siguiente tabla lista los pares de clave-valor que pasan el ID de proveedor de datos Audience Manager y los ID de usuario o los códigos de integración, si se utilizan. Nota: cursiva indica un marcador de posición de variable. Se han agregado espacios para facilitar su lectura.
En cada par clave-valor:
=
separa la clave de sus valores relacionados.%01
separa los valores.Variable | Descripción |
---|---|
|
Contiene un ID de proveedor de datos y un ID de usuario único asociado en un solo par clave-valor. |
|
Contiene un código de integración y un ID de usuario único asociado en un solo par clave-valor. |
Dados estos pares de clave-valor y su sintaxis requerida, harí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. |
|
Código de integración e ID de usuario. |
|
Varios pares |
|
Describe las variables de configuración utilizadas para pasar declared IDs a DIL a Audience Manager.
Cuando se utiliza con el servicio de identidad de Adobe Experience Platform, ya no es necesario 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. Debe llamar 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 namespace
clave-valor, MCORG
es su identificador de organización Experience Cloud. Si no tiene este ID, puede encontrarlo en la sección Administration del panel Experience Cloud. Necesita permisos de administrador para vista de este panel. Consulte Administración: Servicios principales.
Con las últimas versiones de DIL (6.2+), no necesita utilizar 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 del Adobe Experience Platform Identity 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.
La siguiente tabla describe las variables heredadas utilizadas por el objeto declaredId
:
Nombre | Tipo | Descripción |
---|---|---|
dpid |
Cadena | ID del socio de datos asignado por el Audience Manager. |
dpuuid |
Cadena | El ID exclusivo de proveedor de datos para el usuario. |
Audience Manager compara y hace coincidir 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 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 al cookie en el dominio del cliente (origen cookie) 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 obtiene declared IDs de Adobe Experience Platform Identity Service.
DIL.create({
partner : "partner name",
declaredId : {
dpuuid : dpuuid,
DPID : dpid
}
});
Debe desarrollar mediante programación el código que proporciona los valores de ID para las claves d_dpuuid
y d_dpid
.
Si realiza una llamada API con una combinación declaredID
diferente, la nueva combinación se utilizará sólo para esa llamada. Otras llamadas de evento regulares utilizarán la combinación DIL.create
declaredID
original.
DIL.getDil('partner name').api.signals({...}).declaredId({
dpuuid : dpuuid
dpid : dpid
}).submit();
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 de Audience Manager (por ejemplo, UUID
) que se escribe en una cookie de origen en el dominio de la página.
myCallback({
...
"uuid":"abc123"
})
El proceso declared ID respeta las preferencias de visitante del sitio para la exclusión de la segmentación Audience Manager por parte del sitio Web. Cuando Audience Manager recibe una solicitud de exclusión, el DCS devuelve un objeto JSON vacío en lugar del identificador de usuario Audience Manager.