Datenvorbereitung für die Datenerfassung

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 Platform-aktivierten Datenstroms können Sie Datenvorbereitungs-Funktionen verwenden, um Ihre Quelldaten dem XDM zuzuordnen, wenn Sie sie an das Platform Edge Network senden.

Alle Daten, die von einer Webseite gesendet werden, müssen als XDM in Experience Platform landen. Es gibt drei Möglichkeiten, Daten von einer On-Page-Datenschicht in das von Experience Platform akzeptierte XDM zu übersetzen:

  1. Formatieren Sie die Datenschicht in XDM auf der Webseite selbst.
  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 Webseite über das Edge Network in XDM um, indem Sie die Datenvorbereitung für die Datenerfassung verwenden.

Dieser Leitfaden konzentriert sich auf die dritte Option.

Verwendung der Datenvorbereitung für die Datenerfassung when-to-use-data-prep

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

  1. Die Website verfügt über eine gut strukturierte, verwaltete und gepflegte Datenschicht. Daher ist es empfehlenswert, sie direkt an das Edge Network zu senden, anstatt sie mithilfe der JavaScript-Manipulation in XDM auf der Seite zu konvertieren (entweder über Tags-Datenelemente oder durch manuelle JavaScript-Manipulation).
  2. Auf der Site wird ein anderes Tagging-System als Tags bereitgestellt.

Existierende Datenschicht über WebSDK an das Edge Network senden send-datalayer-via-websdk

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

Wenn Sie Tags verwenden, müssen Sie das Feld Daten des Aktionstyps Ereignis senden verwenden, wie in der Dokumentation zur 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:

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:

Auswählen von Daten select-data

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. Hier müssen Sie ein JSON-Beispielobjekt bereitstellen, das der Struktur der Daten entspricht, die Sie an 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 sie den Datenschichteigenschaften zugeordnet werden, 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
code language-json
{
  "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
code language-json
{
  "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 der erwarteten eingehenden 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 dieses JSON-Beispielobjekt aufgenommen werden.

Zuordnung

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

Erstellen von Zuordnungsregeln create-mapping

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

Hinzufügen einer neuen Zuordnung.

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.

Auswahl 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 wurde erfolgreich mit dem erkannten Fortschritt zugeordnet.

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

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

WARNING
Beim Importieren von Zuordnungsregeln aus einem anderen Datenspeicher werden alle vor dem Import hinzugefügten Feldzuordnungen überschrieben.

Wählen Sie zunächst Zuordnung importieren aus.

Die Schaltfläche Importzuordnung wurde ausgewählt.

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

Vorhandenen Datastream auswählen.

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 für den Import.

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 wie erforderlich festgelegt sind, für diesen Schritt zugeordnet werden. Der Zähler Erforderliche Felder gibt an, wie viele erforderlichen Felder in der aktuellen Konfiguration noch nicht zugeordnet sind.

Sobald die erforderliche Feldanzahl null erreicht hat und Sie mit Ihrer Zuordnung zufrieden sind, wählen Sie Speichern aus, um die Ä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