Show Menu
TEMAS×

Configuración del SDK

La configuración del SDK se realiza con el configure comando .
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
none
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 Información recopilada automáticamente 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
none
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. Para los clics que se califican como clics en vínculos, se recopilan los siguientes datos de interacción webinteraction.schema.md Web:
Propiedad
Descripción
Nombre del vínculo
Nombre determinado por el contexto del vínculo
URL del vínculo
URL normalizada
Tipo de vínculo
Configurar para descargar, salir u otro

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

defaultConsent

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
none
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 la configuración de cookies en función de la calificación de segmentos.

urlDestinationsEnabled

Tipo
Requerido
Valor predeterminado
Booleano
No
true
Habilita los destinos Audience Manager URL, lo que permite activar las direcciones 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 en la transición al uso del SDK web de AEP, 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.