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:

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.

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.

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 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:

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

Pasar ID después de DIL Instanciados

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.