Configurare un set di dati per acquisire dati su consenso e preferenze

Affinché Adobe Experience Platform possa elaborare i dati di consenso/preferenza del cliente, 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 abilitato per l'utilizzo in Real-Time Customer Profile.

Questo documento descrive i passaggi per configurare un set di dati per elaborare i dati sul consenso in Experience Platform. Per una panoramica del flusso di lavoro completo per l'elaborazione dei dati di consenso/preferenza in Platform, consulta la panoramica sull'elaborazione del consenso.

IMPORTANT
Gli esempi in questa guida utilizzano un set di campi standardizzati per rappresentare i valori del consenso del cliente, come definito dal gruppo di campi dello schema Dettagli sul consenso e sulle preferenze. La struttura di questi campi è volta a fornire un modello di dati efficiente per coprire molti casi d’uso comuni di raccolta del consenso.
Tuttavia, puoi anche definire gruppi di campi personalizzati per rappresentare il consenso in base ai tuoi modelli di dati. Consulta il team legale per ottenere l’approvazione per un modello di dati sul consenso adatto alle tue esigenze aziendali, in base alle seguenti opzioni:
  • Il gruppo di campi del consenso standardizzato
  • Un gruppo di campi di consenso personalizzato creato dalla tua organizzazione
  • Una combinazione del gruppo di campi di consenso standardizzato e dei campi aggiuntivi forniti da un gruppo di campi di consenso personalizzato

Prerequisiti

Questo tutorial richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:

IMPORTANT
Questo tutorial 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 sul consenso, questo schema deve essere abilitato per Real-Time Customer Profile. Inoltre, l’identità primaria dello schema non può essere un campo direttamente identificabile di cui non è consentito l’utilizzo in pubblicità basata su interessi, ad esempio un indirizzo e-mail. Se non sei sicuro di quali campi sono soggetti a restrizioni, rivolgiti al tuo consulente legale.

Dettagli sul consenso e sulle preferenze struttura del gruppo di campi structure

Il gruppo di campi Dettagli consenso e preferenze 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 codice JSON è un esempio del tipo di dati previsto da consents al momento dell'acquisizione 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"
  }
}
NOTE
Per ulteriori informazioni sulla struttura e sul significato delle sottoproprietà in consents, vedere la panoramica sul gruppo di campi Dettagli sul consenso e sulle preferenze.

Aggiungi i gruppi di campi richiesti allo schema Profile add-field-group

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

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

TIP
Puoi utilizzare le funzionalità di ricerca e filtro dell’area di lavoro per trovare più facilmente lo schema. Per ulteriori informazioni, consulta la guida sull'esplorazione delle risorse XDM.

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

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

Individuare quindi il gruppo di campi IdentityMap dall'elenco e selezionarlo. Dopo aver elencato entrambi i gruppi di campi nella barra a destra, seleziona Aggiungi gruppi di campi.

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

IMPORTANT
Se si crea un nuovo schema o si modifica uno schema esistente non abilitato per il profilo, è necessario abilitare lo schema per il profilo prima di salvare.

Se lo schema modificato è utilizzato dal set di dati profilo specificato nel flusso di dati di Platform Web SDK, il set di dati includerà ora i nuovi campi di consenso. Ora puoi tornare alla guida all'elaborazione del consenso per continuare la procedura di configurazione dell'Experience Platform per l'elaborazione dei dati sul consenso. Se non hai creato un set di dati per questo schema, segui i passaggi descritti nella sezione successiva.

Creare un set di dati in base allo schema di consenso dataset

Dopo aver creato uno schema con campi di consenso, devi creare un set di dati che alla fine 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 nell'area di navigazione a sinistra, quindi seleziona Crea set di dati nell'angolo in alto a destra.

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

Viene visualizzato il flusso di lavoro Crea set di dati dallo 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 Successivo 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 si basa sullo schema della serie temporale, il processo è completo. Se il set di dati è basato sullo schema del record, il passaggio finale nel 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, selezionare Abilita nel popover di conferma per abilitare lo schema per Profile.

Il set di dati è ora salvato e abilitato per l'utilizzo in Profile. Se intendi utilizzare Platform Web SDK per inviare i dati del consenso al profilo, seleziona questo set di dati come Set di dati profilo durante la configurazione dello stream di dati.

Passaggi successivi

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

Ora puoi tornare alla panoramica sull'elaborazione del consenso per continuare a configurare l'Experience Platform per l'elaborazione dei dati sul consenso.

Appendice

La sezione seguente contiene informazioni aggiuntive sulla creazione di un set di dati per acquisire i dati di consenso e preferenze del cliente.

Se devi acquisire segnali di consenso aggiuntivi al di fuori di quelli rappresentati dal gruppo di campi standard Dettagli consenso e preferenze, puoi utilizzare componenti XDM personalizzati per migliorare lo schema di consenso in base alle tue esigenze aziendali specifiche. Questa sezione illustra i principi di base per personalizzare lo schema di consenso al fine di acquisire questi segnali in Profile.

IMPORTANT
Platform Web SDK e Mobile SDK non supportano i campi personalizzati nei loro comandi di modifica del consenso. Attualmente, l'unico modo per acquisire i campi di consenso personalizzati nel profilo è tramite acquisizione batch o una connessione sorgente.

Ti consigliamo vivamente di utilizzare il gruppo di campi Dettagli consenso e preferenze come base di riferimento per la struttura dei dati sul consenso e di aggiungere altri campi in base alle esigenze, anziché tentare di creare l'intera struttura da zero.

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 preferenze allo schema, seleziona l'icona più (+) nella sezione Gruppi di campi, quindi seleziona Crea nuovo gruppo di campi. Fornire un nome e una descrizione facoltativa per il gruppo di campi, quindi selezionare Aggiungi gruppo di campi.

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

Verrà visualizzato un nuovo campo all'interno dell'oggetto consents. Poiché stai aggiungendo un campo personalizzato a un oggetto XDM standard, il nuovo campo viene creato in un oggetto namespace all’ID tenant.

Nella barra a destra di 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 campo di consenso o preferenza personalizzato:

Al termine, selezionare Applica.

Il campo di consenso o preferenza viene aggiunto alla struttura dello schema. 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.

Segui i passaggi precedenti per continuare ad aggiungere i campi di consenso e preferenze necessari. Al termine, seleziona Salva per confermare le modifiche.

Se non hai creato un set di dati per questo schema, continua con la sezione sulla creazione di un set di dati.

recommendation-more-help
5741548a-2e07-44b3-9157-9c181502d0c5