Declared IDs

Cómo declared IDs funciona, configure procedimientos, ejemplos de código y variables.

Declared ID Segmentación

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

Objetivo del Declared ID objetivo

Algunos exploradores y la mayoría de los dispositivos móviles no aceptan cookies. 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 permitir que se pase declared IDs 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 ID declarados de la setVisitorID función proporcionada por el servicio de identidad de Adobe Experience Platform y lo pasa a Audience Manager .

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 servicio de Experience Cloud ID y DIL las páginas del sitio que desee utilizar para la recopilación de datos. Consulte DIL crear y declarar variablesde ID.

Llamadas de exclusión

El declared ID proceso respeta las preferencias de visitante del sitio para que el sitio web no Audience Manager tenga segmentación. When Audience Manager receives an opt-out request, the JSON returned by the DCS contains the error code 171, with the message Encountered opt out tag, instead of the Audience Manager user ID.

  • Audience Manager puede pasar una declared ID opción de exclusión junto con una Audience Manager en la UUID URL.
  • La declared ID exclusión se almacena en el Profile Cache Server (PCS) socio por socio. No hay ninguna opción de exclusión a nivel de plataforma que utilice declared IDs. Además, Audience Manager excluye al usuario de esa región en particular en el borde (la exclusión no cruza DCS las 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

You can make a declared ID opt-out requests with the d_cid and d_cid_ic key-value pairs. 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.

Opciones de exclusión 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 d_cid y d_cid_ic clave-valor.

https://domain name/demoptout?d_cid=123%01987&d_cid_ic=456%01321...

Opciones de exclusión con DPID, DPUUIDy 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:

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

d_uuid solamente

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

Opción de 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 dpid + dpuuid par a un UUID de AAM. Si no hay ninguna asignación anterior, el Audience Manager comprueba si la solicitud contiene un UUID de AAM en la cookie y, si lo hace, 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 bajo el UUID de AAM pasado en la solicitud ( d_uuid ).

Variables y sintaxis para Declared IDs

La siguiente tabla lista los pares de clave-valor que pasan el ID del proveedor de datos y los ID de usuario o los códigos de integración, si se utilizan. Audience Manager Note, italics indicates a variable placeholder. Se han agregado espacios para facilitar su lectura.

En cada par clave-valor:

  • El = símbolo separa la clave de sus valores relacionados.
  • El carácter no imprimible ASCII %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 solo 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 solo par clave-valor. d_cid_ic reemplaza d_dpid y d_dpuuid , que están en desuso, pero que aún son compatibles. Consulte CID reemplaza DPID y DPUUID .

Ejemplo de llamadas de Evento

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.

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 d_cid y d_cid_ic clave-valor.

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 DIL de Audience Manager.

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

Cuando se utiliza con Adobe Experience Platform Identity Service, ya no es necesario pasar declared IDs con las variables dpid y dpuuid obsoletas. En su lugar, las versiones actuales de DIL confían en la visitorService función para obtener el declared IDs resultado de la setCustomerIDs función en la Adobe Experience Platform Identity Service. Para obtener más información, consulte ID de cliente y estadosde autenticación. Llamaría visitorService a 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 Experience Cloud de organización. Si no tiene este ID, puede encontrarlo en la Administration sección del Experience Cloud panel. Necesita permisos de administrador para vista de este panel. See Administration: Core Services.

Funciones obsoletas

Con las últimas versiones de DIL (6.2 o posterior), no es necesario utilizar estos pares de clave-valor para pasar declared IDs. Esto se debe a que DIL ahora depende de la visitorService función mostrada en el ejemplo de código anterior. Esta función se obtiene declared IDs de la 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.
En la tabla siguiente se describen las variables heredadas utilizadas por el declaredId objeto:

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.

DPID y DPUUID

Audience Manager compara y hace coincidir la combinación DPID y DPUUID con un 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 DPID/DPUUID combinación. Una vez que Audience Manager coincide o crea un ID de usuario (el UUID), devuelve ese ID en la JSON respuesta al 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 una versión anterior. Sin embargo, esta función se ha desaprobado en favor de la nueva versión que se obtiene declared IDs de la 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 d_dpuuid claves y d_dpid .

Pasar ID después de DIL crear instancias

Nota

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

El declared ID proceso respeta las preferencias de visitante del sitio para que el sitio web no Audience Manager tenga segmentación. Cuando Audience Manager recibe una solicitud de exclusión, el DCS devuelve un JSON objeto vacío en lugar del ID de Audience Manager usuario.

En esta página