Preparazione dei dati per la raccolta dati

La preparazione dati è un servizio di Adobe Experience Platform che consente di mappare, trasformare e convalidare i dati da e per Experience Data Model (XDM). Durante la configurazione di uno stream di dati, puoi utilizzare le funzionalità di preparazione dati per mappare i dati di origine su XDM quando li invii alla rete Edge di Platform.

Tutti i dati inviati da una pagina web devono arrivare ad Experience Platform come XDM. Esistono 3 modi per tradurre i dati da un livello dati su pagina a XDM accettato da Experience Platform:

Questa guida si concentra sulla terza opzione.

Quando utilizzare la preparazione dati per la raccolta dati when-to-use-data-prep

Esistono due casi di utilizzo in cui la preparazione dei dati per la raccolta dei dati è utile:

Inviare un livello dati esistente all’Edge Network tramite Web SDK send-datalayer-via-websdk

Il livello dati esistente deve essere inviato utilizzando l'oggetto data nel comando sendEvent.

Se utilizzi Tag, devi utilizzare il campo Dati del tipo di azione Invia evento, come descritto nella documentazione sull'estensione tag di Web SDK.

Il resto di questa guida si concentrerà su come mappare il livello dati agli standard XDM dopo che è stato inviato da WebSDK.

Questa guida illustra come mappare i dati nell’interfaccia utente. Per seguire i passaggi, avvia il processo di creazione di uno stream di dati fino al passaggio di configurazione di base (incluso).

Per una dimostrazione rapida del processo di preparazione dei dati per la raccolta dati, guarda il video seguente:

Selezionare i dati select-data

Dopo aver completato la configurazione di base per uno stream di dati, seleziona Salva e Aggiungi mappatura e verrà visualizzato il passaggio Seleziona dati. Da qui, devi fornire un oggetto JSON di esempio che rappresenta la struttura dei dati che intendi inviare a Platform.

Per acquisire proprietà direttamente dal livello dati, l’oggetto JSON deve avere una singola proprietà principale data. Le sottoproprietà dell'oggetto data devono quindi essere costruite in modo da eseguire il mapping alle proprietà del livello dati che si desidera acquisire. Seleziona la sezione seguente per visualizzare un esempio di oggetto JSON formattato correttamente con una radice data.

{
  "data": {
    "eventMergeId": "cce1b53c-571f-4f36-b3c1-153d85be6602",
    "eventType": "view:load",
    "timestamp": "2021-09-30T14:50:09.604Z",
    "web": {
      "webPageDetails": {
        "siteSection": "Product section",
        "server": "example.com",
        "name": "product home",
        "URL": "https://www.example.com"
      },
      "webReferrer": {
        "URL": "https://www.adobe.com/index2.html",
        "type": "external"
      }
    },
    "commerce": {
      "purchase": 1,
      "order": {
        "orderID": "1234"
      }
    },
    "product": [
      {
        "productInfo": {
          "productID": "123"
        }
      },
      {
        "productInfo": {
          "productID": "1234"
        }
      }
    ],
    "reservation": {
      "id": "anc45123xlm",
      "name": "Embassy Suits",
      "SKU": "12345-L",
      "skuVariant": "12345-LG-R",
      "priceTotal": "112.99",
      "currencyCode": "USD",
      "adults": 2,
      "children": 3,
      "productAddMethod": "PDP",
      "_namespace": {
        "test": 1,
        "priceTotal": "112.99",
        "category": "Overnight Stay"
      },
      "freeCancellation": false,
      "cancellationFee": 20,
      "refundable": true
    }
  }
}

Per acquisire proprietà da un elemento dati di un oggetto XDM, all’oggetto JSON si applicano le stesse regole, ma la proprietà principale deve essere invece impostata come xdm. Seleziona la sezione seguente per visualizzare un esempio di oggetto JSON formattato correttamente con una radice xdm.

{
  "xdm": {
    "environment": {
      "type": "browser",
      "browserDetails": {
        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5) AppleWebkit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.112 Safari/537.36",
        "javaScriptEnabled": true,
        "javaScriptVersion": "1.8.5",
        "cookiesEnabled": true,
        "viewportHeight": 900,
        "viewportWidth": 1680,
        "javaEnabled": true
      },
      "domain": "adobe.com",
      "colorDepth": 24,
      "viewportHeight": 1050,
      "viewportWidth": 1680
    },
    "device": {
      "screenHeight": 1050,
      "screenWidth": 1680
    }
  }
}

È possibile selezionare l’opzione per caricare l’oggetto come file oppure incollarlo nella casella di testo specificata. Se il JSON è valido, nel pannello di destra viene visualizzato uno schema di anteprima. Seleziona Avanti per continuare.

Mappatura

Viene visualizzato il passaggio di mappatura, consentendoti di mappare i campi nei dati di origine su quelli dello schema dell’evento di destinazione in Platform. Da qui puoi configurare la mappatura in due modi:

Creare regole di mappatura create-mapping

Per creare una regola di mapping, selezionare Aggiungi nuovo mapping.

Seleziona l’icona della sorgente ( ) e nella finestra di dialogo visualizzata seleziona il campo di origine che desideri mappare nell’area di lavoro fornita. Dopo aver scelto un campo, utilizza il pulsante Seleziona per continuare.

Quindi, seleziona l’icona dello schema ( ) per aprire una finestra di dialogo simile per lo schema dell’evento di destinazione. Scegli il campo in cui mappare i dati prima di confermare con Seleziona.

Viene visualizzata di nuovo la pagina della mappatura con la mappatura di campi completata. La sezione Avanzamento della mappatura viene aggiornata per riflettere il numero totale di campi mappati correttamente.

TIP

Per mappare un array di oggetti (nel campo di origine) su un array di oggetti diversi (nel campo di destinazione), aggiungi [*] dopo il nome dell’array nei percorsi dei campi di origine e di destinazione, come illustrato di seguito.

Importare regole di mappatura esistenti import-mapping

Se in precedenza hai creato un flusso di dati, puoi riutilizzarne le regole di mappatura configurate per un nuovo flusso di dati.

Per iniziare, seleziona Importa mappatura.

Nella finestra di dialogo visualizzata, seleziona lo stream di dati di cui desideri importare le regole di mappatura. Una volta scelto lo stream di dati, seleziona Anteprima.

La schermata successiva mostra un’anteprima delle regole di mappatura salvate per lo stream di dati selezionato. Assicurati che le mappature visualizzate siano quelle previste, quindi seleziona Importa per confermare e aggiungere le mappature al nuovo stream di dati.

Completare la mappatura

Continua a seguire i passaggi precedenti per mappare il resto dei campi sullo schema di destinazione. Anche se non è necessario mappare tutti i campi sorgente disponibili, tutti i campi nello schema di destinazione impostati come richiesto devono essere mappati per completare questo passaggio. Il contatore dei Campi obbligatori indica quanti campi obbligatori non sono ancora mappati nella configurazione corrente.

Una volta che il conteggio dei campi richiesto raggiunge zero e la mappatura è soddisfacente, seleziona Salva per finalizzare le modifiche.

Passaggi successivi

Questa guida illustra come mappare i dati su XDM durante la configurazione di uno stream di dati nell’interfaccia utente. Se stavi seguendo il tutorial generale sugli stream di dati, ora puoi tornare al passaggio sulla visualizzazione dei dettagli dello stream di dati.