Adobe Experience Platform Web SDK consente di recuperare i segnali di consenso del cliente generati dalle piattaforme di gestione del consenso (CMP, Consent Management Platforms) e di inviarli a Adobe Experience Platform ogni volta che si verifica un evento di modifica del consenso.
L’SDK non si interfaccia con alcuna CMP predefinita. Sta a te determinare come integrare l’SDK nel tuo sito web, ascoltare le modifiche del consenso nella CMP e chiamare il comando appropriato. Questo documento fornisce indicazioni generali su come integrare la CMP con Platform Web SDK.
Questa esercitazione presuppone che tu abbia già determinato come generare i dati sul consenso all’interno della tua CMP e che sia stato creato un set di dati contenente campi di consenso conformi allo standard Adobe o allo standard IAB Transparency and Consent Framework (TCF) 2.0. Se non hai ancora creato questo set di dati, consulta le seguenti esercitazioni prima di tornare a questa guida:
Questa guida segue il flusso di lavoro per la configurazione dell’SDK utilizzando l’estensione tag nell’interfaccia utente. Se non desideri utilizzare l'estensione e preferisci incorporare direttamente la versione autonoma dell'SDK sul tuo sito, consulta i seguenti documenti invece di questa guida:
I passaggi di installazione descritti in questa guida richiedono una buona conoscenza delle estensioni tag e del modo in cui vengono installate nelle applicazioni web. Per ulteriori informazioni, consulta la seguente documentazione:
Affinché l’SDK possa inviare dati ad Experience Platform, devi prima configurare uno stream di dati. Nell’interfaccia di Data Collection o nell’interfaccia di Experience Platform, seleziona Flussi di dati nel menu di navigazione a sinistra.
Dopo aver creato un nuovo stream di dati o averne selezionato uno esistente da modificare, seleziona il pulsante di attivazione/disattivazione accanto a Adobe Experience Platform. Quindi, utilizzare i valori elencati di seguito per completare il modulo.
Campo stream di dati | Valore |
---|---|
Sandbox | Nome della piattaforma sandbox che contiene la connessione in streaming e i set di dati necessari per impostare lo stream di dati. |
Set di dati evento | Un XDM ExperienceEvent set di dati pianificato per l’invio di dati evento a utilizzando l’SDK. Anche se devi fornire un set di dati evento per creare un flusso di dati di Platform, tieni presente che i dati del consenso inviati tramite eventi non vengono rispettati nei flussi di lavoro di applicazione a valle. |
Set di dati profilo | Il ProfileSet di dati abilitato con campi di consenso cliente creati dall’utente precedente. |
Al termine, seleziona Salva nella parte inferiore della schermata e continuare a seguire eventuali altre richieste per completare la configurazione.
Dopo aver creato un flusso di dati come descritto nella sezione precedente, devi configurare l’estensione Platform Web SDK che infine distribuirai sul sito. Se nella proprietà del tag non è installata l’estensione SDK, seleziona Estensioni nel menu di navigazione a sinistra, seguito da Catalogo scheda. Quindi, seleziona Installa nell’estensione Platform SDK all’interno dell’elenco delle estensioni disponibili.
Durante la configurazione dell’SDK, in Configurazioni Edge, seleziona lo stream di dati creato nel passaggio precedente.
Seleziona Salva per installare l’estensione.
Con l’estensione SDK installata, puoi creare un elemento dati che rappresenti il valore di consenso predefinito per la raccolta dati (collect.val
) per i tuoi utenti. Questa funzione può essere utile se desideri avere valori predefiniti diversi a seconda dell’utente, ad esempio pending
per gli utenti dell'Unione europea e in
per gli utenti nordamericani.
In questo caso d’uso, puoi implementare quanto segue per impostare il consenso predefinito in base all’area geografica dell’utente:
script
(codice di incorporamento) nella pagina web, esegui il rendering di un script
tag che imposta un adobeDefaultConsent
in base all’area geografica dell’utente.adobeDefaultConsent
JavaScript e utilizza questo elemento dati come valore di consenso predefinito per l’utente.Se l’area geografica dell’utente è determinata da una CMP, puoi utilizzare i seguenti passaggi:
adobeDefaultConsent
in base all’area geografica dell’utente, quindi carica lo script della libreria di tag utilizzando JavaScript.adobeDefaultConsent
JavaScript e utilizza questo elemento dati come valore di consenso predefinito per l’utente.Per creare un elemento dati nell’interfaccia utente, seleziona Elementi dati nel menu di navigazione a sinistra, seleziona quindi Aggiungi elemento dati per passare alla finestra di dialogo di creazione dell’elemento dati.
Da qui, devi creare una Variabile JavaScript elemento dati basato su adobeDefaultConsent
. Al termine, seleziona Salva.
Una volta creato l’elemento dati, torna alla pagina di configurazione dell’estensione Web SDK. Sotto Privacy sezione, seleziona Fornito dall’elemento dati, e utilizza la finestra di dialogo fornita per selezionare l’elemento dati di consenso predefinito creato in precedenza.
Una volta completata la configurazione dell'estensione, puoi integrarla nel sito web. Consulta la sezione guida alla pubblicazione nella documentazione sui tag, trovi informazioni dettagliate su come distribuire la build della libreria aggiornata.
Dopo aver integrato l’estensione SDK nel sito web, puoi iniziare a utilizzare Platform Web SDK setConsent
comando per inviare i dati del consenso a Platform.
Il setConsent
Il comando esegue due azioni:
setConsent
Esistono due scenari in cui setConsent
deve essere chiamato sul sito:
setConsent
sintassiPer un’introduzione alla sintassi comune per i comandi SDK di Platform, consulta il documento su esecuzione di comandi.
Il setConsent
Il comando prevede due argomenti:
"setConsent"
)consent
. Il consent
l’array deve contenere almeno un oggetto che fornisca i campi di consenso richiesti per lo standard Adobe.I campi di consenso richiesti per lo standard Adobe sono mostrati nell’esempio seguente setConsent
chiama:
alloy("setConsent", {
consent: [{
standard: "Adobe",
version: "2.0",
value: {
collect: {
val: "y"
},
share: {
val: "y"
},
personalize: {
content: {
val: "y"
}
},
metadata: {
time: "2020-10-12T15:52:25+00:00"
}
}
}]
});
Payload, proprietà | Descrizione |
---|---|
standard |
Lo standard di consenso utilizzato. Per lo standard Adobe, questo valore deve essere impostato su Adobe . |
version |
Il numero di versione dello standard di consenso indicato in standard . Questo valore deve essere impostato su 2.0 ad Adobe l’elaborazione del consenso standard. |
value |
Le informazioni di consenso aggiornate del cliente, fornite come oggetto XDM conforme alla struttura dei campi di consenso del set di dati abilitati per il profilo. |
Se utilizzi altri standard di consenso in combinazione con Adobe
(ad esempio IAB TCF
), è possibile aggiungere altri oggetti al consent
per ogni standard. Ogni oggetto deve contenere valori appropriati per standard
, version
, e value
per lo standard di consenso che rappresentano.
Il seguente JavaScript fornisce un esempio di funzione che gestisce le modifiche delle preferenze di consenso su un sito web, che può essere utilizzato come callback in un listener di eventi o in un hook CMP:
var setConsent = function () {
// Retrieve the current consent data.
var categories = getConsentData();
// If the script is running on a consent change, generate a new timestamp.
// If the script is running on page load, set the timestamp to when the consent values last changed.
var now = new Date();
var collectedAt = consentChanged ? now.toISOString() : categories.collectedAt;
// Map the consent values and timestamp to XDM
var consentXDM = {
collect: {
val: categories.collect !== -1 ? "y" : "n"
},
personalize: {
content: {
val: categories.personalizeContent !== -1 ? "y" : "n"
}
},
share: {
val: categories.share !== -1 ? "y" : "n"
},
metadata: {
time: collectedAt
}
};
// Pass the XDM object to the Platform Web SDK
alloy("setConsent", {
consent: [{
standard: "Adobe",
version: "2.0",
value: consentXDM
}]
});
});
Tutti Platform SDK i comandi restituiscono promesse che indicano se la chiamata è riuscita o meno. Puoi quindi utilizzare queste risposte per una logica aggiuntiva, ad esempio per visualizzare i messaggi di conferma al cliente. Consulta la sezione su gestione di operazioni riuscite o non riuscite nella guida all’esecuzione dei comandi SDK per esempi specifici.
Dopo aver completato correttamente setConsent
chiamate con l’SDK, puoi utilizzare il visualizzatore di profili nell’interfaccia utente di Platform per verificare se i dati vengono inviati nell’archivio profili. Consulta la sezione su esplorazione dei profili per identità per ulteriori informazioni.
Seguendo questa guida, hai configurato l’estensione Platform Web SDK per inviare i dati sul consenso ad Experience Platform. Per informazioni su come testare l’implementazione, consulta la documentazione dello standard di consenso che stai implementando: