Método de creación DIL dil-create

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

Creación de DIL dil-create-new

Crea un instancia específico DIL para socio.

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

Elementos initConfig

IMPORTANT
Siempre se visitorServicerequiere la Propiedad. 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

Este Propiedad establece el ID de contenedor que utiliza el Audience Manager para las sincronizaciones de ID. Usted 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 es necesario configurarlo correctamente. Póngase en contacto con el consultor para obtener una lista de sus sitios y sus contenedor ID.

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

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

Consulte también idSyncContainerID.

declaredId
Objeto

declaredId se utiliza para pasar cualquiera de las:

  • dpid : ID del socio de datos asignado por Audience Manager .
  • dpuuid : su ID único para una usuario.

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

Nota: Si utiliza el servicio de identidad de Adobe Experience Platform, establezca los ID de cliente con elmétodo en lugar de setCustomerIDs DIL. Consulte ID de cliente y EstadosAuthentication.

delayAllUntilWindowLoad
Booleano
Si es true, aplaza la ejecución de todas las solicitudes (IFRAME, llamadas evento, sincronizar de ID y destino) hasta que se active el Page Load evento. El valor predeterminado es false .
disableDeclaredUUIDCookie
Booleano
Falso de forma predeterminada, lo que significa que Audience Manager establece un cookie en el dominio del socio (establece un cookie propio).
disableDestinationPublishingIframe
Booleano

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

Si true , no adjuntará el IFRAME de publicación de destino al DOM ni activará destinos. El valor predeterminado es false .

disableIDSyncs
Booleano

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

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

enableErrorReporting
Booleano
Configúrelo para true activar los sistema de informes de error en todas las instancias DIL del Página. Solo funciona con booleano true .
iframeAkamaiHTTPS
Booleano

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

Especifica si los plantilla de publicación de destino deben 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. Lanzado con v2.4.
namespace
Cadena

Obligatorio.

El namespace par clave-valor contiene su Experience Cloud identificador de organización. Si no dispone de este ID, puede encontrarlo en la sección Administración del panel de Experience Cloud . Se necesitan permisos de administrador para vista este panel. Consulte las características y funciones del producto, preguntas frecuentesy administración: User Management y preguntas más frecuentes.

partner
Cadena

Obligatorio.

Nombre del socio proporcionado por Audience Manager .

removeFinishedScriptsAndCallbacks
Booleano
Elimina scripts y devoluciones de llamada. El valor predeterminado es False . Solo se aplica a la instancia DIL actual. Lanzado con v3.3.
uuidCookie
Objeto
Establece un cookie con el ID de usuario único devuelto por Audience Manager . Consulte uuidCookie Propiedades.
visitorService
Objeto

Requerido con DIL 6.2 o superior.

DIL se basa en la función del setCustomerIDs servicio de identidad de Adobe Experience Platform para pasar los ID declarados a Audience Manager. Consulte ID de cliente y EstadosAuthentication para 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 el DIL instancia. Un intento fallido devuelve un objeto de error (no lanzado) si el código está configurado incorrectamente o cada vez que se encuentra un error.

Propiedades uuidCookie uuidcookie-props

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

uuidCookie tiene las siguientes propiedades:

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

Propiedades de visitorService visitor-service-props

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

visitorService tiene las siguientes propiedades:

Nombre
Tipo
Descripción
namespace
Cadena
Requerido. Representa el ID de organización Experience Cloud. Esto es necesario para Experience Cloud funcionalidad de servicios principales. El mismo parámetro utilizado para crear instancias del 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