Declared IDs

Funcionamiento de declared IDs, configuración de procedimientos, ejemplos de código y variables.

Declared ID Segmentación

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

Objetivo de Declared ID Segmentación

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 en una llamada de evento. Además, un declared ID puede actuar como un ID universal que se aplica al mismo usuario en todas las soluciones del Experience Cloud. En la tabla siguiente se describe el proceso de establecimiento de objetivos/coincidencia con ID:

Proceso Descripción
Llamada de evento

Para funcionar, necesita DIL y el código del servicio de identidad de Adobe Experience Platform en la página. El DIL obtiene los ID declarados de la setVisitorID función proporcionada por el servicio de identidad de Adobe Experience Platform y los pasa a Audience Manager .

Coincidencia de ID

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, el Audience Manager crea un nuevo ID y lo asocia con el ID del cliente y del 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 retorno

El Audience Manager escribe su ID sincronizado en una cookie de origen (u otro espacio de almacenamiento accesible) en el dominio o la aplicación del cliente.

Llamadas de evento posteriores

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 servicio de Experience Cloud 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.

Llamadas de exclusión

El proceso declared ID respeta las preferencias de los visitantes del sitio de excluirse 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 ID de usuario.

  • Audience Manager puede pasar una declared ID exclusión junto con una Audience Manager UUID en URL.
  • La exclusión declared ID se almacena en el Profile Cache Server (PCS) por 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 en el borde (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 declared ID solicitud de exclusión con los pares de 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 y referencias heredados. Las exclusiones heredadas incluyen:

Exclusión (obsoleto) Ejemplo de código

d_uuid solamente

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

Exclusión a nivel de socio

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

Se almacena una exclusión a nivel de socio para la asignación más reciente de este par dpid + dpuuid a un UUID AAM. Si no hay ninguna asignación existente anteriormente, el 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 UUID de AAM nuevo 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 combinación dpid + dpuuid se asigna a otro UUID de AAM, la exclusión se almacena en el UUID de AAM pasado en la solicitud ( d_uuid ).

Variables y sintaxis para Declared IDs

En la tabla siguiente se enumeran los pares clave-valor que pasan el ID del proveedor de datos Audience Manager y los ID de usuario o los códigos de integración, si se utilizan. Tenga en cuenta que la 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 d_dpid y 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 d_dpid y d_dpuuid , que están en desuso, pero que siguen siendo compatibles. Consulte CID reemplaza DPID y DPUUID .

Ejemplo de llamadas de evento

Dados estos pares clave-valor y la sintaxis necesaria, debe realizar llamadas de evento como se muestra a continuación.

Inclusión de llamada de evento 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 de DIL a Audience Manager.

DIL utiliza el Adobe Experience Platform Identity Service para pasar Declared IDs

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 la 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 namespace clave-valor, MCORG es su Experience Cloud ID de organización. Si no tiene este ID, 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+), no es necesario utilizar estos pares clave-valor para pasar declared IDs. Esto se debe a que DIL ahora se basa en 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í 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 desde el Visitor ID Service.
La tabla siguiente describe las variables heredadas que utiliza 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 coincide con el ID de usuario combinado DPID y DPUUID con el ID de usuario correspondiente en 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 (cookie de origen) u otro almacenamiento local.

Llame a esta función cuando esté utilizando 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
    }
 });
NOTA

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

Pasar ID después de DIL instancias

NOTA

Si realiza una llamada API con una combinación declaredID diferente, la nueva combinación solo se utilizará para esa llamada. Las llamadas de evento normales adicionales utilizarán la combinación original DIL.create 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 dirigir ni excluir llamadas

El proceso declared ID respeta las preferencias de los visitantes del sitio de excluirse 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 ID de usuario Audience Manager.

En esta página