Adobe Experience Platform Web SDK consente di recuperare i segnali di consenso generati dalle piattaforme di gestione del consenso (CMP, Consent Management Platforms) e inviarli a Adobe Experience Platform ogni volta che si verifica un evento di modifica del consenso.
L’SDK non si interfaccia con alcuna CMP preconfigurata. Sta a te determinare come integrare l’SDK nel tuo sito web, ascoltare le modifiche al consenso nella CMP e chiamare il comando appropriato. Questo documento fornisce indicazioni generali su come integrare CMP con Platform Web SDK.
Questa esercitazione presuppone che tu abbia già determinato come generare i dati di consenso all’interno di CMP e che tu abbia creato un set di dati contenente i 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 configurare l'SDK utilizzando l'estensione tag nell'interfaccia utente. Se non desideri utilizzare l'estensione e preferisci incorporare direttamente sul tuo sito la versione autonoma dell'SDK, consulta i seguenti documenti invece di questa guida:
I passaggi di installazione in questa guida richiedono una comprensione efficace delle estensioni dei tag e della loro installazione nelle applicazioni web. Per ulteriori informazioni, consulta la seguente documentazione:
Affinché l’SDK invii dati ad Experience Platform, devi prima configurare un datastream. Nell’interfaccia utente Raccolta dati o Experience Platform, seleziona Datastreams nella navigazione a sinistra.
Dopo aver creato un nuovo datastream o selezionato uno esistente da modificare, seleziona il pulsante di attivazione accanto a Adobe Experience Platform. Quindi, utilizza i valori elencati di seguito per completare il modulo.
Campo Datastream | Valore |
---|---|
Sandbox | Nome della piattaforma sandbox che contiene la connessione streaming e i set di dati richiesti per impostare il datastream. |
Ingresso streaming | Una connessione in streaming valida, ad Experience Platform. Guarda l’esercitazione su creazione di una connessione in streaming se non disponi di un ingresso streaming esistente. |
Set di dati evento | Un XDM ExperienceEvent set di dati che prevedi di inviare dati evento all’SDK. Anche se devi fornire un set di dati evento per creare un archivio dati Platform, tieni presente che i dati di consenso inviati tramite eventi non sono rispettati nei flussi di lavoro di applicazione a valle. |
Set di dati del profilo | La ProfileSet di dati abilitato con i campi di consenso creati dall’utente precedente. |
Al termine, seleziona Salva nella parte inferiore della schermata e continuare a seguire eventuali ulteriori prompt per completare la configurazione.
Dopo aver creato un datastream come descritto nella sezione precedente, devi configurare l’estensione Platform Web SDK che distribuirai in ultima analisi sul sito. Se l'estensione SDK non è installata nella proprietà tag, seleziona Estensioni nella navigazione a sinistra, seguita dalla Catalogo scheda . Quindi, seleziona Installa nell’elenco delle estensioni disponibili, all’interno dell’estensione Platform SDK.
Quando configuri l'SDK, in Configurazioni perimetrali, seleziona il datastream creato nel passaggio precedente.
Seleziona Salva per installare l'estensione .
Con l'estensione SDK installata, puoi creare un elemento dati per rappresentare il valore predefinito di consenso per la raccolta dati (collect.val
) per i tuoi utenti. 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
tag (codice di incorporamento) sulla pagina web, esegui il rendering di un script
che imposta un adobeDefaultConsent
in base all'area geografica dell'utente.adobeDefaultConsent
Variabile 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 invece utilizzare i seguenti passaggi:
adobeDefaultConsent
in base all'area geografica dell'utente, quindi carica lo script della libreria di tag utilizzando JavaScript.adobeDefaultConsent
Variabile 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 Aggiungi elemento dati per passare alla finestra di dialogo di creazione dell’elemento dati.
Da qui, devi creare un Variabile JavaScript elemento dati basato su adobeDefaultConsent
. Al termine, seleziona Salva.
Una volta creato l'elemento dati, torna alla pagina di configurazione dell'estensione SDK per web. Sotto la Privacy sezione , seleziona Fornito dall’elemento dati e utilizza la finestra di dialogo fornita per selezionare l’elemento dati del consenso predefinito creato in precedenza.
Dopo aver configurato l'estensione, questa può essere integrata nel sito web. Fai riferimento a guida alla pubblicazione nella documentazione sui tag per informazioni dettagliate su come distribuire la build della libreria aggiornata.
Dopo aver integrato l’estensione SDK nel sito web, puoi iniziare a utilizzare l’SDK per web di Platform setConsent
per inviare i dati di consenso a Platform.
La setConsent
esegue due azioni:
setConsent
Esistono due scenari in cui setConsent
dovrebbe essere chiamato sul tuo sito:
setConsent
sintassiPer un’introduzione alla sintassi comune per i comandi SDK di Platform, consulta il documento su esecuzione di comandi.
La setConsent
Il comando prevede due argomenti:
"setConsent"
)consent
. La consent
deve contenere almeno un oggetto che fornisca i campi di consenso richiesti per lo standard Adobe.I campi di consenso richiesti per lo standard di Adobe sono mostrati nell’esempio seguente setConsent
chiamata:
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 in uso. Per lo standard Adobe, questo valore deve essere impostato su Adobe . |
version |
Numero di versione dello standard di consenso indicato in standard . Questo valore deve essere impostato su 2.0 per l’elaborazione del consenso standard di Adobe. |
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
(quali IAB TCF
), è possibile aggiungere ulteriori 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 una funzione che gestisce le modifiche delle preferenze di consenso su un sito web, che può essere utilizzata come callback in un listener di eventi o 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
}]
});
});
Tutto Platform SDK i comandi restituiscono promesse che indicano se la chiamata è riuscita o meno. Puoi quindi utilizzare queste risposte per ottenere una logica aggiuntiva, ad esempio per visualizzare messaggi di conferma al cliente. Vedi la sezione su gestione del successo o dell'errore nella guida sull’esecuzione dei comandi SDK per esempi specifici.
Una volta effettuata con successo setConsent
con l’SDK, puoi utilizzare il visualizzatore del profilo nell’interfaccia utente di Platform per verificare se i dati sono di destinazione nell’archivio profili. Vedi la sezione su esplorazione dei profili per identità per ulteriori informazioni.
Seguendo questa guida, hai configurato l’estensione Platform Web SDK per inviare ad Experience Platform i dati di consenso. Per informazioni su come verificare l’implementazione, consulta la documentazione relativa allo standard di consenso che stai implementando: