método de creación del DIL dil-create

WARNING
A partir de julio de 2023, el Adobe ha interrumpido el desarrollo de la extensión Data Integration Library (DIL) y DIL.
Los clientes existentes pueden seguir usando su implementación de DIL. Sin embargo, el Adobe no se desarrollará DIL más allá de este punto. Se recomienda a los clientes que evalúen SDK web de Experience Platform para su estrategia de recopilación de datos a largo plazo.
Los clientes que deseen implementar nuevas integraciones de recopilación de datos a partir de julio de 2023 deben utilizar SDK web de Experience Platform en su lugar.

DIL crear dil-create-new

Crea una instancia DIL específica del socio.

Firma de función: DIL.create: function (initConfig) {}

Elementos initConfig

IMPORTANT
La propiedad visitorService es siempre necesaria. Otras propiedades enumeradas aquí son opcionales, a menos que se indique lo contrario.

initConfig acepta los siguientes elementos:

Nombre
Tipo
Descripción
containerNSID
Número entero

Esta propiedad establece el identificador de contenedor que usa el Audience Manager de para las sincronizaciones de ID. Establecería containerNSID si tiene DIL implementado en varios sitios. Cada uno de estos sitios tendrá su propio ID de contenedor y sincronizaciones de ID. Cuando solo tiene 1 sitio, el ID de contenedor es 0 de forma predeterminada y no necesita configurarlo correctamente. Póngase en contacto con su consultor de para obtener una lista de sus sitios y sus ID de contenedor.

En el servicio de identidad de Adobe Experience Platform , la propiedad idSyncContainerID corresponde a containerNSID en el DIL . Tenga en cuenta lo siguiente si utiliza el DIL y el servicio de ID en varios sitios:

  • Para cada sitio, establezca los mismos ID de contenedor en containerNSID y idSyncContainerID .
  • Tanto el DIL como el servicio de ID intentarán enviar sincronizaciones de ID a nuestro iFrame de recopilación de datos. Sin embargo, el iFrame garantiza que el DIL no activará una sincronización de ID. Esto evita la duplicación.
  • Solo el DIL envía datos a un destino de URL .

Ver también idSyncContainerID.

declaredId
Objeto

declaredId se usa para pasar el:

  • dpid : ID del socio de datos asignado a usted por el Audience Manager .
  • dpuuid : su ID único de usuario.

Importante: Utilice únicamente valores no codificados para sus ID. La codificación creará identificadores con codificación doble.

Nota: Si usa el servicio de identidad de Adobe Experience Platform , establezca los identificadores de cliente con el método setCustomerIDs en lugar del DIL . Ver ID de cliente y estados de autenticación.

delayAllUntilWindowLoad
Booleano
Si el valor es True, retrasa la ejecución de todas las solicitudes (IFRAME, llamadas de evento, sincronización de ID y destino) hasta que se desencadene el evento Page Load . El valor predeterminado es false .
disableDeclaredUUIDCookie
Booleano
False de manera predeterminada, lo que significa que el Audience Manager establece una cookie en el dominio del socio (establece una cookie de origen).
disableDestinationPublishingIframe
Booleano

Importante: Este elemento ha quedado obsoleto con el DIL versión 8.0 (lanzado en agosto de 2018). En su lugar, use la función visitor.disableIdSyncs en el servicio de identidad de Adobe Experience Platform.

Si true , no adjuntará el IFRAME de publicación de destino al DOM o a los destinos de activación. El valor predeterminado es false .

disableIDSyncs
Booleano

Importante: Este elemento ha quedado obsoleto con el DIL versión 8.0 (lanzado en agosto de 2018). En su lugar, use la función visitor.disableIdSyncs en el servicio de identidad de Adobe Experience Platform.

Deshabilita la sincronización de ID. Debe deshabilitar las sincronizaciones de ID al usar DIL v6.2 o posterior y el servicio de ID de visitante. La función visitorService (consulte el código de ejemplo siguiente) se encarga de esta operación.

enableErrorReporting
Booleano
Se establece en true para habilitar los informes de errores para todas las instancias de DIL de en la página. Solo funciona con Boolean true .
iframeAkamaiHTTPS
Booleano

Importante: Este elemento ha quedado obsoleto con el DIL versión 8.0 (lanzado en agosto de 2018). En su lugar, use la función visitor.idSyncSSLUseAkamai en el servicio de identidad de Adobe Experience Platform.

Especifica si la plantilla de publicación de destino debe utilizar Akamai para conexiones HTTPS. Habilitado por socio.

mappings
Objeto
Asocia el valor de un par clave-valor a otro. Consulte Asignar valores de clave a otras claves. Publicado con la versión 2.4.
namespace
Cadena

Requerido.

El par clave-valor namespace contiene el identificador de organización del 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 las Preguntas frecuentes sobre las funciones y características del producto y Administración dey : administración de usuarios y preguntas frecuentes.

partner
Cadena

Requerido.

Nombre de socio proporcionado por el Audience Manager de .

removeFinishedScriptsAndCallbacks
Booleano
Quita los scripts y las llamadas de retorno. El valor predeterminado es False . Solo se aplica a la instancia actual del DIL . Publicado con la versión 3.3.
uuidCookie
Objeto
Establece una cookie con el identificador de usuario único devuelto por el Audience Manager . Ver propiedades uuidCookie.
visitorService
Objeto

Requerido con el DIL 6.2 o superior.

El DIL se basa en la función setCustomerIDs del servicio de identidad de Adobe Experience Platform para pasar los identificadores declarados al Audience Manager . Consulte ID de cliente y estados de autenticaciónpara obtener más información.

Código de ejemplo

Una llamada de ejemplo DIL podría tener un aspecto similar al siguiente:

var partnerObject1 = DIL.create({
  partner: "partner name",
  visitorService:{
    namespace: "INSERT-ORGANIZATION-ID-HERE"
  },
  containerNSID: 3,
  uuidCookie:{
    name:'ad_uuid',
    days:200,
    path:'/test',
    domain:'adobe.com',
    secure:true
  }
});

var partnerObject2 = DIL.create({
  partner: "partner name",
  visitorService:{
    namespace: "INSERT-MCORG-ID-HERE"
  },
  containerNSID: 3
});

Una respuesta correcta devuelve la instancia DIL. Un intento fallido devuelve un objeto de error (no arrojado) si el código está configurado incorrectamente o siempre que se encuentre un error.

Propiedades de uuidCookie uuidcookie-props

Define las propiedades utilizadas por la variable uuidCookie. Esta variable forma parte del método DIL.create.

uuidCookie tiene las siguientes propiedades:

Nombre
Descripción
name
El nombre de la cookie ( aam_did es el predeterminado).
days
Duración de la cookie (100 días es el valor predeterminado).
path
Ruta de la cookie, p. ej., '/test' ( / es el valor predeterminado).
domain
Dominio en el que se establece la cookie, por ejemplo: 'adobe.com' ( '.'+document.domain es el predeterminado).
secure
Establece un indicador para enviar datos únicamente a través de una conexión HTTPS.

Propiedades de visitorService visitor-service-props

Define las propiedades utilizadas por la variable visitorService. Esta variable forma parte del método DIL.create.

visitorService tiene las siguientes propiedades:

Nombre
Tipo
Descripción
namespace
Cadena
Requerido. Representa El Id. De Organización Del Experience Cloud. Esto es necesario para la funcionalidad del servicio principal de Experience Cloud. El mismo parámetro se utiliza para crear una instancia de la funcionalidad de ID de visitante.

Ejemplo de código:

var vDil = DIL.create({
    partner: 'demofirst',
    visitorService: {
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
    }
});
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695