Configuración del SDK

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

IMPORTANTE

configure debe ser siempre el primer comando llamado.

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

Tipo Requerido Valor predeterminado
Cadena ninguna

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

context

Tipo Requerido Valor predeterminado
Matriz de cadenas No ["web", "device", "environment", "placeContext"]

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

debugEnabled

Tipo Requerido Valor predeterminado
Booleano No false

Indica si se debe habilitar la depuración. Al configurar esta configuración para que true habilite las siguientes funciones:

Función Función
Validación sincrónica Valida los datos que se recopilan con el esquema y devuelve un error en la respuesta bajo la siguiente etiqueta: collect:error OR success
Registro de la consola Permite que los mensajes de depuración se muestren en la consola JavaScript del explorador

edgeDomain

Tipo Requerido Valor predeterminado
Cadena No beta.adobedc.net

Dominio utilizado para interactuar con servicios de Adobe. Solo se utiliza si tiene un dominio de origen (CNAME) que proxies solicitudes a la infraestructura perimetral de Adobe.

orgId

Tipo Requerido Valor predeterminado
Cadena ninguna

Your assigned Experience Cloud organization ID. Al configurar varias instancias dentro de una página, debe configurar una diferente orgId para cada instancia.

Recopilación de datos

clickCollectionEnabled

Tipo Requerido Valor predeterminado
Booleano No true

Indica si los datos asociados con los clics en vínculos se deben recopilar automáticamente. Consulte Seguimiento automático de vínculos para obtener más información.

onBeforeEventSend

Tipo Requerido Valor predeterminado
Función No () => undefined

Configure esta opción para configurar una llamada de retorno que se llame para cada evento justo antes de que se envíe. Se xdm envía un objeto con el campo a la llamada de retorno. Modifique el xdm objeto para cambiar lo que se envía. Dentro de la llamada de retorno, el xdm objeto ya tendrá los datos pasados en el comando evento y la información recopilada automáticamente. Para obtener más información sobre la temporización de esta llamada de retorno y un ejemplo, consulte Modificación global de Eventos.

Opciones de privacidad

Tipo Requerido Valor predeterminado
Objeto No "in"

Establece el consentimiento predeterminado del usuario. Se utiliza cuando no hay ninguna preferencia de consentimiento ya guardada para el usuario. El otro valor válido es "pending". Cuando se establece, el trabajo se pone en cola hasta que el usuario proporciona las preferencias de consentimiento. Una vez proporcionadas las preferencias del usuario, el trabajo continúa o se anula según sus preferencias. Consulte Compatibilidad con el consentimiento para obtener más información.

Opciones de personalización

prehidingStyle

Tipo Requerido Valor predeterminado
Cadena No ninguna

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 dar como resultado un "parpadeo".

Por ejemplo, si tuviera un elemento en la página web con un ID del container contenido predeterminado que desee ocultar mientras se carga contenido personalizado desde el servidor, un ejemplo de estilo de ocultación previa sería el siguiente:

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

Opciones de audiencias

cookieDestinationsEnabled

Tipo Requerido Valor predeterminado
Booleano No true

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

urlDestinationsEnabled

Tipo Requerido Valor predeterminado
Booleano No true

Habilita los destinos Audience Manager de URL, lo que permite activar las URL en función de la calificación del segmento.

Opciones de identidad

idMigrationEnabled

Tipo Requerido Valor predeterminado
Booleano No true

Si el valor es true, el SDK leerá y configurará las cookies AMCV antiguas. Esto ayuda con la transición al uso del SDK web de Adobe Experience Platform, mientras que algunas partes del sitio pueden seguir utilizando Visitante.js. Además, si la API de Visitante está definida en la página, el SDK consulta la API de Visitante para el ECID. Esto le permite dualizar las páginas de etiquetas con el SDK web de AEP y seguir teniendo el mismo ECID.

thirdPartyCookiesEnabled

Tipo Requerido Valor predeterminado
Booleano No true

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. Esto resulta útil si tiene varios sitios o desea compartir datos con socios; sin embargo, a veces esto no es deseable por razones de privacidad.

En esta página