Gegevensvoorvoegsel voor gegevensverzameling

Het gebruik Data Prep, een Adobe Experience Platform dienst, om, gegevens in kaart te brengen om te transformeren en te bevestigen aan en van ​ het Model van Gegevens van de Ervaring (XDM) ​. Wanneer het vormen van een Experience Platform-Toegelaten ​ datastream ​, kunt u Data Prep mogelijkheden gebruiken om uw brongegevens aan XDM in kaart te brengen wanneer het verzenden van het naar Adobe Experience Platform Edge Network.

Alle gegevens die vanaf een webpagina worden verzonden, moeten in Experience Platform als XDM worden geland. U kunt gegevens op drie manieren omzetten van een gegevenslaag op pagina naar de XDM die door Experience Platform wordt geaccepteerd:

Deze handleiding behandelt de derde optie.

Wanneer wordt Data Prep gebruikt voor gegevensverzameling when-to-use-data-prep

Data Prep voor gegevensverzameling is handig in twee situaties:

Een bestaande gegevenslaag via Web SDK naar de Edge Network verzenden send-datalayer-via-websdk

De bestaande gegevenslaag moet worden verzonden met het object data binnen de opdracht sendEvent .

Als u Tags gebruikt, moet u het Data veld van het Send Event actietype gebruiken.

De rest van deze gids behandelt hoe te om de gegevenslaag aan normen in kaart te brengen XDM nadat het door het Web SDK is verzonden.

In deze handleiding wordt uitgelegd hoe u uw gegevens in de gebruikersinterface kunt toewijzen. Om de stappen te voltooien, begin het proces om een datastream tot (en met inbegrip van) de ​ basisconfiguratiestap ​ te creëren.

Bekijk de volgende video voor een snelle demonstratie van het proces Data Prep for Data Collection:

Voorbeeldgegevens opgeven select-data

Selecteer Save and Add Mapping nadat u de basisconfiguratie voor een gegevensstroom hebt voltooid en de stap Select data wordt weergegeven. Van hieruit moet u een voorbeeld-JSON-object opgeven dat de structuur vertegenwoordigt van de gegevens die u naar Experience Platform wilt verzenden.

Als u eigenschappen rechtstreeks vanaf uw gegevenslaag wilt vastleggen, moet het JSON-object één basiseigenschap data hebben. De subeigenschappen van het data -object moeten vervolgens zo worden geconstrueerd dat ze zijn toegewezen aan de eigenschappen van de gegevenslaag die u wilt vastleggen. Selecteer de onderstaande sectie om een voorbeeld weer te geven van een JSON-object met de juiste opmaak en een data root.

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

Als u eigenschappen van een XDM-objectelement wilt vastleggen, zijn dezelfde regels van toepassing op het JSON-object, maar in plaats daarvan moet de eigenschap root worden ingesteld op xdm . Selecteer de onderstaande sectie om een voorbeeld weer te geven van een JSON-object met de juiste indeling en de hoofdmap van 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
    }
  }
}

U kunt de optie selecteren om het object als een bestand te uploaden of het onbewerkte object in het tekstvak dat wordt weergegeven plakken. Als de JSON geldig is, wordt een voorvertoningsschema weergegeven in het rechterdeelvenster. Selecteer Next om door te gaan.

Uw gegevens toewijzen mapping

De stap Mapping wordt weergegeven, zodat u de velden in uw brongegevens kunt toewijzen aan die van het doelgebeurtenisschema in Experience Platform. Van hier, kunt u de afbeelding op twee manieren vormen:

Toewijzingsregels maken create-mapping

Selecteer Add new mapping om een toewijzingsregel te maken.

Selecteer het bronpictogram ( ), en in de dialoog die verschijnt selecteer het brongebied dat u in kaart wilt brengen in het verstrekte canvas. Nadat u een veld hebt gekozen, drukt u op de knop Select om door te gaan.

Daarna, selecteer het schemapictogram ( ) om een gelijkaardige dialoog voor het schema van de doelgebeurtenis te openen. Kies het veld waaraan u de gegevens wilt toewijzen voordat u bevestigt met Select .

De toewijzingspagina wordt opnieuw weergegeven met de voltooide veldtoewijzing weergegeven. De sectie Mapping progress wordt bijgewerkt op basis van het totale aantal velden dat is toegewezen.

TIP

Als u een array van objecten (in het bronveld) wilt toewijzen aan een array van verschillende objecten (in het doelveld), voegt u [*] toe na de arraynaam in de bron- en doelveldpaden, zoals hieronder wordt weergegeven.

Bestaande toewijzingsregels importeren import-mapping

Als u eerder een gegevensstroom hebt gecreeerd, kunt u zijn gevormde toewijzingsregels voor een nieuwe gegevensstroom opnieuw gebruiken.

Selecteer Import Mapping om te beginnen.

Selecteer in het dialoogvenster dat wordt weergegeven de gegevensstroom waarvan u de toewijzingsregels wilt importeren. Wanneer de gegevensstroom is gekozen, selecteert u Preview .

In het volgende scherm ziet u een voorvertoning van de opgeslagen toewijzingsregels voor de geselecteerde gegevensstroom. Zorg ervoor dat de weergegeven toewijzingen zijn wat u verwacht en selecteer vervolgens Import om de toewijzingen te bevestigen en toe te voegen aan de nieuwe gegevensstroom.

De toewijzing voltooien complete-mapping

Wijs de overige velden toe aan het doelschema. Hoewel u niet alle beschikbare brongebieden moet in kaart brengen, om het even welke gebieden in het doelschema die zoals vereist worden geplaatst moeten worden in kaart gebracht om deze stap te voltooien. De teller Required fields geeft aan hoeveel vereiste velden nog niet zijn toegewezen in de huidige configuratie.

Wanneer het vereiste aantal velden nul bereikt en u tevreden bent met de toewijzing, selecteert u Save om de wijzigingen te voltooien.

Volgende stappen next-steps

In deze handleiding wordt beschreven hoe u uw gegevens aan XDM kunt toewijzen bij het instellen van een gegevensstroom in de gebruikersinterface. Als u het algemene datastreams leerprogramma volgde, kunt u aan de stap op ​ nu terugkeren het bekijken van datastreamdetails ​.