Creare set di dati

In questa lezione verranno creati set di dati per ricevere i dati. Sarete entusiasti di sapere che questa è la lezione più breve del tutorial!

Tutti i dati correttamente acquisiti in Adobe Experience Platform vengono memorizzati nel data lake come set di dati. Un set di dati è un costrutto di archiviazione e gestione per una raccolta di dati, in genere una tabella, che contiene uno schema (colonne) e campi (righe). I set di dati contengono anche metadati che descrivono vari aspetti dei dati memorizzati.

Gli architetti di dati dovranno creare set di dati al di fuori di questa esercitazione.

Prima di iniziare gli esercizi, guarda questo breve video per ulteriori informazioni sui set di dati:

Autorizzazioni necessarie

Nella lezione Configurare le autorizzazioni , puoi impostare tutti i controlli di accesso necessari per completare la lezione, in particolare:

  • Voci di autorizzazione Gestione dati > Visualizza set di dati e Gestisci set di dati
  • Voce di autorizzazione Sandbox > Luma Tutorial
  • Accesso al profilo di prodotto Luma Tutorial Platform tramite ruolo utente
  • Accesso ai ruoli per sviluppatori al profilo di prodotto Luma Tutorial Platform (per API)

Creare set di dati nell’interfaccia utente

In questo esercizio, creeremo i set di dati nell’interfaccia utente. Cominciamo con il sistema fedeltà:

  1. Vai a Set di dati nella navigazione a sinistra dell’interfaccia utente di Platform

  2. Selezionare il pulsante Crea set di dati
    Creare un set di dati

  3. Nella schermata successiva, seleziona Crea set di dati da schema

  4. Nella schermata successiva, seleziona il Luma Loyalty Schema e quindi seleziona il pulsante Avanti
    Selezionare il set di dati

  5. Denomina il set di dati Luma Loyalty Dataset e seleziona il pulsante Fine
    Denomina il set di dati

  6. Una volta salvato il set di dati, verrai portato su una schermata come questa:
    Set di dati creato

Tutto qui. Te l'ho detto che sarebbe stato veloce. Crea questi altri set di dati seguendo gli stessi passaggi:

  1. Luma Offline Purchase Event Dataset per Luma Offline Purchase Event Schema
  2. Luma Web Events Dataset per Luma Web Events Schema
  3. Luma Product Catalog Dataset per Luma Product Catalog Schema

Creare un set di dati tramite API

Ora crea il Luma CRM Dataset utilizzando l’API .

NOTA

Se desideri saltare l’esercizio API e creare il Luma CRM Dataset nell’interfaccia utente, va bene. Denomina Luma CRM Dataset e utilizza il Luma CRM Schema.

Ottieni l’id dello schema da utilizzare nel set di dati

Prima di tutto è necessario ottenere il $id del Luma CRM Schema:

  1. Open Postman
  2. Se non hai effettuato una richiesta nelle ultime 24 ore, i token di autorizzazione probabilmente sono scaduti. Apri la richiesta Adobe I/O Access Token Generation > Local Signing (Non-production use-only) > IMS: JWT Generate + Auth via User Token e seleziona Invia per richiedere nuovi token JWT e Access, proprio come nella lezione Postman.
  3. Apri la richiesta Schema Registry API > Schemas > List all schemas within the specified container.
  4. Aggiorna l’intestazione Accept a uno dei valori consentiti, ad esempio application/vnd.adobe.xdm+json
  5. Selezionare il pulsante Invia
  6. Dovresti ricevere una risposta di 200
  7. Cerca nella risposta l'elemento Luma CRM Schema e copia il valore $id
    Copia il $id

Creare il set di dati

Ora puoi creare il set di dati:

  1. Scarica Servizio catalogo API.postman_collection.json nella cartella Luma Tutorial Assets. (La raccolta Dataset Service API serve a gestire le etichette di utilizzo dei dati sui set di dati esistenti)

  2. Importa la raccolta in Postman

  3. Seleziona la richiesta Catalog Service API > Datasets > Create a new dataset.

  4. Incolla quanto segue come Corpo della richiesta, sostituendo il valore id con il tuo:

    {
        "name": "Luma CRM Dataset",
    
        "schemaRef": {
            "id": "REPLACE_WITH_YOUR_OWN_ID",
            "contentType": "application/vnd.adobe.xed-full+json;version=1"
        },
        "fileDescription": {
            "persisted": true,
            "containerFormat": "parquet",
            "format": "parquet"
        }
    }
    
  5. Selezionare il pulsante Invia

  6. Dovresti ottenere una risposta Creato 201 contenente l’id del nuovo set di dati.
    Copia il $id

SUGGERIMENTO

Problemi comuni che effettuano questa richiesta e possibili correzioni:

  • 400: There was a problem retrieving xdm schema. Assicurati di aver sostituito l'id nell'esempio precedente con il tuo Luma CRM Schema
  • Nessun token di autenticazione: Esegui IMS: JWT Genera + Auth tramite la chiamata User Token per generare nuovi token
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/: Aggiorna la variabile CONTAINER_ IDenvironment da global a tenant
  • 403: PALM Access Denied. POST access is denied for this resource from access control: Verifica le autorizzazioni utente nell’Admin Console

Torna alla schermata Set di dati nell’interfaccia utente di Platform. Puoi verificare la corretta creazione di tutti e cinque i set di dati!
Cinque set di dati completati

Risorse aggiuntive

Ora che sono presenti tutti i nostri schemi, identità e set di dati, possiamo abilitarli per il Profilo cliente in tempo reale.

In questa pagina