Referencia de Opt-in

Última actualización: 18 de julio de 2024
  • Temas:

Creado para:

  • Desarrollador
  • Usuario
  • Administrador
  • Líder

API para la biblioteca de Opt-in y referencia de ajustes de configuración.

La configuración de consentimiento se proporciona a las funciones de Opt-in como categorías:

adobe.OptInCategories = {
    "AAM": "aam",
    "ANALYTICS": "aa",
    "ECID": "ecid",
    "TARGET": "target"
}

Parámetros de configuración de Opt-in

Esta sección trata sobre el uso de la API para configurar Opt-in. Buena parte de la configuración y la implementación se pueden realizar utilizando la extensión de Experience Platform Launch.

Se proporcionan configuraciones de Opt-in en la función getInstance() de Visitor JavaScript, que crea una instancia del objeto global adobe. A continuación se enumeran las configuraciones de Visitor JS relacionadas con el servicio Opt-in.

doesOptInApply (boolean or function that evaluates to a boolean)

Si es falso, indica que los visitantes no tienen que incluirse. Hace que Experience Cloud cree cookies independientemente de las categorías que se hayan incluido. Esta configuración habilita o deshabilita la inclusión de forma integral.

preOptInApprovals (Object <adobe.OptInCategories enum: boolean>)

Define qué categorías se aprueban o rechazan cuando el visitante todavía no ha establecido preferencias. Se las conoce como valores predeterminados de organización.

previousPermissions (Object<adobe.OptInCategories enum: boolean>)

Las preferencias explícitamente establecidas del visitante. Los permisos en esta configuración sobrescriben los valores predeterminados de organización (previousPermissions sobrescribe preOptInApprovals).

isOptInStorageEnabled (boolean)

Habilita Opt-in para almacenar los permisos en una cookie de origen (dentro del dominio actual del cliente)

(Opcional) optInCookiesDomain (string)

Dominio o subdominio de origen a usar para la cookie de Opt-in (si isOptInStorageEnabled es “true”)

(Opcional) optInStorageExpiry (integer)

Número de segundos para anular la caducidad predeterminada de 13 meses

Cambios en los parámetros de consentimiento

En cualquier momento durante la experiencia en el sitio, un visitante puede establecer preferencias por primera vez o puede cambiar sus preferencias mediante CMP. Una vez que Visitor JS se ha inicializado con la configuración inicial, los permisos del visitante se pueden cambiar con las funciones siguientes:

adobe.optIn.approve(categories, shouldWaitForComplete)

Función que aprueba o incluye al visitante en todas las categorías de una lista. Para obtener más información sobre el parámetro shouldWaitForComplete, consulte Flujo de trabajo de inclusión.

adobe.optIn.deny(categories, shouldWaitForComplete)

Función que rechaza o excluye al visitante de todas las categorías especificadas.

adobe.optIn.approveAll()

Si la solicitud de permiso de creación para su sitio está redactada de tal modo que un manto de visitante concede o deniega permiso a su sitio para la creación de cookies, utilice approveAll() o denyAll(), en función de su respuesta.

adobe.optIn.denyAll()

Si la solicitud de permiso de creación para su sitio está redactada de tal modo que un manto de visitante concede o deniega permiso a su sitio para la creación de cookies, utilice approveAll() o denyAll(), en función de la respuesta.

Parámetros de los flujos de trabajo de inclusión

Opt-in es compatible con un flujo de trabajo en el que los permisos pueden recabarse a lo largo de más de un ciclo de solicitud, por ejemplo, cuando las preferencias se conceden de una en una. Si utiliza las funciones siguientes y proporciona true como valor de shouldWaitForComplete, su solución puede recabar el consentimiento para una solución o un subconjunto de las categorías totales y, a continuación, recabarlo para la solución o el subconjunto de categorías siguientes. Comenzando por la primera llamada, la propiedad adobe.optIn.status estará pendiente hasta que se realice una llamada a adobe.optIn.complete() al final del flujo. Una vez realizada la llamada, el estado se establecerá en Complete.

adobe.optIn.approve(categories, shouldWaitForComplete)

Función que aprueba o incluye al visitante en todas las categorías de una lista.

adobe.optIn.deny(categories, shouldWaitForComplete)

Función que rechaza o excluye al visitante de todas las categorías especificadas.

adobe.optIn.complete()

Función que activa la agregación de las llamadas precedentes a approve() y deny() en una misma solicitud para establecer las preferencias de un visitante. Al suscribirse a los cambios en Opt-in —(consulte adobe.optIn.fetchPermissions(callback, shouldAutoSubscribe) a continuación—, su devolución de llamada solo se activa cuando se realiza una llamada a esta función.

Parámetros de permisos de Opt-in de visitante

Recabe permisos de Opt-in para un visitante en cualquier momento mediante una de las funciones de permisos:

adobe.optIn.permissions

Un objeto que enumera todas las soluciones de Experience Cloud que, como categorías, el visitante ha concedido o rechazado.

adobe.optIn.isApproved(categories)

Si todas las categorías están aprobadas, esta función devuelve el valor “true”.

adobe.optIn.fetchPermissions(callback, shouldAutoSubscribe)

Recupere la lista de permisos de forma asíncrona. La llamada de retorno se llama con la lista de permisos, una vez que se ha completado el proceso de concesión/denegación de permisos. Si se proporciona el valor true para shouldAutoSubscribe, la devolución de llamada se registra para cualquier cambio que se produzca en adelante en Opt-in. Las siguientes son propiedades de adobe.OptIn:

permissions

Un objeto que enumera todas las soluciones de Experience Cloud que, como categorías, el visitante ha concedido o rechazado. Ejemplo: { aa: true, ecid: false, aam: true... }

status

  • pendiente
  • cambiado
  • completo

doesOptInApply

“true” o “false”, según la configuración que haya proporcionado en la inicialización.

isPending

True o False, dependiendo del valor de estado. La inclusión devuelve True para esta propiedad en relación con un visitante que aún no haya aceptado o rechazado de manera explícita ningún permiso.

isComplete

True o False, dependiendo del valor de estado. La inclusión podría devolver False para esta propiedad cuando se haya iniciado un consentimiento de estilo de flujo de trabajo, pero no se haya completado.