Configurare un set di dati per acquisire dati di consenso e preferenza

Affinché Adobe Experience Platform possa elaborare i dati di consenso o preferenza dei clienti, questi devono essere inviati a un set di dati il cui schema contiene campi relativi ai consensi e ad altre autorizzazioni. In particolare, questo set di dati deve essere basato sulla classe XDM Individual Profile e deve essere abilitato per l'utilizzo in Real-time Customer Profile.

Questo documento fornisce passaggi per la configurazione di un set di dati per elaborare i dati di consenso in Experience Platform. Per una panoramica dell’intero flusso di lavoro per l’elaborazione dei dati di consenso/preferenza in Platform, consulta la panoramica sull’elaborazione del consenso.

IMPORTANTE

Gli esempi in questa guida utilizzano un set standardizzato di campi per rappresentare i valori del consenso del cliente, come definito dal gruppo di campi Consent and Preference Details schema . La struttura di questi campi è intesa a fornire un modello di dati efficiente che copra molti casi d’uso comuni per la raccolta del consenso.

Tuttavia, puoi anche definire gruppi di campi personalizzati per rappresentare il consenso in base ai tuoi modelli di dati. Consulta il tuo team legale per ottenere l’approvazione per un modello di dati di consenso adatto alle tue esigenze aziendali, in base alle seguenti opzioni:

  • Gruppo di campi di consenso standardizzato
  • Un gruppo di campi di consenso personalizzato creato dalla tua organizzazione
  • Combinazione del gruppo di campi di consenso standardizzato e dei campi aggiuntivi forniti da un gruppo di campi di consenso personalizzato

Prerequisiti

Questa esercitazione richiede una buona comprensione dei seguenti componenti di Adobe Experience Platform:

  • Experience Data Model (XDM): Il framework standardizzato in base al quale Experience Platform vengono organizzati i dati sulla customer experience.
  • Profilo cliente in tempo reale: Consolida i dati dei clienti provenienti da fonti diverse in una visualizzazione completa e unificata, offrendo al tempo stesso un account utilizzabile e con marca temporale per ogni interazione con il cliente.
IMPORTANTE

Questa esercitazione presuppone che tu conosca lo schema Profile in Platform che desideri utilizzare per acquisire le informazioni sugli attributi del cliente. Indipendentemente dal metodo utilizzato per raccogliere i dati di consenso, questo schema deve essere abilitato per Profilo cliente in tempo reale. Inoltre, l'identità principale dello schema non può essere un campo direttamente identificabile che non è consentito utilizzare nella pubblicità basata sugli interessi, ad esempio un indirizzo e-mail. Consulta il tuo consulente legale se non sei sicuro di quali campi siano soggetti a restrizioni.

Struttura del gruppo di dettagli del consenso e della preferenza

Il gruppo di campi Dettagli consenso e preferenza fornisce campi di consenso standardizzati a uno schema. Attualmente, questo gruppo di campi è compatibile solo con schemi basati sulla classe XDM Individual Profile .

Il gruppo di campi fornisce un singolo campo di tipo oggetto, consents, le cui sottoproprietà acquisiscono un set di campi di consenso standardizzati. Il seguente JSON è un esempio del tipo di dati che consents prevede durante l’inserimento dei dati:

{
  "consents": {
    "collect": {
      "val": "y",
    },
    "share": {
      "val": "y",
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "y"
      },
      "push": {
        "val": "n",
        "reason": "Too Frequent",
        "time": "2019-01-01T15:52:25+00:00"
      }
    },
    "idSpecific": {
      "email": {
        "jdoe@example.com": {
          "marketing": {
            "email": {
              "val": "n"
            }
          }
        }
      }
    }
  },
  "metadata": {
    "time": "2019-01-01T15:52:25+00:00"
  }
}
NOTA

Per ulteriori informazioni sulla struttura e il significato delle sottoproprietà in consents, consulta la panoramica sul gruppo di campi Consent and Preference Details .

Aggiungi i gruppi di campi richiesti allo schema Profile

Per raccogliere i dati di consenso utilizzando lo standard Adobe, è necessario disporre di uno schema abilitato per il profilo che contenga i due gruppi di campi seguenti:

  • Dettagli su consenso e preferenza
  • IdentityMap (obbligatorio se si utilizza l’SDK per web o mobile della piattaforma per inviare i segnali di consenso)

Nell’interfaccia utente di Platform, seleziona Schemi nel menu di navigazione a sinistra, quindi seleziona la scheda Sfoglia per visualizzare un elenco degli schemi esistenti. Da qui, seleziona il nome dello schema abilitato Profile a cui desideri aggiungere i campi di consenso. Le schermate di questa sezione utilizzano lo schema "Membri fedeltà" generato nell' esercitazione sulla creazione dello schema come esempio.

SUGGERIMENTO

È possibile utilizzare le funzionalità di ricerca e filtro dell'area di lavoro per semplificare lo schema. Per ulteriori informazioni, consulta la guida sull’ esplorazione delle risorse XDM .

Viene visualizzata la sezione Schema Editor che mostra la struttura dello schema nell’area di lavoro. Sul lato sinistro dell'area di lavoro, seleziona Aggiungi nella sezione Gruppi di campi .

Viene visualizzata la finestra di dialogo Aggiungi gruppo di campi . Da qui, seleziona Dettagli consenso e preferenza dall'elenco. Facoltativamente, puoi utilizzare la barra di ricerca per limitare i risultati per individuare più facilmente il gruppo di campi.

Quindi, trova il gruppo di campi IdentityMap dall’elenco e selezionalo anch’esso. Una volta elencati entrambi i gruppi di campi nella barra a destra, seleziona Aggiungi gruppi di campi.

L’area di lavoro viene visualizzata nuovamente, mostrando che i campi consents e identityMap sono stati aggiunti alla struttura dello schema. Se hai bisogno di campi di consenso e preferenza aggiuntivi non acquisiti dal gruppo di campi standard, consulta la sezione dell’appendice su aggiunta di campi di consenso e preferenza personalizzati allo schema. In caso contrario, selezionare Salva per finalizzare le modifiche allo schema.

IMPORTANTE

Se si sta creando un nuovo schema o si sta modificando uno schema esistente che non è stato abilitato per Profilo, è necessario abilitare lo schema per Profilo prima di salvare.

Se lo schema modificato viene utilizzato dal set di dati profilo specificato nel datastream SDK per web di Platform, tale set di dati includerà ora i nuovi campi di consenso. Ora puoi tornare alla guida all'elaborazione del consenso per continuare il processo di configurazione di Experience Platform per l'elaborazione dei dati di consenso. Se non hai creato un set di dati per questo schema, segui i passaggi della sezione successiva.

Creare un set di dati basato sullo schema di consenso

Dopo aver creato uno schema con i campi di consenso, devi creare un set di dati che in ultima analisi acquisirà i dati di consenso dei clienti. Questo set di dati deve essere abilitato per Real-time Customer Profile.

Per iniziare, seleziona Set di dati nel menu di navigazione di sinistra, quindi seleziona Crea set di dati nell'angolo in alto a destra.

Nella pagina successiva, seleziona Crea set di dati da schema.

Viene visualizzato il flusso di lavoro Crea set di dati da schema , a partire dal passaggio Seleziona schema . Nell’elenco fornito, individua uno degli schemi di consenso creati in precedenza. Facoltativamente, puoi utilizzare la barra di ricerca per limitare i risultati e individuare più facilmente lo schema. Seleziona il pulsante di scelta accanto allo schema desiderato, quindi seleziona Avanti per continuare.

Viene visualizzato il passaggio Configura set di dati . Fornisci un nome e una descrizione univoci e facilmente identificabili per il set di dati prima di selezionare Fine.

Viene visualizzata la pagina dei dettagli per il set di dati appena creato. Se il set di dati è basato sullo schema delle serie temporali, il processo è completo. Se il set di dati è basato sullo schema dei record, il passaggio finale del processo consiste nell’abilitare il set di dati per l’utilizzo in Real-time Customer Profile.

Nella barra a destra, seleziona l’opzione Profilo .

Infine, seleziona Abilita nel puntatore di conferma per abilitare lo schema per Profile.

Il set di dati viene ora salvato e abilitato per l’utilizzo in Profile. Se prevedi di utilizzare Platform Web SDK per inviare i dati di consenso a Profilo, devi selezionare questo set di dati come Set di dati profilo durante la configurazione del datastream.

Passaggi successivi

Seguendo questa esercitazione, hai aggiunto i campi di consenso a uno schema abilitato per Profile , il cui set di dati verrà utilizzato per acquisire i dati di consenso tramite Platform Web SDK o per l’acquisizione diretta XDM.

Ora puoi tornare alla panoramica sull'elaborazione del consenso per continuare la configurazione di Experience Platform per elaborare i dati di consenso.

Appendice

La sezione seguente contiene informazioni aggiuntive sulla creazione di un set di dati per acquisire i dati di consenso e preferenza dei clienti.

Se devi acquisire segnali di consenso aggiuntivi al di fuori di quelli rappresentati dal gruppo di campi Consent and Preference Details standard, puoi utilizzare componenti XDM personalizzati per migliorare lo schema di consenso in base alle tue esigenze aziendali specifiche. Questa sezione descrive i principi di base su come personalizzare lo schema del consenso per acquisire questi segnali in Profilo.

IMPORTANTE

Gli SDK per web e dispositivi mobili di Platform non supportano campi personalizzati nei loro comandi di modifica del consenso. Al momento l’unico modo per acquisire i campi di consenso personalizzati in Profilo è tramite l’acquisizione batch o una connessione sorgente.

Si consiglia vivamente di utilizzare il gruppo di campi Dettagli consenso e preferenza come base di riferimento per la struttura dei dati di consenso e di aggiungere campi aggiuntivi in base alle esigenze, anziché tentare di creare da zero l’intera struttura.

Per aggiungere campi personalizzati alla struttura di un gruppo di campi standard, è innanzitutto necessario creare un gruppo di campi personalizzato. Dopo aver aggiunto il gruppo di campi Dettagli consenso e preferenza allo schema, seleziona l'icona più (+) nella sezione Gruppi di campi, quindi seleziona Crea nuovo gruppo di campi. Immetti un nome e una descrizione facoltativa per il gruppo di campi, quindi seleziona Aggiungi gruppo di campi.

Il Schema Editor viene visualizzato nuovamente con il nuovo gruppo di campi personalizzati selezionato nella barra a sinistra. Nell’area di lavoro vengono visualizzati controlli che consentono di aggiungere campi personalizzati alla struttura dello schema. Per aggiungere un nuovo campo di consenso o preferenza, seleziona l’icona più (+) accanto all’oggetto consents.

All'interno dell'oggetto consents viene visualizzato un nuovo campo. Poiché si aggiunge un campo personalizzato a un oggetto XDM standard, il nuovo campo viene creato sotto un oggetto con namespace nell’ID tenant.

Nella barra a destra sotto Proprietà campo, fornisci un nome e una descrizione per il campo. Quando selezioni il Tipo del campo, devi utilizzare il tipo di dati standard appropriato per un consenso o un campo preferenza personalizzato:

Al termine, selezionare Applica.

Il campo di consenso o preferenza viene aggiunto alla struttura dello schema. Tieni presente che il Percorso visualizzato nella barra a destra contiene lo spazio dei nomi _tenantId . Questo spazio dei nomi deve essere incluso ogni volta che si fa riferimento al percorso di questo campo nelle operazioni sui dati.

Per continuare ad aggiungere i campi di consenso e preferenza richiesti, procedi come indicato sopra. Al termine, seleziona Salva per confermare le modifiche.

Se non hai creato un set di dati per questo schema, continua alla sezione relativa alla creazione di un set di dati.

In questa pagina