Declared IDs declared-ids
Cómo declared IDs trabajar, configurar procedimientos, ejemplos de código y variables.
Declared ID Objetivo declared-id-targeting
Intercambio y sincronización de ID de usuario con Audience Manager desde dispositivos o exploradores que no utilizan o aceptan mecanismos de almacenamiento persistentes, como los de terceros cookies.
Finalidad de Declared ID Segmentación declared-id-targeting-purpose
Algunos exploradores, y la mayoría de los dispositivos móviles, no aceptan cookies de terceros cookies. 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 en una llamada de evento. Además, una declared ID puede actuar como un ID universal que se aplique al mismo usuario en todas las soluciones de Experience Cloud. En la tabla siguiente se describe el proceso de segmentación/coincidencia de ID:
setVisitorID
función proporcionada por el Servicio de identidad de Adobe Experience Platform y se lo pasa a Audience Manager .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 la variable Experience Cloud Servicio de ID y DIL en las páginas del sitio que desee utilizar para la recopilación de datos. Consulte DIL crear y Variables de ID declaradas.
Llamadas de exclusión opt-out-calls
El declared ID el proceso respeta las preferencias de los visitantes del sitio para desactivar Audience Manager segmentación por su sitio web. Cuándo Audience Manager recibe una solicitud de exclusión, la variable JSON devuelto por el DCS contiene el código de error 171, con el mensaje Encountered opt out tag
, en lugar del Audience Manager ID de usuario.
- Audience Manager puede pasar un declared ID exclusión junto con un Audience Manager UUID en el URL.
- El declared ID la exclusión se almacena en el Profile Cache Server (PCS) en función de cada socio. No hay exclusión a nivel de plataforma mediante declared IDs. Además, Audience Manager excluye al usuario de esa región en particular del perímetro de (la exclusión no se cruza con 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 hacer una declared ID solicitudes de exclusión con el d_cid
y d_cid_ic
pares clave-valor. 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
pares clave-valor.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
solamentehttps://domain/demoptout.jpg?d_uuid=AAM ID
https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID
Se almacena una exclusión a nivel de socio para la última asignación de esto dpid
+ dpuuid
AAM emparejar con 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 explícito d_uuid
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. Si la variable dpid
+ dpuuid
AAM AAM Si la combinación se asigna a otro UUID de, la exclusión se almacena bajo el UUID de que se pasa en la solicitud ( d_uuid
).
Variables y sintaxis para Declared IDs variables-and-syntax
En la tabla siguiente se enumeran los pares clave-valor que pasan su Audience Manager ID del proveedor de datos, ID de usuario o códigos de integración, si se utilizan. Nota, cursiva indica un marcador de posición variable. Se han agregado espacios para facilitar la lectura.
En cada par clave-valor:
- El
=
separa la clave de sus valores relacionados. - La no impresión ASCII carácter
%01
separa los valores.
d_cid =data provider ID %01user ID
d_cid
reemplaza d_dpid
y d_dpuuid
, que se consideran obsoletas, pero siguen siendo compatibles. Consulte CID reemplaza DPID y DPUUID.d_cid_ic =integration code %01user ID
d_cid_ic
reemplaza d_dpid
y d_dpuuid
, que están en desuso, pero que 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
pares clave-valor.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 mediante DIL hasta Audience Manager.
DIL utiliza el Adobe Experience Platform Identity Service para aprobar Declared IDs dil-id-service-pass-declared-ids
Cuando se utiliza con Servicio de identidad de Adobe Experience Platform, ya no es necesario que pase declared IDs con el obsoleto dpid
y dpuuid
variables. En su lugar, las versiones actuales de DIL confíe en el visitorService
para obtener la función declared IDs desde el setCustomerIDs
función en la Adobe Experience Platform Identity Service. Para obtener más información, consulte ID de cliente y estados de autenticación. Usted llamaría a visitorService
in DIL.create
como se muestra a continuación.
var vDil = DIL.create({
partner:"partner name",
visitorService:{
namespace:"INSERT-MCORG-ID-HERE"
}
});
En el namespace
par clave-valor, MCORG
es su Experience Cloud ID de organización. Si no dispone de este ID, puede encontrarlo en la Administration de la sección Experience Cloud panel. 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+), no necesita utilizar estos pares clave-valor para pasar declared IDs. Eso es porque DIL ahora se basa en visitorService
función que se muestra en el ejemplo de código anterior. Esta función obtiene declared IDs desde el Adobe Experience Platform Identity Service. Sin embargo, aquí hacemos referencia a estas variables con fines históricos y heredados. Consulte el siguiente código para ver un ejemplo de cómo configurar DIL.create
para obtener una declared ID desde el Visitor ID Service.
En la tabla siguiente se describen las variables heredadas que utiliza la variable declaredId
objeto:
dpid
dpuuid
DPID y DPUUID
Audience Manager compara y hace coincidir el combinado de DPID
y DPUUID
a un ID de usuario correspondiente en nuestro sistema. Si no existe ningún ID, Audience Manager crea un nuevo ID de usuario y lo sincroniza con el DPID/DPUUID
combinación. Una Audience Manager coincide o crea un ID de usuario (el UUID
) devuelve ese ID en el JSON respuesta a la cookie en el dominio del cliente (de origen) cookie) u otro almacenamiento local.
Llame a esta función cuando esté utilizando DIL v6.1 o anterior. Sin embargo, esta función ha quedado obsoleta en favor de la nueva versión que obtiene declared IDs desde el Adobe Experience Platform Identity Service.
DIL.create({
partner : "partner name",
declaredId : {
dpuuid : dpuuid,
DPID : dpid
}
});
d_dpuuid
y d_dpid
llaves.Pasar ID después de DIL Instanciados
declaredID
combinación, la nueva combinación se utilizará solo para esa llamada. Las llamadas de evento regulares adicionales utilizarán el original DIL.create
declaredID
combinación.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 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 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 declared ID el proceso respeta las preferencias de los visitantes del sitio para desactivar Audience Manager segmentación por su sitio web. Cuándo Audience Manager recibe una solicitud de exclusión, la variable DCS devuelve un valor empty JSON en lugar del objeto Audience Manager ID de usuario.