Dataförberedelse för datainsamling

Använd Data Prep, en Adobe Experience Platform-tjänst, för att mappa, omvandla och validera data till och från Experience Data Model (XDM). När du konfigurerar en datastream som har aktiverats av Experience Platform kan du använda Data Prep-funktioner för att mappa dina källdata till XDM när du skickar dem till Adobe Experience 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å sidan till den XDM som accepteras av Experience Platform:

Den här guiden täcker det tredje alternativet.

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

Dataprep för datainsamling är användbart i två situationer:

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

Det befintliga datalagret måste skickas med objektet data i kommandot sendEvent.

Om du använder Tags måste du använda fältet Data för åtgärdstypen Send Event.

Resten av guiden beskriver hur datalagret mappas till XDM-standarder när det har skickats av Web SDK.

Den här handboken beskriver hur du mappar data i användargränssnittet. Slutför stegen genom att starta processen för att skapa en datastam upp till (och inklusive) det grundläggande konfigurationssteget.

En snabb demonstration av datapresten för datainsamling finns i följande video:

Ange exempeldata select-data

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

Om du vill hämta egenskaper direkt från datalagret måste JSON-objektet ha en enda rotegenskap, data. Underegenskaperna för objektet data ska sedan konstrueras på ett sätt som mappar till de datalageregenskaper som du vill hämta. Markera avsnittet nedan om du vill visa ett exempel på ett korrekt formaterat JSON-objekt med en 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 en 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 om du vill fortsätta.

Kartlägg era data mapping

Steg Mapping visas, så att du kan mappa fälten i källdata till målhändelseschemats fält i Experience 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.

Markera källikonen ( ) och markera det källfält som du vill mappa på den angivna arbetsytan i dialogrutan som visas. När du har valt ett fält använder du knappen 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. Avsnittet Mapping progress uppdateras 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.

Välj Import Mapping om du vill starta.

I den dialogruta som visas markerar du datastream vars mappningsregler du vill importera. Välj Preview när du har valt datastream.

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 complete-mapping

Fortsätt mappa återstående fält 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. Räknaren Required fields anger hur många obligatoriska fält som ännu inte har mappats i den aktuella konfigurationen.

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

Nästa steg next-steps

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öljde den allmänna datastreams-självstudiekursen kan du nu gå tillbaka till steget visa dataströmsinformation.