DokumentationExperience PlatformHandbuch zu Datenströmen

Datenvorbereitung für die Datenerfassung

Letzte Aktualisierung: 5. Mai 2025
  • Themen:
  • Daten-Streams

Erstellt für:

  • Entwickler

Datenvorbereitung ist ein Adobe Experience Platform-Service, mit dem Sie Daten zuordnen, umwandeln und validieren können, die an das Experience-Datenmodell (XDM) gesendet oder von ihm empfangen werden. Beim Konfigurieren eines Experience Platform-aktivierten Datenstroms können Sie Datenvorbereitungsfunktionen verwenden, um Ihre Quelldaten dem XDM zuzuordnen, wenn Sie sie an die Experience Platform Edge Network senden.

Alle von einer Web-Seite gesendeten Daten müssen als XDM in Experience Platform landen. Es gibt 3 Möglichkeiten, Daten von einer On-Page-Datenschicht in das von Experience Platform akzeptierte XDM zu übersetzen:

  1. Formatieren Sie die Datenschicht auf der Webseite selbst in XDM neu.
  2. Verwenden Sie die Funktion Native Datenelemente von Tags , um das vorhandene Datenschichtformat einer Web-Seite in XDM umzuformatieren.
  3. Formatieren Sie das vorhandene Datenschichtformat einer Web-Seite über die Edge Network in XDM um, indem Sie die Datenvorbereitung für die Datenerfassung verwenden.

Dieses Handbuch konzentriert sich auf die dritte Option.

Verwendung der Datenvorbereitung für die Datenerfassung

Es gibt zwei Anwendungsfälle, in denen die Datenvorbereitung für die Datenerfassung nützlich ist:

  1. Die Website verfügt über eine gut geformte, verwaltete und gepflegte Datenschicht und es wird empfohlen, sie direkt an die Edge Network zu senden, anstatt die JavaScript-Manipulation zu verwenden, um sie auf der Seite in XDM zu konvertieren (entweder über Tags-Datenelemente oder über die manuelle JavaScript-Manipulation).
  2. Ein anderes Tagging-System als Tags wird auf der Site bereitgestellt.

Senden einer vorhandenen Datenschicht an die Edge Network über WebSDK

Die vorhandene Datenschicht muss mithilfe des data-Objekts innerhalb des sendEvent-Befehls gesendet werden.

Wenn Sie Tags verwenden, müssen Sie das Feld Daten des Aktionstyps Ereignis senden verwenden, wie in der Dokumentation Web SDK-Tag-Erweiterung beschrieben.

Der Rest dieses Handbuchs konzentriert sich auf die Zuordnung der Datenschicht zu XDM-Standards, nachdem sie vom WebSDK gesendet wurde.

NOTE
Eine umfassende Anleitung zu allen Datenvorbereitungs-Funktionen, einschließlich der Umwandlungsfunktionen für berechnete Felder, finden Sie in der folgenden Dokumentation:
  • Datenvorbereitung – Übersicht
  • Funktionen zur Datenvorbereitung
  • Verarbeiten von Datenformaten mit der Datenvorbereitung

In diesem Handbuch wird beschrieben, wie Sie Ihre Daten innerhalb der Benutzeroberfläche zuordnen können. Führen Sie zunächst den Prozess zur Erstellung eines Datenstroms bis (einschließlich) der allgemeinen Konfiguration aus.

Eine kurze Erklärung des Prozesses „Datenvorbereitung für die Datenerfassung“ finden Sie im folgenden Video:

video poster

https://video.tv.adobe.com/v/3410301?quality=12&enable10seconds=on&speedcontrol=on&captions=ger

Auswählen von Daten

Wählen Sie nach der allgemeinen Konfiguration eines Datenstroms die Option Speichern und Zuordnung hinzufügen aus. Daraufhin wird der Schritt Daten auswählen angezeigt. Von hier aus müssen Sie ein JSON-Beispielobjekt bereitstellen, das die Struktur der Daten darstellt, die Sie an Experience Platform senden möchten.

Um Eigenschaften direkt aus Ihrer Datenschicht zu erfassen, muss das JSON-Objekt über eine einzige Stammeigenschaft verfügen: data. Die Untereigenschaften des data-Objekts sollten dann so konstruiert werden, dass es den Datenschicht-Eigenschaften zugeordnet werden kann, die Sie erfassen möchten. Wählen Sie den folgenden Abschnitt aus, um ein Beispiel für ein ordnungsgemäß formatiertes JSON-Objekt mit einem data-Stamm zu sehen.

JSON-Beispieldatei mit data-Stamm
{
  "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
    }
  }
}

Bei der Erfassung von Eigenschaften aus einem XDM-Objekt-Datenelement gelten dieselben Regeln für das JSON-Objekt, doch die Stammeigenschaft muss stattdessen als xdm eingegeben werden. Wählen Sie den folgenden Abschnitt aus, um ein Beispiel für ein ordnungsgemäß formatiertes JSON-Objekt mit einem xdm-Stamm zu sehen.

JSON-Beispieldatei mit xdm-Stamm
{
  "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
    }
  }
}

Sie können die Option zum Hochladen des Objekts als Datei auswählen oder stattdessen das Raw-Objekt in das bereitgestellte Textfeld einfügen. Wenn die JSON gültig ist, wird im rechten Bereich ein Vorschauschema angezeigt. Klicken Sie auf Weiter, um fortzufahren.

JSON-Beispiel für erwartete eingehende Daten.

NOTE
Verwenden Sie ein JSON-Beispielobjekt, das jedes Datenschichtelement darstellt, das auf einer beliebigen Seite verwendet werden kann. Beispielsweise verwenden nicht alle Seiten Datenschichtelemente des Warenkorbs. Die Datenschichtelemente des Warenkorbs sollten jedoch in diesem JSON-Beispielobjekt enthalten sein.

Zuordnung

Der Zuordnungsschritt wird angezeigt, sodass Sie die Felder in Ihren Quelldaten dem Zielereignisschema in Experience Platform zuordnen können. Sie haben die Möglichkeit, die Zuordnung auf zwei Arten zu konfigurieren:

  • Erstellen Siefür diesen Datenstrom durch einen manuellen Prozess.
  • Importieren Sie Zuordnungsregeln aus einem vorhandenen Datenstrom.
IMPORTANT
Die Datenvorbereitung überschreibt identityMap XDM-Payloads, was sich weiter auf den Profilabgleich mit Real-Time CDP-Zielgruppen auswirken kann.

Erstellen von Zuordnungsregeln

Um eine Zuordnungsregel zu erstellen, wählen Sie Neue Zuordnung hinzufügen aus.

Neue Zuordnung hinzufügen.

Wählen Sie das Quellensymbol ( Quellensymbol ) und danach im sich öffnenden Dialogfeld das Quellfeld aus, das Sie auf der bereitgestellten Arbeitsfläche zuordnen möchten. Nachdem Sie ein Feld ausgewählt haben, verwenden Sie die Schaltfläche Auswählen, um fortzufahren.

Auswahl des Felds, das im Quellschema zugeordnet werden soll.

Wählen Sie anschließend das Schemasymbol ( Schemasymbol ) aus, um ein ähnliches Dialogfeld für das Zielereignisschema zu öffnen. Wählen Sie das Feld aus, dem Sie die Daten zuordnen möchten, und bestätigen Sie dann mit Auswählen.

Auswählen des Felds, das im Zielschema zugeordnet werden soll.

Die Zuordnungsseite wird erneut mit der abgeschlossenen Feld-Zuordnung angezeigt. Der Abschnitt Zuordnungsfortschritt wird aktualisiert und zeigt die Gesamtzahl der Felder an, die bereits erfolgreich zugeordnet wurden.

Feld, das erfolgreich zugeordnet wurde und dessen Fortschritt widergespiegelt wird.

TIP
Wenn Sie ein Array von Objekten (im Quellfeld) einem Array von anderen Objekten (im Zielfeld) zuordnen möchten, fügen Sie wie unten dargestellt in den Pfaden der Quell- und Zielfelder nach dem Array-Namen [*] ein.
Array-Objektzuordnung.

Importieren vorhandener Zuordnungsregeln

Wenn Sie zuvor einen Datenstrom erstellt haben, können Sie seine konfigurierten Zuordnungsregeln für einen neuen Datenstrom wiederverwenden.

WARNING
Durch das Importieren von Zuordnungsregeln aus einem anderen Datenstrom werden alle Feldzuordnungen überschrieben, die Sie möglicherweise vor dem Import hinzugefügt haben.

Wählen Sie zunächst Zuordnung importieren aus.

Auswahl der Schaltfläche Zuordnung importieren.

Wählen Sie im sich öffnenden Dialogfeld den Datenstrom aus, dessen Zuordnungsregeln Sie importieren möchten. Wählen Sie danach Vorschau aus.

Auswählen eines vorhandenen Datenstroms.

NOTE
Datenströme können nur innerhalb derselben Sandbox importiert werden. Mit anderen Worten: Sie können den Datenstrom von einer Sandbox nicht in eine andere importieren.

Im nächsten Bildschirm wird eine Vorschau der gespeicherten Zuordnungsregeln für den ausgewählten Datenstrom gezeigt. Prüfen Sie, ob die angezeigten Zuordnungen korrekt sind und wählen Sie dann Importieren aus, um die Zuordnungen zu bestätigen und zum neuen Datenstrom hinzuzufügen.

Zuordnungsregeln zum Importieren.

NOTE
Wenn Quellfelder in den importierten Zuordnungsregeln nicht in den von Ihnen zuvor bereitgestellten JSON-Beispieldaten enthalten sind, werden diese Feldzuordnungen nicht in den Import einbezogen.

Abschließen der Zuordnung

Führen Sie die oben genannten Schritte erneut aus, um den Rest der Felder dem Zielschema zuzuordnen. Sie müssen zwar nicht alle verfügbaren Quellfelder zuordnen, jedoch müssen alle Felder im Zielschema, die als erforderlich festgelegt sind, zugeordnet werden, um diesen Schritt abzuschließen. Der Zähler Erforderliche Felder gibt an, wie viele erforderlichen Felder in der aktuellen Konfiguration noch nicht zugeordnet sind.

Nachdem die erforderliche Feldanzahl null erreicht hat und Sie Ihre Zuordnung überprüft haben, wählen Sie Speichern aus, um Ihre Änderungen abzuschließen.

Zuordnungen abgeschlossen

Nächste Schritte

In diesem Handbuch wurde beschrieben, wie Sie Ihre Daten XDM zuordnen, wenn Sie einen Datenstrom in der Benutzeroberfläche einrichten. Wenn Sie dem Tutorial zu allgemeinen Datenströmen gefolgt sind, können Sie jetzt zur Anleitung zum Anzeigen von Datenspeicherdetails zurückkehren

recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac