Datenvorbereitung für die Datenerfassung
- 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:
- Formatieren Sie die Datenschicht auf der Webseite selbst in XDM neu.
- Verwenden Sie die Funktion Native Datenelemente von Tags , um das vorhandene Datenschichtformat einer Web-Seite in XDM umzuformatieren.
- 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:
- 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).
- 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.
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
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.
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.
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.
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.
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.
Wählen Sie das Quellensymbol (
Wählen Sie anschließend das Schemasymbol (
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.
[*]
ein.
Importieren vorhandener Zuordnungsregeln
Wenn Sie zuvor einen Datenstrom erstellt haben, können Sie seine konfigurierten Zuordnungsregeln für einen neuen Datenstrom wiederverwenden.
Wählen Sie zunächst Zuordnung importieren aus.
Wählen Sie im sich öffnenden Dialogfeld den Datenstrom aus, dessen Zuordnungsregeln Sie importieren möchten. Wählen Sie danach Vorschau aus.
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.
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.
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