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:

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.

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.

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:

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:

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.

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 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
    }
 });

Pasar los ID después de DIL instancias

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.