Configurazione del servizio Opt-in

Implementare il servizio Opt-in come unico punto di riferimento usato dalle soluzioni Experience Cloud (definite anche Categorie in Opt-in) per definire se è necessario creare cookie sul dispositivo di un visitatore.

Il servizio Opt-in è una libreria JavaScript abbinata con Experience Cloud ID (ECID) ed esiste in JS per il visitatore nell'oggetto globale adobe come oggettoadobe.optIn. Il servizio Opt-in installato consente di specificare se un visitatore può dare il consenso esplicito a tutte le soluzioni Adobe in una sola volta oppure deve darlo per ogni soluzione seguendo la sequenza di autorizzazioni per ognuna di esse. La funzionalità di gestione del consenso del servizio Opt-in consente di implementare diverse configurazioni per i requisiti di privacy specifici.

Il servizio Opt-in consente di specificare se un visitatore può dare il consenso esplicito a tutte le soluzioni Adobe in una sola volta oppure deve darlo per ogni soluzione seguendo la sequenza di autorizzazioni per ognuna di esse. Quando il processo di approvazione è stato completato e registrato dal cliente, è possibile recuperare le approvazioni del visitatore CMP da tutte le soluzioni Adobe per rispondere con le relative chiamate di consenso.

Prerequisiti

  1. ECID versione 4.0

    Scarica la versione più recente di ECID.

  2. Librerie di supporto:

    • ECID 4.0 o successivo
    • AppMeasurement 2.11 o versione successiva
    • DIL 9.0
    • AT.js versione 1.7.0
    • AT.js Lancio versione 9.0
    • Per Analytics, App Measurement 2.11 con estensione 1.6
    • Per Target, estensione 0.9.1
  3. Acquisisci una buona conoscenza del framework di gestione del consenso che utilizzerai con il consenso e comprendi tutti i prerequisiti aggiuntivi.

  4. I requisiti di privacy dell'azienda saranno specifici in base alla scelta di rispettare il RGPD. Ricorda quali librerie possono essere utilizzate dai tuoi team aziendali per la privacy in uno stato di consenso preliminare.

If using Adobe Launch, take advantage of the Opt-in extension to configure Opt-in service.

Categorie di Opt-in

Le preferenze Opt-in di un visitatore sono relative a una soluzione Adobe Experience Cloud, dove ogni soluzione è rappresentata come una categoria. Le categorie vengono fornite adobe.OptInCategories dall'oggetto dove, ad esempio, il componente ECID viene indicato come adobe.OptInCategories. ECID. Di seguito la definizione di adobe.OptInCategories:

Le impostazioni di Opt-in vengono mantenute per ciascuna categoria, dove ogni soluzione Experience Cloud è rappresentata da una categoria:

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

Il servizio Opt-in consente di impostare le preferenze di autorizzazione dei visitatori per ciascuna soluzione Adobe sul tuo sito. Include una libreria per salvare le impostazioni del visitatore mediante una categoria approvata e supporta un flusso sequenziale dove il processo di approvazione riceve le preferenze di "conferma" o "rifiuto" una alla volta per ogni categoria. Puoi impostare il consenso di tutte le soluzioni/categorie insieme oppure per ogni singola soluzione.
Tutte le librerie lato client delle soluzioni Adobe dipendono dal servizio Opt-in e non genereranno cookie a meno che non sia stata concessa l'autorizzazione alla soluzione. L'oggetto Opt-in supporta diversi approcci per fornire e aggiornare le impostazioni di consenso per il visitatore attuale. Questa sezione contiene degli esempi su come impostare le preferenze del servizio Opt-in. Consulta i riferimenti alle API di Opt-in per un elenco completo delle funzioni e dei parametri.

Le configurazioni del servizio Opt-in vengono fornite nella getInstance() funzione di JS per il visitatore che creano l'istanza per adobe l'oggetto globale. Di seguito un elenco delle impostazioni di configurazione di JS per il visitatore per il servizio Opt-in.

Configurazione di esempio di Opt-in nell'inizializzazione dell'Visitoroggetto globale

// 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 
});

Gestione delle modifiche al consenso

Mentre visita il sito, il visitatore può scegliere di impostare le preferenze per la prima volta o modificarle usando CMP in qualsiasi momento. Dopo aver inizializzato JS per il visitatore con le impostazioni iniziali, è possibile modificare le autorizzazioni del visitatore. Consulta Modifiche di consenso per un elenco delle funzioni per la gestione del consenso.

Flussi di lavoro di Opt-in

Il servizio Opt-in supporta un flusso di lavoro in cui è possibile raccogliere le autorizzazioni per più di un ciclo di richiesta e le preferenze vengono assegnate tutte insieme. Usando le seguenti funzioni e specificando true per shouldWaitForComplete, la soluzione è in grado di raccogliere il consenso per una categoria o un sottoinsieme di tutte le categorie e poi di raccoglierlo per la categoria o il sottoinsieme di categoria successivo. A partire dalla prima chiamata, la proprietà adobe.optIn.status sarà in sospeso fino a quando adobe.optIn.complete() non viene chiamata alla fine del flusso. Una volta effettuata la chiamata, lo stato viene impostato su complete.

adobe.optIn.approve(['AAM', 'ECID'], true); 
adobe.optIn.deny(['ANALYTICS'], true); 
adobe.optIn.complete();

Consulta le impostazioni di configurazione del flusso di lavoro.

Controllare le autorizzazioni Opt-in del visitatore

Man mano che i visitatori modificano le proprie autorizzazioni, avrai bisogno di maggiori informazioni sulle autorizzazioni risultanti per sincronizzare l'archivio dei consensi con le modifiche apportate nel servizio Opt-in. le preferenze del visitatore utilizzando le funzioni di autorizzazione, ad esempio:

esempio di fetchPermissions

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);

See API documentation for more details on these and any functions, properties, or configurations mentioned in this document.

Memorizzazione delle preferenze del visitatore

Il servizio Opt-in consente di memorizzare le preferenze di consenso adatte a un ambiente di sviluppo o a un ambiente in cui non è possibile usare un CRM. Imposta la proprietà di configurazione isOptInStorageEnabled su true per attivare il servizio Opt-in e creare un cookie sul sistema del visitatore nel tuo dominio.

adobe.optIn L'oggetto è senza stato e non fornisce alcun meccanismo di archiviazione. Ti consente invece di gestire le impostazioni di consenso di Adobe nella Piattaforma di gestione dei consensi (Consent Management Platform, CMP) se questa permette di memorizzare dati personalizzati. In alternativa è possibile memorizzare le preferenze del visitatore in un cookie sul browser del visitatore. Puoi fornire le preferenze dell'utente al servizio Opt-in in due modi:

  • Se la soluzione di persistenza del consenso, che si tratti di CMP o di un cookie sul browser del visitatore, consente un recupero tempestivo delle preferenze del visitatore, è possibile fornirle al servizio Opt-in durante l'inizializzazione di Visitatore.
  • Tuttavia, se il recupero è un processo lungo o in alternativa viene eseguito meglio come processo asincrono, puoi usare la approve() funzione del servizio per fornire tali impostazioni una volta caricate correttamente.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now