método create del DIL

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 es necesario configurarlo correctamente. Póngase en contacto con el consultor 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 .

Consulte también idSyncContainerID .

declaredId

Objeto

declaredId se usa para pasar:

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

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

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, evita que todas las solicitudes (IFRAME, llamadas de evento, sincronización de ID y destino) se ejecuten hasta que se active el evento Page Load . El valor predeterminado es false .

disableDeclaredUUIDCookie

Booleano

Falso de forma 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 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 al DOM o a los destinos de activación. El valor predeterminado es false .

disableIDSyncs

Booleano

Importante: Este elemento ha quedado obsoleto 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 usar DIL v6.2+ 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

Configúrelo en true para habilitar el informe de errores para todas las instancias del DIL de la página. Solo funciona con Boolean true .

iframeAkamaiHTTPS

Booleano

Importante: Este elemento ha quedado obsoleto 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 la versión 2.4.

namespace

Cadena

Requerido.

El par namespace clave-valor contiene su ID de organización de Experience Cloud. Si no tiene este ID, puede encontrarlo en la sección Administración del panel Experience Cloud . Necesita permisos de administrador para ver este tablero. Consulte las Preguntas frecuentes sobre funciones y características del producto y Administración: administración de usuarios 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 llamadas de retorno. El valor predeterminado es False . Se aplica solo a la instancia del DIL actual. Publicado con la versión 3.3.

uuidCookie

Objeto

Establece una cookie con el ID de usuario único devuelto por el Audience Manager . Consulte propiedades de uuidCookie .

visitorService

Objeto

Requerido con DIL 6.2 o bueno.

El DIL se basa 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 siempre que 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 acceso 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 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 organización del Experience Cloud. Esto es necesario para la funcionalidad del servicio principal de Experience Cloud. El mismo parámetro utilizado 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" 
    } 
});

En esta página