Declared IDs declared-ids
Cómo funcionan declared IDs, configurar procedimientos, ejemplos de código y variables.
Declared ID Objetivo declared-id-targeting
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 declared-id-targeting-purpose
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:
setVisitorID
proporcionada por el servicio de identidad de Adobe Experience Platform y pasa esto al Audience Manager de .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.
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 opt-out-calls
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 opt-out-examples
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.
https://domain name/demoptout.jpg?d_cid=123%01987...
https://domain name/demoptout?d_cid_ic=456%01321...
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:
d_uuid
https://domain/demoptout.jpg?d_uuid=AAM ID
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ícitohttps://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 variables-and-syntax
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.
d_cid =data provider ID %01user ID
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
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 sample-event-calls
Dados estos pares clave-valor y su sintaxis requerida, realizaría llamadas de evento como se muestra a continuación.
https://domain name/event?d_cid=123%01987...
https://domain name/event?d_cid_ic=456%01321...
d_cid
y d_cid_ic
.https://domain name/event?d_cid=123%01987&d_cid_ic=456%01321...
Declared ID Variables 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 dil-id-service-pass-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 deprecated-functions
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
:
dpid
dpuuid
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
}
});
d_dpuuid
y d_dpid
.Pasar los ID después de DIL instancias
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 request-response-examples
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 do-not-target
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.