Configuración del servicio de inclusión (Opt-in)

Implemente el servicio de inclusión (Opt-in) como el único punto de referencia que utilizan las soluciones de Experience Cloud (denominadas “categorías” en Opt-in) para determinar si se crean o no cookies en el dispositivo de un visitante.

El servicio de inclusión (Opt-in) es una biblioteca JavaScript incluida con Experience Cloud ID (ECID) y se encuentra en el Visitor JS del objeto global de adobe como el objeto adobe.optIn. El servicio de inclusión (Opt-in) instalado le permite especificar si un visitante puede incluirse en las soluciones de Adobe de una sola vez, o si se le van presentando las soluciones una tras otra para que vaya aprobando los permisos. La función de gestión del consentimiento del servicio de inclusión (Opt-in) le permite implementar distintas configuraciones, según sus requisitos específicos de privacidad.

El servicio Opt-in le permite especificar si un visitante puede incluirse en las soluciones de Adobe de una sola vez, o si se le van presentando las soluciones una tras otra para que vaya aprobando los permisos. Una vez que el cliente completa y registra el proceso de aprobación, todas las soluciones de Adobe pueden recuperar las aprobaciones de visitante de CMP para responder con llamadas de consentimiento relacionadas.

Requisitos previos

  1. ECID versión 4.0.

    Descargue la versión más reciente de ECID.

  2. Bibliotecas de soporte:

    • ECID 4.0 o posterior
    • AppMeasurement 2.11 o posterior
    • DIL 9.0
    • AT.js versión 1.7.0
    • Extensión AT.js para Launch versión 9.0
    • Para Analytics, AppMeasurement 2.11 con la extensión 1.6
    • Para Target, la extensión 0.9.1
  3. Conozca en profundidad el marco de gestión del consentimiento que va a utilizar con Opt-in y entienda cualquier requisito previo adicional.

  4. Los requisitos de privacidad de su empresa dependerán de cómo elija satisfacer el cumplimiento del RGPD. Debe saber qué bibliotecas pueden utilizar los equipos de privacidad de su empresa previamente al consentimiento.

Si utiliza Launch, de Adobe, aproveche la Opt-in extension to configure Opt-in service.

Categorías de Opt-in

Las preferencias de Opt-in de un visitante dependen de la solución de Adobe Experience Cloud, representándose cada solución mediante una categoría. Las categorías las proporciona el adobe.OptInCategories objeto, donde, por ejemplo, el componente ECID es referido como adobe.OptInCategories. ECID. La siguiente es la definición de adobe.OptInCategories:

La configuración de Opt-in se mantiene por categoría, estando cada solución de Experience Cloud representada por una categoría:

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

El servicio Opt-in le permite establecer las preferencias de permiso de los visitantes para cada solución de Adobe que se emplee en el sitio. Incluye una biblioteca para guardar la configuración de un visitante para cada categoría aprobada y admite un flujo secuencial, por el que el proceso de aprobación recibe una a una las preferencias de “confirmación” o “rechazo” para cada categoría. Puede establecer soluciones/categorías para realizar la inclusión en bloque o para cada una de las soluciones.
Las bibliotecas del lado del cliente de todas las soluciones de Adobe dependen del servicio Opt-in y no generarán cookies salvo que la solución haya obtenido permiso. Opt-in ofrece diversos enfoques para proporcionar y actualizar la configuración de consentimiento del visitante actual. Esta sección incluye ejemplos de cómo se establecen las preferencias del servicio Opt-in. Consulte la Referencia de la API Opt-in para obtener una lista completa de funciones y parámetros.

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

Ejemplo de configuración de Opt-in en la inicialización delVisitorobjeto global

// FORMAT: Object<adobe.OptInCategories enum: boolean> 
var preOptInApprovalsConfig = {}; 
preOptInApprovals[adobe.OptInCategories.ANALYTICS] = true; 
  
// FORMAT: Object<adobe.OptInCategories enum: boolean> 
// If you are storing the OptIn permissions on your side (in a cookie you manage or in a CMP), 
// you have to provide those permissions through the previousPermissions config. 
// previousPermissions will overwrite preOptInApprovals. 
var previousPermissionsConfig = {}; 
previousPermissionsConfig[adobe.OptInCategories.AAM] = true; 
previousPermissionsConfig[adobe.OptInCategories.ANALYTICS] = false; 
  
Visitor.getInstance("YOUR_ORG_ID", { 
    "doesOptInApply": true, // NOTE: This can be a function that evaluates to true or false. 
    "preOptInApprovals": preOptInApprovalsConfig, 
    "previousPermissions": previousPermissionsConfig, 
    "isOptInStorageEnabled": true 
});

Gestión de cambios en el consentimiento

En cualquier momento durante su 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 su configuración inicial, es posible cambiar los permisos del visitante. Consulte Cambios en el consentimiento para ver una lista de funciones de gestión del consentimiento.

Flujos de trabajo de Opt-in

El servicio 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 y en el que 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á en estado pending 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(['AAM', 'ECID'], true); 
adobe.optIn.deny(['ANALYTICS'], true); 
adobe.optIn.complete();

Consulte Establecer una configuración del flujo de trabajo

Inspeccione los permisos de Opt-in del visitante

A medida que los visitantes realicen cambios en sus permisos, necesitará conocer los permisos resultantes para sincronizar el almacén de consentimiento con los cambios realizados en el servicio Opt-in. Inspeccione las preferencias del visitante mediante las funciones de permisos, como por ejemplo:

fetchPermissions sample

optIn.fetchPermissions(function (permissions) { 
    // Here you can check if your category has been approved or not. 
    // We recommend using optIn.isApproved() to check for permissions because it abstracts out the details of knowing exactly how the permissions list looks like. 
    if (adobe.optIn.isApproved(MY_CATEGORY) { 
        sendBeacon(); // Or something 
    } 
});

OR: You can pass in shouldAutoSubscribe as true, your callback will be used to subscribe to all OptIn events going forward:

function callback() { 
    if (adobe.optIn.isApproved(MY_CATEGORY) { 
        sendBeacon(); // Or something 
    } 
}

optIn.fetchPermissions(callback, true);

Consulte la documentación de la API para obtener más información sobre estas funciones, propiedades y configuraciones mencionadas en este documento.

Conservar las preferencias de los visitantes

El servicio Opt-in incluye una opción de almacenamiento de las preferencias de consentimiento adecuada para un entorno de desarrollo, o uno en el que no sea factible el uso de un CRM. Si la propiedad de configuración isOptInStorageEnabled se establece en true, el servicio Opt-in se activa para crear una cookie en el sistema del visitante dentro de su dominio.

El adobe.optInobjeto carece de estado y no proporciona ningún mecanismo de almacenamiento. Está pensado para permitirle gestionar la configuración de consentimiento de Adobe en su plataforma de gestión del consentimiento (CMP) existente, si es que esta permite el almacenamiento de datos personalizados. También puede almacenar las preferencias de visitante en una cookie en el navegador del visitante. Tiene dos opciones para proporcionar las preferencias del usuario al servicio Opt-in:

  • Si su solución de persistencia del consentimiento, ya sea una CMP o una cookie en el navegador del visitante, permite la oportuna recuperación de las preferencias de visitante, puede proporcionárselas al servicio Opt-in durante la inicialización del visitante.
  • Sin embargo, si la recuperación puede ser un proceso prolongado o por cualquier otro motivo conviene realizarla como proceso asincrónico, puede utilizar la approve() función del servicio para proporcionar estos ajustes una vez cargados correctamente.

En esta página