Show Menu
THEMEN×

Vorbereiten von Daten zur Verwendung in Intelligent Services

Damit Sie Einblicke aus Ihren Marketing-Ereignisse-Daten Intelligent Services erhalten können, müssen die Daten semantisch erweitert und in einer Standardstruktur aufbewahrt werden. Intelligent Services nutzen Sie Experience Data Model (XDM) Schema, um dies zu erreichen. Insbesondere müssen alle in verwendeten Datensätze dem XDM-Schema Intelligent Services Consumer ExperienceEvent (CEE) ​entsprechen.
In diesem Dokument erhalten Sie allgemeine Anleitungen zur Zuordnung Ihrer Marketing-Ereignis-Daten aus mehreren Kanälen zu diesem Schema. In diesen Anleitungen werden Informationen zu wichtigen Feldern im Schema zusammengefasst, die Ihnen bei der Bestimmung helfen, wie Sie Ihre Daten effektiv der Struktur zuordnen können.

Workflow-Übersicht

Der Vorbereitungsprozess hängt davon ab, ob Ihre Daten in Adobe Experience Platform oder extern gespeichert werden. In diesem Abschnitt werden die notwendigen Schritte zusammengefasst, die Sie in beiden Szenarien unternehmen müssen.

Vorbereitung externer Daten

Wenn Ihre Daten außerhalb von gespeichert werden, führen Sie die folgenden Schritte aus Experience Platform:
  1. Wenden Sie sich an Adobe Consulting Services, um Zugangsdaten für einen dedizierten Azurblase Datenspeicherung Container anzufordern.
  2. Laden Sie Ihre Daten mit Ihren Zugriffsberechtigungen in den Blob-Container hoch.
  3. Arbeiten Sie mit Adobe Consulting Services, um Ihre Daten dem Consumer ExperienceEvent-Schema zuzuordnen und in Intelligent Serviceseinzubinden.

Experience Platform Datenaufbereitung

Wenn Ihre Daten bereits in gespeichert sind, führen Sie Platformdie folgenden Schritte aus:
  1. Überprüfen Sie die Struktur des Consumer ExperienceEvent-Schemas und stellen Sie fest, ob Ihre Daten Feldern zugeordnet werden können.
  2. Wenden Sie sich an Adobe Consulting Services, um Ihre Daten dem Schema zuzuordnen und sie zu erfassen, oder Intelligent Servicesbefolgen Sie die Schritte in diesem Handbuch Zuordnung und Erfassung von Daten , wenn Sie die Daten selbst zuordnen möchten.

Das CEE-Schema

Das Consumer ExperienceEvent-Schema beschreibt das Verhalten eines Individuums in Bezug auf digitale Marketing-Ereignis (Web oder Mobil) sowie Online- oder Offline-Commerce-Aktivitäten. Die Verwendung dieses Schemas ist Intelligent Services aufgrund seiner semantisch definierten Felder (Spalten) erforderlich, wobei unbekannte Namen vermieden werden, die sonst die Daten weniger eindeutig machen würden.
Das CEE-Schema erfasst wie alle XDM ExperienceEvent-Schema den zeitreihenbasierten Systemzustand, in dem ein Ereignis (oder eine Reihe von Ereignissen) aufgetreten ist, einschließlich des Zeitpunkts und der Identität des jeweiligen Objekts. Erfahrungs-Ereignisse sind Faktenberichte über das, was geschehen ist, und somit sind sie unveränderlich und stellen dar, was ohne Aggregation oder Interpretation passiert ist.
Intelligent Services Verwenden Sie mehrere Schlüsselfelder in diesem Schema, um Einblicke aus Ihren Marketing-Ereignissen-Daten zu generieren, die sich alle auf der Stammebene befinden und erweitert werden, um die erforderlichen Unterfelder anzuzeigen.
Wie alle XDM-Schema ist auch das CEE-Mixin erweiterbar. Mit anderen Worten, dem CEE-Mixin können zusätzliche Felder hinzugefügt werden, und bei Bedarf können verschiedene Varianten in mehreren Schemas enthalten sein.
Ein vollständiges Beispiel des Mixins finden Sie im öffentlichen XDM-Repository . Darüber hinaus können Sie die folgende JSON-Datei als Beispiel für die Strukturierung von Daten entsprechend dem CEE-Schema Ansicht und kopieren. In beiden Beispielen erfahren Sie mehr über die im folgenden Abschnitt beschriebenen Schlüsselfelder, um zu ermitteln, wie Sie dem Schema Ihre eigenen Daten zuordnen können.

Schlüsselfelder

Es gibt mehrere Schlüsselfelder innerhalb des CEE-Mixins, die genutzt werden sollten, um nützliche Einblicke Intelligent Services zu generieren. In diesem Abschnitt werden der Verwendungsfall und die erwarteten Daten für diese Felder beschrieben und Links zur Referenzdokumentation für weitere Beispiele bereitgestellt.

Obligatorische Felder

Die Verwendung aller Schlüsselfelder wird dringend empfohlen, es gibt jedoch zwei Felder, die erforderlich sind, Intelligent Services um zu funktionieren:

Primär

Eines der Felder in Ihrem Schema muss als primäres Identitätsfeld festgelegt werden, mit dem jede Instanz von Zeitreihendaten mit einer Einzelperson verknüpft werden Intelligent Services kann.
Sie müssen das beste Feld als primäre Identität basierend auf der Quelle und der Art Ihrer Daten festlegen. Ein Identitätsfeld muss einen Identitäts-Namensraum enthalten, der den Typ der Identitätsdaten angibt, den das Feld als Wert erwartet. Zu den gültigen Namensräumen gehören:
  • "email"
  • "phone"
  • "mcid"(für Adobe Audience Manager-IDs)
  • "aaid"(für Adobe Analytics-IDs)
Wenn Sie sich nicht sicher sind, welches Feld Sie als primäre Identität verwenden sollten, wenden Sie sich an Adobe Consulting Services, um die beste Lösung zu finden.

xdm:timestamp

Dieses Feld gibt den Zeitpunkt an, zu dem das Ereignis aufgetreten ist. Dieser Wert muss als Zeichenfolge gemäß ISO 8601 angegeben werden.

xdm:channel

Dieses Feld ist nur bei Verwendung von Attribution AI obligatorisch.
Dieses Feld stellt den Marketing-Kanal im Zusammenhang mit dem ExperienceEvent dar. Das Feld enthält Informationen zum Typ des Kanals, Medientyp und Standort.
Beispiel-Schema
{
  "@id": "https://ns.adobe.com/xdm/channels/facebook-feed",
  "@type": "https://ns.adobe.com/xdm/channel-types/social",
  "xdm:mediaType": "earned",
  "xdm:mediaAction": "clicks"
}

Vollständige Informationen zu den einzelnen erforderlichen Unterfeldern xdm:channel finden Sie in der Experience Kanal Schema -Spezifikation. Beispielzuordnungen finden Sie in der Tabelle unten .
Beispielzuordnungen für Kanal
Die folgende Tabelle enthält einige Beispiele für Marketing-Kanal, die dem xdm:channel Schema zugeordnet sind:
Channel
@type
mediaType
mediaAction
Paid Search
https:/ /ns.adobe.com/xdm/Kanal-types/search
bezahlt
clicks
Social - Marketing
https:/ /ns.adobe.com/xdm/Kanal-types/social
verdient
clicks
Anzeigen
https:/ /ns.adobe.com/xdm/Kanal-types/display
bezahlt
clicks
E-Mail
https:/ /ns.adobe.com/xdm/Kanal-types/email
bezahlt
clicks
Interner Werber
https:/ /ns.adobe.com/xdm/Kanal-types/direct
besetzt
clicks
Display ViewThrough
https:/ /ns.adobe.com/xdm/Kanal-types/display
bezahlt
impressions
QR-Codeumleitung
https:/ /ns.adobe.com/xdm/Kanal-types/direct
besetzt
clicks
Mobile
https:/ /ns.adobe.com/xdm/Kanal-types/mobile
besetzt
clicks

Empfohlene Felder

Die übrigen Schlüsselfelder werden in diesem Abschnitt beschrieben. Diese Felder sind zwar nicht unbedingt erforderlich, um zu funktionieren, es wird jedoch dringend empfohlen, möglichst viele davon zu verwenden, um tiefer gehende Einblicke zu erhalten. Intelligent Services

xdm:productListItems

Dieses Feld enthält eine Reihe von Artikeln, die die von einem Kunden ausgewählten Produkte darstellen, einschließlich der Produkt-SKU, des Namens, des Preises und der Menge.
Beispiel-Schema
[
  {
    "xdm:SKU": "1002352692",
    "xdm:name": "24-Watt 8-Light Chrome Integrated LED Bath Light",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 159.45
  },
  {
    "xdm:SKU": "3398033623",
    "xdm:name": "16ft RGB LED Strips",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 79.99
  }
]

Vollständige Informationen zu den einzelnen erforderlichen Unterfeldern xdm:productListItems finden Sie in der Commerce-Details-Schema -Spezifikation.

xdm:commerce

Dieses Feld enthält handelsspezifische Informationen zum ExperienceEvent, einschließlich Bestellnummer und Zahlungsinformationen.
Beispiel-Schema
{
    "xdm:order": {
      "xdm:purchaseID": "a8g784hjq1mnp3",
      "xdm:purchaseOrderNumber": "123456",
      "xdm:payments": [
        {
          "xdm:transactionID": "transactid-a111",
          "xdm:paymentAmount": 59,
          "xdm:paymentType": "credit_card",
          "xdm:currencyCode": "USD"
        },
        {
          "xdm:transactionId": "transactid-a222",
          "xdm:paymentAmount": 100,
          "xdm:paymentType": "gift_card",
          "xdm:currencyCode": "USD"
        }
      ],
      "xdm:currencyCode": "USD",
      "xdm:priceTotal": 159
    },
    "xdm:purchases": {
      "xdm:value": 1
    }
  }

Vollständige Informationen zu den einzelnen erforderlichen Unterfeldern xdm:commerce finden Sie in der Commerce-Details-Schema -Spezifikation.

xdm:web

Dieses Feld enthält Webdetails zum ExperienceEvent, wie Interaktion, Seitendetails und Werber.
Beispiel-Schema
{
  "xdm:webPageDetails": {
    "xdm:siteSection": "Shopping Cart",
    "xdm:server": "example.com",
    "xdm:name": "Purchase Confirmation",
    "xdm:URL": "https://www.example.com/orderConf",
    "xdm:errorPage": false,
    "xdm:homePage": false,
    "xdm:pageViews": {
      "xdm:value": 1
    }
  },
  "xdm:webReferrer": {
    "xdm:URL": "https://www.example.com/checkout",
    "xdm:referrerType": "internal"
  }
}

Vollständige Informationen zu den einzelnen erforderlichen Unterfeldern xdm:productListItems finden Sie in der Spezifikation des ExperienceEvent-Webdetails-Schemas .

xdm:marketing

Dieses Feld enthält Informationen zu Marketing-Aktivitäten, die mit dem Touchpoint aktiv sind.
Beispiel-Schema
{
  "xdm:trackingCode": "marketingcampaign111",
  "xdm:campaignGroup": "50%_DISCOUNT",
  "xdm:campaignName": "50%_DISCOUNT_USA"
}

Vollständige Informationen zu jedem der erforderlichen Unterfelder finden Sie xdm:productListItems in der Marketing-Sechsfachspezifikation .

Zuordnung und Erfassung von Daten

Sobald Sie festgestellt haben, ob Ihre Marketing-Ereignis-Daten dem CEE-Schema zugeordnet werden können, müssen Sie als Nächstes ermitteln, welche Daten Sie in dieses einbeziehen Intelligent Services. Alle in verwendeten Verlaufsdaten Intelligent Services müssen innerhalb des Mindestzeitraums von vier Monaten an Daten liegen, zuzüglich der Anzahl der Tage, die als Lookback-Zeitraum gedacht sind.
Wenden Sie sich nach der Entscheidung über den zu sendenden Datenbereich an Adobe Consulting Services, um Ihre Daten dem Schema zuzuordnen und sie in den Dienst zu integrieren.
Wenn Sie ein Adobe Experience Platform Abonnement haben und die Daten selbst zuordnen und erfassen möchten, führen Sie die im folgenden Abschnitt beschriebenen Schritte aus.

Verwenden von Adobe Experience Platform

Die folgenden Schritte erfordern ein Abonnement zur Experience Platform. Wenn Sie keinen Zugriff auf die Plattform haben, fahren Sie mit dem Abschnitt Nächste Schritte fort.
In diesem Abschnitt wird der Arbeitsablauf für die Zuordnung und Einbindung von Daten in die Experience Platform zur Verwendung in Intelligent Serviceserläutert, einschließlich Links zu Schulungen für detaillierte Schritte.

Erstellen eines CEE-Schemas und eines Datasets

Wenn Sie bereit sind, Ihre Daten für die Erfassung vorzubereiten, müssen Sie zunächst ein neues XDM-Schema erstellen, das das CEE-Mixin verwendet. Die folgenden Lernprogramme erläutern die Erstellung eines neuen Schemas in der Benutzeroberfläche oder API:
Die oben stehenden Lernprogramme folgen einem allgemeinen Arbeitsablauf zum Erstellen eines Schemas. Bei der Auswahl einer Klasse für das Schema müssen Sie die XDM ExperienceEvent-Klasse verwenden. Nachdem diese Klasse ausgewählt wurde, können Sie das CEE-Mixin dem Schema hinzufügen.
Nachdem Sie das CEE-Mixin zum Schema hinzugefügt haben, können Sie je nach Bedarf weitere Mixins in Ihre Daten einfügen.
Nachdem Sie das Schema erstellt und gespeichert haben, können Sie auf der Grundlage dieses Schemas einen neuen Datensatz erstellen. Die folgenden Lernprogramme erläutern den Vorgang zum Erstellen eines neuen Datensatzes in der Benutzeroberfläche oder API:
Nachdem der Datensatz erstellt wurde, können Sie ihn in der Benutzeroberfläche "Plattform"im Arbeitsbereich " Datensätze "finden.

hinzufügen eines primären Identitäts-Namensraum-Tags zum Dataset

In zukünftigen Versionen von Intelligent Services wird der Adobe Experience Platform Identity Service in die Kundenidentifizierungsfunktionen integriert. Die unten aufgeführten Schritte können sich daher ändern.
Wenn Sie Daten aus Adobe Audience Manager, Adobe Analyticsoder einer anderen externen Quelle einreichen, müssen Sie dem Datensatz ein primaryIdentityNameSpace -Tag hinzufügen. Dies kann durch eine PATCH-Anforderung an die Katalogdienst-API erfolgen.
Wenn Sie Daten aus einer lokalen CSV-Datei aufnehmen, können Sie den nächsten Abschnitt über die Zuordnung und Erfassung von Daten überspringen.
Bevor Sie dem Beispiel-API-Aufruf unten folgen, finden Sie im Abschnitt " Erste Schritte"im Katalog-Entwicklerhandbuch wichtige Informationen zu den erforderlichen Kopfzeilen.
API-Format
PATCH /dataSets/{DATASET_ID}

Parameter
Beschreibung
{DATASET_ID}
Die ID des zuvor erstellten Datensatzes.
Anfrage
Je nachdem, aus welcher Quelle Sie Daten abrufen, müssen Sie entsprechende primaryIdentityNamespace und sourceConnectorId Tag-Werte in der Anforderungsnutzlast angeben.
Die folgende Anforderung fügt die entsprechenden Tag-Werte für Audience Manager hinzu:
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["mcid"],
          "sourceConnectorId": ["audiencemanager"],
        }
      }'

Die folgende Anforderung fügt die entsprechenden Tag-Werte für Analytics hinzu:
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["aaid"],
          "sourceConnectorId": ["analytics"],
        }
      }'

Weitere Informationen zum Arbeiten mit Identitäts-Namensräumen in Platform finden Sie in der Übersicht über den Identitäts-Namensraum .
Antwort
Eine erfolgreiche Antwort gibt ein Array zurück, das die ID des aktualisierten Datensatzes enthält. Diese ID sollte mit der in der PATCH-Anfrage gesendeten ID übereinstimmen.
[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

Daten zuordnen und erfassen

Nachdem Sie ein CEE-Schema und einen Dataset erstellt haben, können Sie Ihre Datentabellen dem Schema zuordnen und diese Daten in Platform erfassen. Anweisungen dazu, wie Sie dies in der Benutzeroberfläche durchführen, finden Sie im Lernprogramm zum Zuordnen einer CSV-Datei zu einem XDM-Schema . Sie können die folgende JSON- Beispieldatei verwenden, um den Erfassungsvorgang zu testen, bevor Sie Ihre eigenen Daten verwenden.
Nachdem ein Datensatz gefüllt wurde, kann derselbe Datensatz zum Erfassen zusätzlicher Datendateien verwendet werden.
Wenn Ihre Daten in einer unterstützten Drittanbieteranwendung gespeichert werden, können Sie auch einen Quellanschluss erstellen, um Ihre Marketing-Ereignis-Daten in Echtzeit zu erfassen Platform .

Nächste Schritte

Dieses Dokument enthielt allgemeine Leitlinien zur Vorbereitung Ihrer Daten für die Verwendung in Intelligent Services. Wenn Sie je nach Anwendungsfall weitere Beratung benötigen, wenden Sie sich bitte an den Adobe Consulting Support.
Nachdem Sie einen Datensatz mit Ihren Kundenerlebnisdaten ausgefüllt haben, können Sie Intelligent Services Einblicke generieren. Die ersten Schritte finden Sie in den folgenden Dokumenten: