DIL create method

DIL crear

Crea una instancia DIL específica del socio.

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

elementos initConfig

IMPORTANTE

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 define el ID de contenedor que utiliza Audience Manager para sincronizar los 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 el consultor para obtener una lista de los 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 está utilizando 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 active una sincronización de ID. Esto evita la duplicación.
  • Sólo el DIL envía datos a un destino de dirección URL .

Consulte también, idSyncContainerID .

declaredId

Objeto

declaredId se utiliza para pasar el:

  • dpid :: ID del socio de datos que le ha asignado el Audience Manager .
  • dpuuid :: Su ID única para un usuario.

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

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

delayAllUntilWindowLoad

Booleano

Si es true, se retrasa la ejecución de todas las solicitudes (IFRAME, llamadas de evento, sincronización de ID y destino) hasta que se activa el evento Page Load . 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 se ha desaprobado con la versión 8.0 del DIL (publicada en agosto de 2018). En su lugar, utilice 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 a los destinos DOM o fire. El valor predeterminado es false .

disableIDSyncs

Booleano

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

Deshabilita la sincronización de ID. Debe desactivar las sincronizaciones de ID al utilizar DIL v6.2 o posterior y el servicio de ID de Visitante. La función visitorService (consulte el código de muestra a continuación) se encarga de esta operación.

enableErrorReporting

Booleano

Establezca true para habilitar el sistema de informes de errores para todas las instancias del DIL de la página. Funciona solo con booleano true .

iframeAkamaiHTTPS

Booleano

Importante: Este elemento se ha desaprobado con la versión 8.0 del DIL (publicada en agosto de 2018). En su lugar, utilice la función visitor.idSyncSSLUseAkamai en 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 clave a otras claves . Publicado con v2.4.

namespace

Cadena

Requerido.

El par namespace clave-valor contiene el identificador de organización Experience Cloud . Si no tiene este ID, puede encontrarlo en la sección Administración del panel Experience Cloud . Necesita permisos de administrador para vista de este panel. Consulte las preguntas frecuentes sobre funciones y características del producto y administración: administración del usuario y preguntas más frecuentes .

partner

Cadena

Requerido.

Nombre del socio proporcionado por el Audience Manager .

removeFinishedScriptsAndCallbacks

Booleano

Elimina las secuencias de comandos y las rellamadas. El valor predeterminado es False . Se aplica únicamente a la instancia del DIL actual. Publicado con v3.3.

uuidCookie

Objeto

Establece una cookie con el identificador de usuario único devuelto por el Audience Manager . Consulte Propiedades de uidCookie .

visitorService

Objeto

Necesario con DIL 6.2 o bueno.

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

Código de ejemplo

Una llamada DIL de ejemplo 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 generado) si el código está configurado incorrectamente o si se encuentra un error.

Propiedades de uuidCookie

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 cookie, por ejemplo: '/test' ( / es el valor predeterminado).
domain 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 solo a través de una conexión HTTPS.

Propiedades de visitorService

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 La Organización Experience Cloud. Esto es necesario para la funcionalidad del servicio principal de Experience Cloud. El mismo parámetro utilizado para crear instancias de la funcionalidad de ID de Visitante.

Ejemplo de código:

var vDil = DIL.create({ 
    partner: 'demofirst', 
    visitorService: { 
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE" 
    } 
});

En esta página