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

WARNING
A partir de julio de 2023, el Adobe ha interrumpido el desarrollo del Data Integration Library (DIL) y el DIL extensión.
Los clientes existentes pueden seguir utilizando su DIL implementación. 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 un socio específico DIL ejemplo.

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

initConfig Elements

IMPORTANT
El visitorService la propiedad es siempre requerido. 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 define el ID de contenedor que utiliza Audience Manager para sincronizar los ID. Que usted fijara 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 in DIL . Tenga en cuenta lo siguiente si está utilizando DIL y el servicio de ID en varios sitios:

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

Consulte también. idSyncContainerID.

declaredId
Objeto

declaredId se utiliza para pasar el:

  • dpid : ID del socio de datos asignado a usted por 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 utiliza la variable Servicio de identidad de Adobe Experience Platform, establezca los ID de cliente con setCustomerIDs en lugar de DIL . Consulte ID de cliente y estados de autenticación.

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

Importante: Este elemento ha quedado obsoleto con DIL versión 8.0 (lanzada en agosto de 2018). Utilice el visitor.disableIdSyncs funciónen el servicio de identidad de Adobe Experience Platform.

If 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 DIL versión 8.0 (lanzada en agosto de 2018). Utilice el visitor.disableIdSyncs funciónen 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. El visitorService (consulte el código de ejemplo que aparece a continuación) se encarga de esta operación.

enableErrorReporting
Booleano
Configure como. true para habilitar los informes de errores para todos DIL instancias en la página. Funciona con Boolean true solo.
iframeAkamaiHTTPS
Booleano

Importante: Este elemento ha quedado obsoleto con DIL versión 8.0 (lanzada en agosto de 2018). Utilice el visitor.idSyncSSLUseAkamai funciónen el servicio de identidad de Adobe Experience Platform.

Especifica si la plantilla de publicación de destino debería 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 namespace el par clave-valor contiene 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 la Preguntas frecuentes sobre funciones y características del productoy Administración: administración de usuarios y preguntas frecuentes.

partner
Cadena

Requerido.

Nombre del socio proporcionado por Audience Manager .

removeFinishedScriptsAndCallbacks
Booleano
Quita los scripts y las llamadas de retorno. El valor predeterminado es False . Se aplica al actual DIL solo instancia de. Publicado con la versión 3.3.
uuidCookie
Objeto
Establece una cookie con el ID único de usuario devuelto desde Audience Manager . Consulte Propiedades de uuidCookie.
visitorService
Objeto

Requerido con DIL 6,2 o bueno.

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

Código de ejemplo

Una muestra DIL La llamada de 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 valor DIL ejemplo. 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 uuidCookie variable. Esta variable forma parte de la variable DIL.create método.

uuidCookie tiene las siguientes propiedades:

Nombre
Descripción
name
El nombre de la cookie ( aam_did es el valor predeterminado).
days
Duración de la cookie (100 días es el valor predeterminado).
path
Ruta de la cookie, por ejemplo, '/test' ( / es el valor predeterminado).
domain
El dominio en el que se establece la cookie, por ejemplo, 'adobe.com' ( '.'+document.domain es el valor 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 visitorService variable. Esta variable forma parte de la variable DIL.create método.

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