[Beta]{class="badge informative"}

Didomi

AVAILABILITY
L'origine Didomi è in versione beta. Leggi i termini e condizioni nella panoramica delle origini per ulteriori informazioni sull'utilizzo di origini con etichetta beta.

Didomi è una piattaforma di gestione del consenso e delle preferenze che consente alle organizzazioni di raccogliere, gestire e applicare le scelte degli utenti in merito ai dati personali su siti Web, app e strumenti interni.

Adobe Experience Platform supporta l'acquisizione di dati da un'ampia gamma di sistemi esterni, inclusi l'archiviazione cloud, i database e le applicazioni come Didomi tramite un sistema di connettori di origine. Utilizza le origini per autenticare i sistemi esterni, gestire il flusso di dati in Experience Platform e garantire l’acquisizione coerente e strutturata dei dati dei clienti.

Utilizza l'origine Didomi per inviare in streaming i dati di consenso utente e preferenze in tempo reale dalla piattaforma di gestione delle preferenze e dei consensi di Didomi ad Experience Platform. Tramite l'origine Didomi, puoi centralizzare e agire sui dati del consenso in Experience Platform, mantenendo in tal modo i profili dei clienti e i flussi di lavoro a valle conformi e aggiornati.

Architettura di elaborazione dati Didomi.

Prerequisiti

Completa i passaggi preliminari descritti di seguito per connettere correttamente l'account Didomi ad Experience Platform.

Indirizzo IP inserisco nell'elenco Consentiti

Prima di collegare le origini a Experience Platform, è necessario aggiungere al elenco Consentiti di indirizzi IP specifici per l’area geografica. Per ulteriori informazioni, leggere la guida in inserire nell'elenco Consentiti degli indirizzi IP per la connessione ad Experience Platform.

Configurare le autorizzazioni su Experience Platform

Per connettere l'account ad Experience Platform, è necessario che per l'account siano abilitate le autorizzazioni Visualizza origini e Gestisci originiDidomi. Contatta l’amministratore del prodotto per ottenere le autorizzazioni necessarie. Per ulteriori informazioni, leggere la guida all'interfaccia utente per il controllo degli accessi.

Raccogliere le credenziali API di Adobe

Per connettere in modo sicuro Didomi ad Experience Platform, è necessario eseguire l'autenticazione utilizzando le credenziali API di Adobe. Queste credenziali sono essenziali per la configurazione del webhook e per l’acquisizione dei dati.

Per informazioni su come effettuare correttamente chiamate alle API di Experience Platform, leggi la guida guida introduttiva alle API di Experience Platform.

Creare uno schema Experience Platform

TIP
Puoi saltare questo passaggio se disponi già di uno schema XDM.

Uno schema Experience Data Model (XDM) definisce la struttura dei dati che invierai da Didomi (ad esempio, ID utente, scopo del consenso) ad Experience Platform.

Per creare uno schema, seleziona Schemi nell'area di navigazione a sinistra dell'interfaccia utente di Experience Platform, quindi seleziona Crea schema. Quindi, seleziona Standard come tipo di schema, quindi seleziona Manuale per creare manualmente i campi. Seleziona una classe base per lo schema e fornisci un nome per lo schema.

Dopo la creazione, aggiorna lo schema aggiungendo uno dei campi obbligatori. Assicurati che almeno un campo sia un campo Identità per informare Experience Platform dei valori di identità primari. Infine, assicurati di abilitare l'interruttore Profilo per archiviare correttamente i dati.

create-schema

Per ulteriori informazioni, consulta la guida su creazione di schemi nell'interfaccia utente.

Creare un set di dati

TIP
Puoi saltare questo passaggio se disponi già di un set di dati.

Un set di dati in Experience Platform viene utilizzato per memorizzare i dati in arrivo in base allo schema definito.

Per creare un set di dati, seleziona Set di dati nell'area di navigazione a sinistra dell'interfaccia utente di Experience Platform, quindi seleziona Crea set di dati. Quindi, seleziona Crea set di dati dallo schema, quindi seleziona lo schema da associare al nuovo set di dati.

create-dataset

Configurare il webhook HTTP nella console Didomi

Webhooks ti consente di abbonarti agli eventi attivati sulla piattaforma Didomi quando gli utenti interagiscono con le loro preferenze di consenso. Quando si verifica un evento rilevante, ad esempio quando un utente concede o revoca il consenso, Didomi invia una richiesta HTTP POST in tempo reale contenente un payload JSON all'endpoint webhook configurato.

console-didomi

Per garantire la compatibilità con Experience Platform, il webhook deve soddisfare i seguenti requisiti.

Campo
Descrizione
Esempio
Segreto client
La chiave segreta associata alle credenziali API di Adobe.
d8f3b2e1-4c9a-4a7f-9b2e-8f1c3d2a1b6e
Chiave API
Chiave API pubblica utilizzata per autenticare le richieste ai servizi Adobe.
Tipo di concessione
Metodo tramite il quale un'applicazione ottiene un token di accesso dal server autorizzazioni. Imposta questo valore su client_credentials.
client_credentials
Portata
Gli ambiti di autorizzazione definiscono le autorizzazioni o i livelli di accesso specifici richiesti da un’applicazione al provider API.
openid,AdobeID,read_organizations,additional_info.projectedProductContext,session
Intestazione di autenticazione
Le intestazioni aggiuntive necessarie per la richiesta del token Adobe.
{"Content-type": "application/x-www-form-urlencoded"}
URL token
Endpoint token Adobe.
https://ims-na1.adobelogin.com/ims/token/v3
URL dell’endpoint
URL finale del connettore Adobe (fornito alla fine della configurazione).
https://dcs.adobedc.net/collection/your-adobe-endpoint-id

Quindi, configurare le seguenti opzioni per webhook.

Campo
Descrizione
Valore
Intestazioni richiesta
Intestazioni personalizzate per webhook. Assicurarsi di includere x-adobe-flow-id. Puoi recuperare questo valore dopo la creazione del flusso di dati.
{"Content-Type": "application/json", "Cache-Control": "no-cache", "x-adobe-flow-id": "{DATAFLOW_ID}"}
Appiattisci
Questa proprietà deve essere selezionata in quanto garantisce che i dati webhook vengano inviati come oggetto flat.
Abilitata
Tipi di evento
Selezionare il gruppo specifico di Didomi eventi (event.* o user.*) che deve attivare webhook. Utilizza event.* per tenere traccia delle modifiche di consenso o preferenze e user.* per tenere traccia degli aggiornamenti del profilo utente. Questa selezione è necessaria per garantire che solo gli eventi compatibili vengano inviati ad Adobe. Adobe supporta un solo schema per flusso di dati, pertanto la selezione di entrambi i tipi di evento può causare errori di acquisizione.

L’elenco dei tipi di evento supportati è:

  • Event.created
  • Event.updated
  • Event.deleted
  • User.created
  • User.updated
  • User.deleted

Scarica il file di payload di esempio download-the-sample-payload-file

In base al gruppo di eventi selezionato, scarica il file di payload di esempio appropriato direttamente dalla console Didomi. Questo file rappresenta la struttura dei dati e verrà utilizzato durante i passaggi di schema e mappatura in Adobe.

Gruppo di eventi
File di esempio da scaricare
Opzione filtro
event.*
Scarica un esempio per event.created
Filtra solo per event.* eventi
user.*
Scarica un esempio per user.created
Filtra solo per user.* eventi

Connetti il tuo account Didomi ad Experience Platform

Leggi la guida su connessione Didomi ad Experience Platform per scoprire come creare una connessione di origine e acquisire i dati di consenso e preferenze da Didomi in Experience Platform.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089