Configuración del SDK web

La configuración del SDK se realiza con configure comando.

alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

Hay muchas opciones que se pueden configurar durante la configuración. Todas las opciones se encuentran a continuación, agrupadas por categoría.

Opciones generales

edgeConfigId

Su ID de configuración asignado, que vincula el SDK con las cuentas y la configuración adecuadas. Al configurar varias instancias dentro de una sola página, debe configurar una diferente edgeConfigId para cada instancia.

context context

Indica las categorías de contexto que se recopilarán automáticamente según se describe en Información automática. Si no se especifica esta configuración, se utilizan todas las categorías de forma predeterminada.

Para habilitar sugerencias de cliente de alta entropía en la implementación del SDK web, debe incluir los highEntropyUserAgentHints opción de contexto, junto con la configuración existente.

Por ejemplo, para recuperar sugerencias de cliente de alta entropía de las propiedades web, la configuración tendría este aspecto:

context: ["highEntropyUserAgentHints", "web"]

debugEnabled

Indica si la depuración está habilitada. Estableciendo esta configuración en true habilita las siguientes funciones:

edgeDomain edge-domain

Rellene este campo con el dominio de origen. Para obtener más información, consulte la documentación.

El dominio es similar a data.{customerdomain.com} para un sitio web en www.{customerdomain.com}.

edgeBasePath edge-base-path

Ruta después del edgeDomain utilizado para comunicarse e interactuar con los servicios de Adobe. A menudo, esto solo cambiaría al no utilizar el entorno de producción predeterminado.

orgId

Su asignado Experience Cloud ID de organización. Al configurar varias instancias dentro de una página, debe configurar un orgId para cada instancia.

Recopilación de datos

clickCollectionEnabled clickCollectionEnabled

Indica si los datos asociados con los clics en vínculos se recopilan automáticamente. Consulte Seguimiento automático de vínculos para obtener más información. Los vínculos también se etiquetan como vínculos de descarga si incluyen un atributo de descarga o si el vínculo termina con una extensión de archivo. Los calificadores de vínculos de descarga se pueden configurar con una expresión regular. El valor predeterminado es "\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$"

onBeforeEventSend

Configure una llamada de retorno a la que se llame para cada evento justo antes de enviarlo. Un objeto con el campo xdm se envía a la llamada de retorno. Para cambiar lo que se envía, modifique la xdm objeto. Dentro de la llamada de retorno, la variable xdm ya tiene los datos pasados en el comando de evento y la información recopilada automáticamente. Para obtener más información sobre la temporización de esta llamada de retorno y ver un ejemplo, consulte Modificación global de eventos.

onBeforeLinkClickSend onBeforeLinkClickSend

Configure una llamada de retorno que se invoque para cada evento de seguimiento de clics en vínculos justo antes de enviarlo. La llamada de retorno envía un objeto con el xdm, clickedElement, y data campos.

Al filtrar el seguimiento de vínculos mediante la estructura de elementos DOM, puede utilizar la variable clickElement comando. clickedElement es el nodo de elemento DOM en el que se hizo clic y que ha encapsulado el árbol de nodos principal.

Para cambiar los datos que se envían, modifique la xdm y/o data objetos. Dentro de la llamada de retorno, la variable xdm ya tiene los datos pasados en el comando de evento y la información recopilada automáticamente.

Opciones de privacidad

defaultConsent default-consent

Establece el consentimiento predeterminado del usuario. Utilice esta configuración cuando no haya ninguna preferencia de consentimiento ya guardada para el usuario. Los otros valores válidos son "pending" y "out". Este valor predeterminado no se mantiene en el perfil del usuario. El perfil del usuario se actualiza solo cuando setConsent se llama.

Opciones de personalización personalization

prehidingStyle prehidingStyle

Se utiliza para crear una definición de estilo CSS que oculta las áreas de contenido de la página web mientras se carga contenido personalizado desde el servidor. Si no se proporciona esta opción, el SDK no intenta ocultar ninguna área de contenido mientras se carga el contenido personalizado, lo que podría provocar un "parpadeo".

Por ejemplo, si un elemento de la página web tiene un ID de container, cuyo contenido predeterminado desea ocultar mientras se carga contenido personalizado desde el servidor, utilice el siguiente estilo de ocultamiento previo:

  prehidingStyle: "#container { opacity: 0 !important }"

targetMigrationEnabled targetMigrationEnabled

Esta opción debe utilizarse al migrar páginas individuales desde at.js al SDK web.

Utilice esta opción para permitir que el SDK web lea y escriba el archivo heredado mbox y mboxEdgeCluster cookies que utilizan los at.js. Esto le ayuda a mantener el perfil del visitante mientras se desplaza de una página que utiliza el SDK web a una página que utiliza el at.js y viceversa.

Opciones de audiencias

cookieDestinationsEnabled

Habilita Audience Manager destinos de cookies, lo que permite configurar las cookies en función de la calificación de segmentos.

urlDestinationsEnabled

Habilita Audience Manager Destinos URL, que permite activar direcciones URL basadas en la calificación de segmentos.

Opciones de identidad

idMigrationEnabled id-migration-enabled

Si el valor es True, el SDK lee y establece cookies AMCV antiguas. Esta opción ayuda a realizar la transición al uso del SDK web de Adobe Experience Platform, mientras que algunas partes del sitio pueden seguir utilizando Visitor.js.

Si la API de visitante se define en la página, el SDK consulta la API de visitante para el ECID. Esta opción le permite etiquetar páginas con el SDK web de Adobe Experience Platform y seguir teniendo el mismo ECID.

thirdPartyCookiesEnabled

Habilita la configuración de cookies de terceros de Adobe. El SDK puede mantener el ID de visitante en un contexto de terceros para permitir que se utilice el mismo ID de visitante en todos los sitios. Utilice esta opción si tiene varios sitios o si desea compartir datos con socios; sin embargo, a veces esta opción no se desea por motivos de privacidad.