Preparazione dei dati per la raccolta dati

Utilizza Data Prep, un servizio Adobe Experience Platform, per mappare, trasformare e convalidare i dati da e verso Experience Data Model (XDM). Durante la configurazione di un flusso di dati abilitato per Experience Platform, puoi utilizzare le funzionalità Data Prep per mappare i dati di origine su XDM durante l'invio a Adobe Experience Platform Edge Network.

Tutti i dati inviati da una pagina web devono pervenire ad Experience Platform come XDM. Sono disponibili tre modi per tradurre i dati da un livello dati su pagina a XDM accettato da Experience Platform:

Questa guida descrive la terza opzione.

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

La preparazione per la raccolta dei dati è utile in due situazioni:

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

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

Se si utilizza Tags, è necessario utilizzare il campo Data del tipo di azione Send Event.

Il resto di questa guida illustra come mappare il livello dati agli standard XDM dopo che è stato inviato dal Web SDK.

Questa guida illustra come mappare i dati nell’interfaccia utente. Per completare 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 dei dati, guarda il video seguente:

Fornisci dati di esempio select-data

Selezionare Save and Add Mapping dopo aver completato la configurazione di base per uno stream di dati e viene visualizzato il passaggio Select data. Da qui, devi fornire un oggetto JSON campione che rappresenti la struttura dei dati che intendi inviare ad Experience 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. Selezionare Next per continuare.

Mappare i dati mapping

Viene visualizzato il passaggio Mapping, che consente di mappare i campi nei dati di origine a quelli dello schema dell'evento di destinazione in Experience Platform. Da qui puoi configurare la mappatura in due modi:

Creare regole di mappatura create-mapping

Per creare una regola di mappatura, selezionare Add new mapping.

Seleziona l'icona di origine ( ) e nella finestra di dialogo visualizzata seleziona il campo di origine da mappare nell'area di lavoro fornita. Dopo aver scelto un campo, utilizzare il pulsante Select per continuare.

Quindi, seleziona l'icona dello schema ( ) per aprire una finestra di dialogo simile per lo schema dell'evento di destinazione. Scegliere il campo a cui si desidera mappare i dati prima di confermare con Select.

Viene visualizzata di nuovo la pagina della mappatura con la mappatura di campi completata. La sezione Mapping progress 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, selezionare Import Mapping.

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, selezionare Preview.

La schermata successiva mostra un’anteprima delle regole di mappatura salvate per lo stream di dati selezionato. Verificare che i mapping visualizzati siano quelli previsti, quindi selezionare Import per confermare e aggiungere i mapping al nuovo flusso di dati.

Completare la mappatura complete-mapping

Continua a mappare i campi rimanenti 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 Required fields indica quanti campi obbligatori non sono ancora mappati nella configurazione corrente.

Quando il conteggio dei campi richiesto raggiunge zero e la mappatura è soddisfacente, selezionare Save per finalizzare le modifiche.

Passaggi successivi next-steps

Questa guida illustra come mappare i dati su XDM durante la configurazione di uno stream di dati nell’interfaccia utente. Se stavi seguendo l'esercitazione generale sui flussi di dati, ora puoi tornare al passaggio visualizzazione dei dettagli dello stream di dati.