Dokumentation Experience Platform Anleitung zu Quell-Connectoren

Beta

Erstellen einer Merkury Enterprise Identity Resolution Quellverbindung und eines Datenflusses in der Benutzeroberfläche

Letzte Aktualisierung: 5. Mai 2025

Themen:

Erstellt für:

Entwickler

HINWEIS

Die Merkury Enterprise Identity Resolution-Quelle befindet sich in der Beta-Phase. Weitere Informationen zur Verwendung von Betagekennzeichneten Quellen finden Sie„Quellen - Übersicht“.

In diesem Tutorial werden Schritte zum Erstellen einer Merkury Enterprise Identity Resolution Quellverbindung und eines Datenflusses mithilfe der Adobe Experience Platform-Benutzeroberfläche beschrieben.

Erste Schritte

Dieses Tutorial setzt ein Grundverständnis der folgenden Komponenten von Experience Platform voraus:

Experience Data Model (XDM) System: Das standardisierte Framework, mit dem Experience Platform Kundenerlebnisdaten organisiert.
- Grundlagen der Schemakomposition: Machen Sie sich mit den grundlegenden Bausteinen von XDM-Schemata vertraut, einschließlich der wichtigsten Prinzipien und Best Practices bei der Schemaerstellung.
- Tutorial zum Schema-Editor: Erfahren Sie, wie Sie benutzerdefinierte Schemata mithilfe der Benutzeroberfläche des Schema-Editors erstellen können.
Real-Time Customer Profile: Bietet ein einheitliches Echtzeit-Kundenprofil, das auf aggregierten Daten aus verschiedenen Quellen basiert.

Sammeln erforderlicher Anmeldedaten

Um auf Ihren Bucket in Experience Platform zuzugreifen, müssen Sie gültige Werte für die folgenden Anmeldeinformationen angeben:

Anmeldedaten	Beschreibung
Zugriffsschlüssel	Die Zugriffsschlüssel-ID für Ihren Bucket. Sie können diesen Wert von Ihrem Merkury-Team abrufen.
Geheimer Schlüssel	Die geheime Schlüssel-ID für Ihren Bucket. Sie können diesen Wert von Ihrem Merkury-Team abrufen.
Behältername	Dies ist Ihr Merkury Bucket, in dem Dateien freigegeben werden. Sie können diesen Wert von Ihrem Merkury-Team abrufen.

Weitere Informationen zum Einrichten für Merkury und zu anderen Voraussetzungen finden Sie unter Merkury Quelle - Übersicht.

Verbinden Ihres Merkury-Kontos

Wählen Sie in der Experience Platform-Benutzeroberfläche Quellen in der linken Navigationsleiste aus, um auf den Arbeitsbereich Quellen zuzugreifen. Der Bildschirm Katalog zeigt eine Vielzahl von Quellen an, mit denen Sie ein Konto erstellen können.

Sie können die gewünschte Kategorie aus dem Katalog auf der linken Bildschirmseite auswählen. Alternativ können Sie die gewünschte Quelle mithilfe der Suchoption finden.

Wählen Sie unter der Datenpartner die Option Merkury und dann Einrichten.

Der Quellkatalog mit der ausgewählten Merkury-Quelle.

Die Verbindung zu Merkury herstellen wird angezeigt. Auf dieser Seite können Sie entweder neue oder vorhandene Anmeldedaten verwenden.

Neues Konto erstellen

Wenn Sie neue Anmeldeinformationen verwenden, wählen Sie Neues Konto aus. Geben Sie im angezeigten Eingabeformular einen Namen, eine optionale Beschreibung und Ihre Merkury Anmeldeinformationen ein. Wenn Sie fertig sind, wählen Mit Quelle verbinden und warten Sie dann einige Zeit, bis die neue Verbindung hergestellt ist.

Die neue Account-Oberfläche für Merkury.

Vorhandenes Konto verwenden

Um ein vorhandenes Konto zu verwenden, wählen Sie Vorhandenes Konto und dann das Merkury Konto aus, das Sie verwenden möchten. Klicken Sie auf Weiter, um fortzufahren.

Die vorhandene Account-Schnittstelle für Merkury.

Unterstützte Dateiformate

Sie können die folgenden Dateiformate mit der Merkury aufnehmen:

Durch Trennzeichen getrennte Werte (DSV): Jeder einzelne Zeichenwert kann als Trennzeichen für DSV-formatierte Datendateien verwendet werden.
JavaScript Object Notation (JSON): Datendateien im JSON-Format müssen XDM-kompatibel sein.
Apache Parquet: Datendateien im Parquet-Format müssen XDM-kompatibel sein.
Komprimierte Dateien: JSON- und durch Trennzeichen getrennte Dateien können wie folgt komprimiert werden: bzip2, gzip, deflate, zipDeflate, tarGzip und tar.

Daten hinzufügen

Nach der Erstellung Ihres Merkury Kontos wird der Schritt Daten hinzufügen angezeigt, in dem Sie Ihre Merkury Dateihierarchie untersuchen und den Ordner oder die spezifische Datei auswählen können, die Sie in Experience Platform importieren möchten.

Der linke Teil der Benutzeroberfläche ist ein Verzeichnis-Browser, der die Merkury-Dateihierarchie anzeigt.
Im rechten Bereich der Benutzeroberfläche können Sie bis zu 100 Datenzeilen aus einem kompatiblen Ordner oder einer kompatiblen Datei in der Vorschau anzeigen.

Die Datei und der Ordner des Quell-Workflows, in dem Sie die aufzunehmenden Daten auswählen können.

Wählen Sie den Stammordner aus, um auf Ihre Ordnerhierarchie zuzugreifen. Von hier aus können Sie einen einzelnen Ordner auswählen, um alle Dateien im Ordner rekursiv aufzunehmen. Beim Aufnehmen eines ganzen Ordners müssen Sie sicherstellen, dass alle Dateien in diesem Ordner dasselbe Datenformat und Schema haben.

Nachdem Sie einen Ordner ausgewählt haben, wird die rechte Benutzeroberfläche aktualisiert, um eine Vorschau des Inhalts und der Struktur der ersten Datei im ausgewählten Ordner anzuzeigen.

Die für die Aufnahme und die Dateivorschau ausgewählten Daten.

In diesem Schritt können Sie mehrere Konfigurationen an Ihren Daten vornehmen, bevor Sie fortfahren. Wählen Sie zunächst Datenformat und wählen Sie dann im angezeigten Dropdown-Menü das entsprechende Datenformat für Ihre Datei aus.

In der folgenden Tabelle werden die entsprechenden Datenformate für die unterstützten Dateitypen angezeigt:

Dateityp	Datenformat
CSV	Getrennt
JSON	JSON
Parquet	XDM Parquet

Spaltentrennzeichen auswählen

Auswählen, um die Schritte zum Festlegen eines Trennzeichens anzuzeigen

Nachdem Sie Ihr Datenformat konfiguriert haben, können Sie bei der Aufnahme von durch Trennzeichen getrennten Dateien ein Spaltentrennzeichen festlegen. Wählen Sie die Option Trennzeichen und wählen Sie dann ein Trennzeichen aus dem Dropdown-Menü aus. Das Menü zeigt die am häufigsten verwendeten Optionen für Trennzeichen an, einschließlich eines Kommas (,), eines Tabs (\t) und eines senkrechten Strichs (|).

Wenn Sie ein benutzerdefiniertes Trennzeichen bevorzugen, wählen Sie Benutzerdefiniert und geben Sie ein einzelnes Trennzeichen Ihrer Wahl in die Popup-Eingabeleiste ein.

Komprimierte Dateien aufnehmen

Wählen Sie aus, um die Schritte zur Aufnahme komprimierter Dateien anzuzeigen

Sie können auch komprimierte JSON- oder durch Trennzeichen getrennte Dateien erfassen, indem Sie ihren Komprimierungstyp angeben.

Wählen im Schritt Daten auswählen“ eine komprimierte Datei für die Aufnahme und dann den entsprechenden Dateityp aus und geben Sie an, ob er XDM-kompatibel ist oder nicht. Wählen Sie anschließend Komprimierungstyp und wählen Sie dann den entsprechenden komprimierten Dateityp für Ihre Quelldaten aus.

Um eine bestimmte Datei in Experience Platform aufzunehmen, wählen Sie einen Ordner und dann die Datei aus, die Sie aufnehmen möchten. In diesem Schritt können Sie auch eine Vorschau des Dateiinhalts anderer Dateien in einem bestimmten Ordner anzeigen, indem Sie das Vorschausymbol neben einem Dateinamen verwenden.

Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Weiter.

Angeben von Datenflussdetails

Auf der Seite Datenflussdetails können Sie auswählen, ob Sie einen vorhandenen Datensatz oder einen neuen Datensatz verwenden möchten. Während dieses Vorgangs können Sie auch Ihre Daten für die Aufnahme in Profile konfigurieren und Einstellungen wie Fehlerdiagnose, Partielle Aufnahme und Warnhinweise aktivieren.

Verwenden eines vorhandenen Datensatzes

Um Daten in einen vorhandenen Datensatz aufzunehmen, wählen Sie Vorhandener Datensatz. Sie können einen vorhandenen Datensatz entweder über die Option Erweiterte Suche oder durch Scrollen durch die Liste der vorhandenen Datensätze im Dropdown-Menü abrufen. Nachdem Sie einen Datensatz ausgewählt haben, geben Sie einen Namen und eine Beschreibung für Ihren Datenfluss ein.

Die vorhandene Datensatzschnittstelle.

Verwenden eines neuen Datensatzes

Für ein Aufnehmen in einen neuen Datensatz wählen Sie Neuer Datensatz aus und geben Sie einen Namen für den Ausgabedatensatz und eine optionale Beschreibung an. Wählen Sie als Nächstes mithilfe der Option Erweiterte Suche oder durch Scrollen durch die Liste der vorhandenen Schemata im Dropdown-Menü ein Schema zum Zuordnen aus. Nachdem Sie ein Schema ausgewählt haben, geben Sie einen Namen und eine Beschreibung für Ihren Datenfluss ein.

Die neue Datensatzschnittstelle.

Profil- und Fehlerdiagnose aktivieren

Wählen Sie aus, um die Schritte zur Aktivierung der Fehlerdiagnose und Profilaufnahme anzuzeigen.

Wählen Sie als Nächstes den Profildatensatz aus, um Ihren Datensatz für das Echtzeit-Kundenprofil zu aktivieren. Auf diese Weise können Sie eine ganzheitliche Ansicht der Attribute und Verhaltensweisen einer Entität erstellen. Daten aus allen profilaktivierten Datensätzen werden in das Profil eingeschlossen und Änderungen werden angewendet, wenn Sie Ihren Datenfluss speichern.

Fehlerdiagnose ermöglicht eine detaillierte Erstellung von Fehlermeldungen für alle fehlerhaften Datensätze, die in Ihrem Datenfluss auftreten, während Partielle Aufnahme die Aufnahme von fehlerhaften Daten bis zu einem gewissen Schwellenwert, den Sie manuell definieren, ermöglicht. Weitere Informationen finden Sie in der Übersicht zur partiellen Batch-Aufnahme.

Aktivieren von Warnhinweisen

Auswählen, um die Schritte zum Aktivieren von Warnhinweisen anzuzeigen

Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status Ihres Datenflusses zu erhalten. Wählen Sie einen Warnhinweis aus der zu abonnierenden Liste aus, um Benachrichtigungen über den Status Ihres Datenflusses zu erhalten. Weitere Informationen zu Warnhinweisen finden Sie im Handbuch zum Abonnieren von Warnhinweisen zu Quellen über die Benutzeroberfläche.

Wenn Sie mit dem Eingeben der Details für Ihren Datenfluss fertig sind, klicken Sie auf Weiter.

Zuordnen von Datenfeldern zu einem XDM-Schema

Es erfolgt der Schritt der Zuordnung, in dem Ihnen eine Schnittstelle zum Zuordnen der Quellfelder aus Ihrem Quellschema zu den entsprechenden XDM-Zielfeldern im Zielschema bereitgestellt wird.

Experience Platform bietet intelligente Empfehlungen für automatisch zugeordnete Felder, die auf dem ausgewählten Zielschema oder Datensatz basieren. Sie können die Zuordnungsregeln manuell an Ihre Anwendungsfälle anpassen. Je nach Bedarf können Sie wahlweise Felder direkt zuordnen oder mithilfe von Datenvorbereitungsfunktionen Quelldaten transformieren, um berechnete oder anderweitig ermittelte Werte abzuleiten. Eine ausführliche Anleitung zur Verwendung der Zuordnungsschnittstelle und berechneter Felder finden Sie im Handbuch zur Datenvorbereitungs-Benutzeroberfläche.

Nachdem Ihre Quelldaten erfolgreich zugeordnet wurden, klicken Sie auf Weiter.

Die Zuordnungsschnittstelle.

Planen von Aufnahmedurchgängen

Der Schritt Planung wird angezeigt, in dem Sie einen Aufnahmezeitplan konfigurieren können, um die ausgewählten Quelldaten mithilfe der konfigurierten Zuordnungen automatisch aufzunehmen. Standardmäßig ist die Zeitplanung auf Once festgelegt. Um Ihre Aufnahmefrequenz anzupassen, wählen Sie Häufigkeit und dann eine Option aus dem Dropdown-Menü aus.

TIP

Intervall und Aufstockung sind während einer einmaligen Aufnahme nicht sichtbar.

Die Zeitplanungs-Oberfläche

Wenn Sie die Aufnahmefrequenz auf Minute, Hour, Day oder Week festlegen, müssen Sie ein Intervall festlegen, um zwischen den einzelnen Aufnahmen einen bestimmten Zeitrahmen festzulegen. Wenn beispielsweise die Aufnahmefrequenz auf Day und das Intervall auf 15 festgelegt ist, bedeutet dies, dass der Datenfluss alle 15 Tage Daten aufnehmen soll.

In diesem Schritt können Sie auch Aufstockung“ aktivieren eine Spalte für die inkrementelle Aufnahme von Daten definieren. Die Aufstockung wird verwendet, um historische Daten aufzunehmen, während die Spalte, die Sie für die inkrementelle Aufnahme definieren, es ermöglicht, neue Daten von vorhandenen Daten zu unterscheiden.

Weitere Informationen zur Planung von Konfigurationen finden Sie in der folgenden Tabelle.

Konfiguration planen

Beschreibung

Häufigkeit

Konfigurieren Sie die Häufigkeit , um anzugeben, wie oft der Datenfluss ausgeführt werden soll. Sie können Ihre Häufigkeit auf Folgendes festlegen:

Einmal: Legen Sie für die Häufigkeit once fest, um eine einmalige Aufnahme zu erstellen. Konfigurationen für Intervall und Aufstockung sind beim Erstellen eines einmaligen Aufnahme-Datenflusses nicht verfügbar. Standardmäßig ist die Zeitplanfrequenz auf einmal festgelegt.
Minute: Legen Sie für die Häufigkeit minute fest, um Ihren Datenfluss so zu planen, dass Daten pro Minute aufgenommen werden.
Stunde: Legen Sie für die Häufigkeit hour fest, um den Datenfluss zu planen und Daten stündlich aufzunehmen.
Tag: Legen Sie für Ihre Häufigkeit day fest, um Ihren Datenfluss so zu planen, dass Daten täglich aufgenommen werden.
Woche: Legen Sie für Ihre Häufigkeit week fest, um Ihren Datenfluss zu planen und Daten pro Woche aufzunehmen.

Intervall

Nachdem Sie eine Häufigkeit ausgewählt haben, können Sie die Intervalleinstellung konfigurieren, um den Zeitrahmen zwischen jeder Aufnahme festzulegen. Wenn Sie beispielsweise Ihre Häufigkeit auf „Tag“ festlegen und das Intervall auf 15 konfigurieren, wird Ihr Datenfluss alle 15 Tage ausgeführt. Das Intervall kann nicht auf null festgelegt werden. Der akzeptierte Mindestintervallwert für jede Häufigkeit ist wie folgt:

Einmal: nicht zutreffend
Minute: 15
Stunde: 1
Tag: 1
Woche: 1

Startzeit

Der Zeitstempel für die projizierte Ausführung, dargestellt in UTC-Zeitzone.

Aufstockung

Die Aufstockung bestimmt, welche Daten anfänglich aufgenommen werden. Wenn die Aufstockung aktiviert ist, werden alle aktuellen Dateien im angegebenen Pfad während der ersten geplanten Aufnahme aufgenommen. Wenn die Aufstockung deaktiviert ist, werden nur die Dateien aufgenommen, die zwischen der ersten Aufnahme-Ausführung und der Startzeit geladen werden. Dateien, die vor der Startzeit geladen wurden, werden nicht aufgenommen.

NOTE

Bei der Batch-Aufnahme wählt jeder nachfolgende Datenfluss die aufzunehmenden Dateien aus Ihrer Quelle anhand ihres zuletzt geänderten Zeitstempels aus. Das bedeutet, dass Batch-Datenflüsse Dateien aus der Quelle auswählen, die neu sind oder seit der letzten Ausführung des Flusses geändert wurden. Darüber hinaus müssen Sie sicherstellen, dass zwischen dem Hochladen einer Datei und der Ausführung eines geplanten Flusses eine ausreichende Zeitspanne liegt, da Dateien, die nicht vollständig in Ihr Cloud-Speicherkonto hochgeladen wurden, bevor die geplante Laufzeit des Flusses zur Aufnahme möglicherweise nicht abgerufen wird.

Wenn Sie mit der Konfiguration Ihres Aufnahmezeitplans fertig sind, klicken Sie auf Weiter.

Überprüfen des Datenflusses

Der Schritt Überprüfung wird angezeigt, sodass Sie Ihren neuen Datenfluss überprüfen können, bevor er hergestellt wird. Die Details lassen sich wie folgt kategorisieren:

Verbindung: Zeigt den Quelltyp, den relevanten Pfad der ausgewählten Quelldatei und die Anzahl der Spalten innerhalb dieser Quelldatei an.
Datensatz- und Zuordnungsfelder zuweisen: Zeigt an, in welchen Datensatz die Quelldaten aufgenommen werden, einschließlich des Schemas, dem der Datensatz entspricht.
Planung: Zeigt den aktiven Zeitraum, die Häufigkeit und das Intervall des Aufnahmezeitplans an.

Nachdem Sie Ihren Datenfluss überprüft haben, klicken Sie auf Beenden und gewähren Sie etwas Zeit für die Erstellung des Datenflusses.

Die Überprüfungsseite.

Nächste Schritte

In diesem Tutorial haben Sie erfolgreich einen Datenfluss erstellt, um Batch-Daten aus Ihrer Merkury in Experience Platform zu übertragen. Weitere Ressourcen finden Sie in der unten beschriebenen Dokumentation.

Überwachen Ihres Datenflusses

Nachdem Ihr Datenfluss erstellt wurde, können Sie die Daten überwachen, die über ihn aufgenommen werden, um Informationen zu Aufnahmegeschwindigkeiten, Erfolg und Fehlern anzuzeigen. Weitere Informationen zum Überwachen von Datenflüssen finden Sie im Tutorial Überwachen von Konten und Datenflüssen in der Benutzeroberfläche.

Aktualisieren des Datenflusses

Um Konfigurationen für die Planung, Zuordnung und allgemeine Informationen Ihrer Datenflüsse zu aktualisieren, besuchen Sie das Tutorial Aktualisieren von Quelldatenflüssen in der Benutzeroberfläche

Löschen des Datenflusses

Datenflüsse, die nicht mehr erforderlich sind oder nicht korrekt erstellt wurden, können Sie löschen, indem Sie dazu die Funktion Löschen im Arbeitsbereich Datenflüsse verwenden. Weitere Informationen zum Löschen von Datenflüssen finden Sie im Tutorial Löschen von Datenflüssen in der Benutzeroberfläche.