Dataförberedelse för datainsamling

Data Prep är en Adobe Experience Platform-tjänst som gör att du kan mappa, omvandla och validera data till och från Experience Data Model (XDM). När en plattform konfigureras datastreamkan du använda Data Prep-funktioner för att mappa dina källdata till XDM när du skickar dem till Platform Edge Network.

Alla data som skickas från en webbsida måste landas i Experience Platform som XDM. Det finns tre sätt att översätta data från ett datalager på en sida till den XDM som accepteras av Experience Platform:

Den här guiden fokuserar på det tredje alternativet.

När dataprep ska användas för datainsamling when-to-use-data-prep

Det finns två användningsområden där Data Prep för datainsamling är användbart:

Skicka ett befintligt datalager till Edge Network via WebSDK send-datalayer-via-websdk

Det befintliga datalagret måste skickas med data objekt inuti sendEvent -kommando.

Om du använder taggar måste du använda Data fält för Send Event åtgärdstyp, enligt beskrivningen i Dokumentation för SDK-taggtillägg.

Resten av guiden fokuserar på hur datalagret ska mappas till XDM-standarder när det har skickats av WebSDK.

Den här handboken beskriver hur du mappar data i användargränssnittet. Om du vill följa med i stegen börjar du med att skapa en datastream upp till (och inkludera) grundläggande konfigurationssteg.

En snabb demonstration av datainsamlingsprocessen finns i följande video:

Select data select-data

Välj Save and Add Mapping när du har slutfört den grundläggande konfigurationen för ett datastream, och Select data visas. Härifrån måste du ange ett exempel på ett JSON-objekt som representerar strukturen för de data som du planerar att skicka till Platform.

Om du vill hämta egenskaper direkt från datalagret måste JSON-objektet ha en enda rotegenskap data. Underegenskaperna för data objektet ska sedan konstrueras på ett sätt som mappar till datalagrets egenskaper som du vill hämta. Markera avsnittet nedan om du vill visa ett exempel på ett korrekt formaterat JSON-objekt med ett data rot.

{
  "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
    }
  }
}

Om du vill hämta egenskaper från ett XDM-objektdataelement gäller samma regler för JSON-objektet, men rotegenskapen måste anges som xdm i stället. Markera avsnittet nedan om du vill visa ett exempel på ett korrekt formaterat JSON-objekt med ett xdm rot.

{
  "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
    }
  }
}

Du kan välja att överföra objektet som en fil eller klistra in raw-objektet i den angivna textrutan i stället. Om JSON är giltig visas ett förhandsgranskningsschema i den högra panelen. Välj Next för att fortsätta.

Mapping

The Mapping visas så att du kan mappa fälten i källdata till målhändelseschemats fält i Platform. Här kan du konfigurera mappningen på två sätt:

Skapa mappningsregler create-mapping

Om du vill skapa en mappningsregel väljer du Add new mapping.

Välj källikon ( ) och i den dialogruta som visas väljer du det källfält som du vill mappa på den angivna arbetsytan. När du har valt ett fält använder du Select för att fortsätta

Välj sedan schemaikonen ( ) för att öppna en liknande dialogruta för målhändelseschemat. Välj det fält som du vill mappa data till innan du bekräftar med Select.

Mappningssidan visas igen med den ifyllda fältmappningen. The Mapping progress avsnittsuppdateringar för att återspegla det totala antalet fält som har mappats.

TIP

Om du vill mappa en array med objekt (i källfältet) till en array med olika objekt (i målfältet) lägger du till [*] efter arraynamnet i käll- och målfältssökvägarna, vilket visas nedan.

Importera befintliga mappningsregler import-mapping

Om du tidigare har skapat en datastream kan du återanvända dess konfigurerade mappningsregler för en ny datastream.

Börja genom att välja Import Mapping.

I den dialogruta som visas markerar du datastream vars mappningsregler du vill importera. När du har valt datastream väljer du Preview.

På nästa skärm visas en förhandsvisning av de sparade mappningsreglerna för det valda datastream. Kontrollera att de visade mappningarna är vad du förväntar dig och välj sedan Import för att bekräfta och lägga till mappningarna i den nya datastream.

Slutför mappningen

Följ stegen ovan för att mappa resten av fälten till målschemat. Även om du inte behöver mappa alla tillgängliga källfält, måste alla fält i målschemat som har angetts som obligatoriska mappas för att slutföra det här steget. The Required fields anger hur många obligatoriska fält som ännu inte har mappats i den aktuella konfigurationen.

När det obligatoriska fältantalet har nått noll och du är nöjd med mappningen väljer du Save för att slutföra ändringarna.

Nästa steg

I den här guiden beskrivs hur du mappar data till XDM när du konfigurerar ett datastream i användargränssnittet. Om du följer den allmänna datastreams-självstudiekursen kan du nu gå tillbaka till steget visa information om dataström.