Exportieren von Datensätzen zu Cloud-Speicher-Zielen

AVAILABILITY
  • Diese Funktion steht Kunden zur Verfügung, die das Real-Time CDP Prime- oder Ultimate-Paket, Adobe Journey Optimizer oder Customer Journey Analytics erworben haben. Weitere Informationen erhalten Sie von Ihrem Adobe-Support-Mitarbeiter.

In diesem Artikel wird der Workflow erläutert, der zum Exportieren Datensätze von Adobe Experience Platform an Ihren bevorzugten Cloud-Speicherort, z. B. Amazon S3, SFTP-Speicherorte oder Google Cloud Storage, mithilfe der Experience Platform-Benutzeroberfläche erforderlich ist.

Sie können auch die Experience Platform-APIs zum Exportieren von Datensätzen verwenden. Weitere Informationen finden im TutorialExportieren von Datensätzen .

Datensätze, die exportiert werden können datasets-to-export

Die Datensätze, die Sie exportieren können, variieren je nach Experience Platform-Anwendung (Real-Time CDP, Adobe Journey Optimizer), Ebene (Prime oder Ultimate) und Add-ons, die Sie erworben haben (z. B. Data Distiller).

In der folgenden Tabelle erfahren Sie, welche Datensatztypen Sie je nach Programm, Produktstufe und erworbenen Add-ons exportieren können:

Anwendung/Add-on
Stufe
Für den Export verfügbare Datensätze
Real-Time CDP
Prime
Profil- und Erlebnisereignis-Datensätze, die in der Experience Platform-Benutzeroberfläche nach der Aufnahme oder Erfassung von Daten über Quellen, Web SDK, Mobile SDK, Analytics Data Connector und Audience Manager erstellt wurden.
Ultimate
  • Profil- und Erlebnisereignis-Datensätze, die in der Experience Platform-Benutzeroberfläche nach der Aufnahme oder Erfassung von Daten über Quellen, Web SDK, Mobile SDK, Analytics Data Connector und Audience Manager erstellt wurden.
  • Systemgenerierter Profil-Snapshot-Datensatz.
Adobe Journey Optimizer
Prime
Weitere Informationen finden Sie in der DokumentationAdobe Journey Optimizer.
Ultimate
Weitere Informationen finden Sie in der DokumentationAdobe Journey Optimizer.
Customer Journey Analytics
Alle
Profil- und Erlebnisereignis-Datensätze, die in der Experience Platform-Benutzeroberfläche nach der Aufnahme oder Erfassung von Daten über Quellen, Web SDK, Mobile SDK, Analytics Data Connector und Audience Manager erstellt wurden.
Data Distiller
Data Distiller (Add-on)
Abgeleitete Datensätze, die über den Abfrage-Service erstellt wurden.

Video-Tutorial video-tutorial

Sehen Sie sich das folgende Video an, um eine End-to-End-Erklärung des auf dieser Seite beschriebenen Workflows, die Vorteile der Verwendung der Funktion „Datensatz exportieren“ und einige vorgeschlagene Anwendungsfälle zu erhalten.

Unterstützte Ziele supported-destinations

Derzeit können Sie Datensätze in die Cloud-Speicher-Ziele exportieren, die im Screenshot hervorgehoben und unten aufgeführt sind.

Zielkatalogseite, die zeigt, welche Ziele Datensatzexporte unterstützen.

Wann Zielgruppen aktiviert oder Datensätze exportiert werden sollten when-to-activate-audiences-or-activate-datasets

Einige dateibasierte Ziele im Experience Platform-Katalog unterstützen sowohl die Zielgruppenaktivierung als auch den Datensatzexport.

  • Erwägen Sie die Aktivierung von Zielgruppen, wenn Ihre Daten in Profilen gruppiert nach Zielgruppeninteressen oder Qualifikationen strukturiert sein sollen.
  • Alternativ können Sie Datensatzexporte in Betracht ziehen, wenn Sie Rohdatensätze exportieren möchten, die nicht nach Zielgruppeninteressen oder Qualifikationen gruppiert oder strukturiert sind. Sie können diese Daten für Berichte, Datenwissenschafts-Workflows und viele andere Anwendungsfälle verwenden. Als Administrator, Datentechniker oder Analyst können Sie beispielsweise Daten von Experience Platform exportieren, um sie mit Ihrem Data Warehouse zu synchronisieren, in BI-Analyse-Tools oder externen Cloud-ML-Tools verwenden oder in Ihrem System für langfristige Speicheranforderungen speichern.

Dieses Dokument enthält alle Informationen, die zum Exportieren von Datensätzen erforderlich sind. Wenn Sie „Zielgruppen für Cloud Speicher- oder E-Mail-Marketing-Ziele aktivieren möchten, lesen Sie Aktivieren von Zielgruppendaten für Batch-Profil-Exportziele.

Voraussetzungen prerequisites

Um Datensätze in Cloud-Speicher-Ziele zu exportieren, müssen Sie erfolgreich eine Verbindung mit einem Ziel hergestellt haben. Wenn Sie es noch nicht getan haben, navigieren Sie zum Zielkatalog, durchsuchen Sie die unterstützten Ziele und konfigurieren Sie das Ziel, das Sie verwenden möchten.

Erforderliche Berechtigungen permissions

Zum Exportieren von Datensätzen benötigen Sie die Berechtigungen Ziele anzeigen, Datensätze anzeigen und Datensatzziele verwalten und aktivieren Zugriffssteuerungsberechtigungen. Lesen Sie die Übersicht über die Zugriffskontrolle oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.

Um sicherzustellen, dass Sie über die erforderlichen Berechtigungen zum Exportieren von Datensätzen verfügen und dass das Ziel den Export von Datensätzen unterstützt, durchsuchen Sie den Zielkatalog. Wenn ein Ziel über die Steuerung Aktivieren oder Datensätze exportieren verfügt, dann haben Sie die entsprechenden Berechtigungen.

Auswählen des Ziels select-destination

Befolgen Sie die Anweisungen zum Auswählen eines Ziels, an das Sie Ihre Datensätze exportieren können:

  1. Navigieren Sie zu Verbindungen > Ziele und wählen Sie die Registerkarte Katalog.

    Registerkarte „Zielkatalog“ mit hervorgehobenem Katalog-Steuerelement.

  2. Wählen Sie Aktivieren oder Datensätze exportieren auf der Karte aus, die dem Ziel entspricht, an das Sie Datensätze exportieren möchten.

    Registerkarte „Zielkatalog“ mit hervorgehobenem Steuerelement „Aktivieren“.

  3. Wählen Sie Datentypdatensätze und dann die Zielverbindung aus, in die Sie Datensätze exportieren möchten, und klicken Sie dann auf Weiter.

TIP
Wenn Sie ein neues Ziel zum Exportieren von Datensätzen einrichten möchten, wählen Sie Neues Ziel konfigurieren aus, um den Workflow Mit Ziel verbinden auszulösen.

Zielaktivierungs-Workflow mit hervorgehobenem Steuerelement „Datensätze“.

  1. Die Ansicht Datensätze auswählen wird angezeigt. Fahren Sie mit dem nächsten Abschnitt fort, um die Datensätze auszuwählen, die exportiert werden sollen.

Auswählen Ihrer Datensätze select-datasets

Aktivieren Sie die Kontrollkästchen links neben den Datensatznamen, um die Datensätze auszuwählen, die Sie für das Ziel aktivieren möchten, und klicken Sie dann auf Weiter.

Workflow für den Datensatzexport, der den Schritt „Datensätze auswählen“ zeigt, in dem Sie auswählen können, welche Datensätze exportiert werden sollen.

Planen des Datensatzexports scheduling

Verwenden Sie den Zeitplan-Schritt, um:

  • Legen Sie ein Start- und Enddatum sowie eine Exportkadenz für Ihre Datensatzexporte fest.
  • Konfigurieren Sie, ob die exportierten Datensatzdateien die vollständige Mitgliedschaft des Datensatzes exportieren sollen oder nur inkrementelle Änderungen an der Mitgliedschaft bei jedem Exportereignis.
  • Passen Sie den Ordnerpfad an Ihrem Speicherort an, an den Datensätze exportiert werden sollen. Weitere Informationen zum (Bearbeiten des Exportordnerpfads.

Verwenden Sie das Steuerelement Zeitplan bearbeiten auf der Seite, um die Exportkadenz von Exporten zu bearbeiten und auszuwählen, ob vollständige oder inkrementelle Dateien exportiert werden sollen.

Steuerung „Zeitplan bearbeiten“ im Schritt „Planung“ hervorgehoben.

Die Option Inkrementelle Dateien exportieren ist standardmäßig ausgewählt. Dies führt zu einem Trigger einer oder mehrerer Dateien, die einen vollständigen Schnappschuss des Datensatzes darstellen. Nachfolgende Dateien sind inkrementelle Ergänzungen zum Datensatz seit dem vorherigen Export. Sie können auch Vollständige Dateien exportieren auswählen. Wählen Sie in diesem Fall die Häufigkeit Einmal für einen einmaligen vollständigen Export des Datensatzes aus.

IMPORTANT
Der erste inkrementelle Dateiexport umfasst alle vorhandenen Daten im Datensatz, sodass eine Aufstockung durchgeführt wird. Der Export kann eine oder mehrere Dateien enthalten.

Workflow für den Datensatzexport, der den Planungsschritt zeigt.

  1. Verwenden Sie den Häufigkeitsselektor zur Auswahl der Exportfrequenz:

    • Täglich: Planung von inkrementellen Dateiexporten einmal täglich, jeden Tag, zum von Ihnen festgelegten Zeitpunkt.
    • Stündlich: Planung von inkrementellen Dateiexporten alle 3, 6, 8 oder 12 Stunden.
  2. Verwenden Sie den Zeitselektor zur Auswahl der Tageszeit im Format UTC, zu der der Export erfolgen soll.

  3. Verwenden Sie den Datum-Selektor, um das Intervall auszuwählen, in dem der Export stattfinden soll.

  4. Wählen Sie Speichern aus, um den Zeitplan zu speichern, und fahren Sie mit dem Schritt Überprüfen fort.

NOTE
Bei Datensatzexporten haben die Dateinamen ein vordefiniertes Standardformat, das nicht geändert werden kann. Siehe Abschnitt Überprüfen eines erfolgreichen Datensatzexports, um weitere Informationen und Beispiele für exportierte Dateien zu erhalten.

Ordnerpfad bearbeiten edit-folder-path

Wählen Sie Ordnerpfad bearbeiten, um die Ordnerstruktur in Ihrem Speicherort, in dem exportierte Datensätze abgelegt werden, anzupassen.

Das Steuerelement „Ordnerpfad bearbeiten“ ist im Planungsschritt hervorgehoben.

Sie können mehrere verfügbare Makros verwenden, um einen gewünschten Ordnernamen anzupassen. Doppelklicken Sie auf ein Makro, um es zum Ordnerpfad hinzuzufügen, und trennen Sie die Ordner mithilfe von / zwischen den Makros.

Makroauswahl im modalen Fenster des benutzerdefinierten Ordners hervorgehoben.

Nach Auswahl der gewünschten Makros können Sie eine Vorschau der Ordnerstruktur anzeigen, die an Ihrem Speicherort erstellt wird. Die erste Ebene in der Ordnerstruktur stellt den Ordnerpfad“ dar den Sie angegeben haben, als Sie mit dem Ziel verbunden)Datensätze exportieren.

Vorschau des Ordnerpfads im modalen Fenster des benutzerdefinierten Ordners hervorgehoben.

Überprüfung review

Auf der Seite Überprüfen können Sie eine Zusammenfassung Ihrer Auswahl sehen. Wählen Sie Abbrechen aus, um den Fluss abzubrechen, Zurück, um die Einstellungen zu ändern, oder Fertigstellen, um Ihre Auswahl zu bestätigen und mit dem Senden von Datensätzen an das Ziel zu beginnen.

Arbeitsablauf für den Datensatzexport, der den Überprüfungsschritt anzeigt.

Überprüfen eines erfolgreichen Datensatzexports verify

Beim Exportieren von Datensätzen erstellt Experience Platform eine oder mehrere .json oder .parquet Dateien an dem von Ihnen angegebenen Speicherort. Es ist damit zu rechnen, dass neue Dateien entsprechend dem von Ihnen angegebenen Exportzeitplan an Ihrem Speicherort abgelegt werden.

Experience Platform erstellt eine Ordnerstruktur am angegebenen Speicherort, in der die exportierten Datensatzdateien abgelegt werden. Das standardmäßige Exportmuster für Ordner wird unten gezeigt, Sie können jedoch die Ordnerstruktur mit Ihren bevorzugten Makros anpassen.

TIP
Die erste Ebene in dieser Ordnerstruktur - folder-name-you-provided - stellt den Ordnerpfad dar, den Sie angegeben haben, als Sie mit dem Ziel verbunden Datensätze exportieren.

folder-name-you-provided/datasetID/exportTime=YYYYMMDDHHMM

Der standardmäßige Dateiname wird nach dem Zufallsprinzip generiert, was sicherstellt, dass die Namen von exportierten Dateien eindeutig sind.

Beispiele für Datensatzdateien sample-files

Das Vorhandensein dieser Dateien an Ihrem Speicherort bestätigt einen erfolgreichen Export. Um zu verstehen, wie die exportierten Dateien strukturiert sind, können Sie eine Parquet- oder JSON-Beispieldatei herunterladen.

Komprimierte Datensatzdateien compressed-dataset-files

Im Workflow Mit Ziel verbinden können Sie die exportierten Datensatzdateien auswählen, die komprimiert werden sollen, wie unten dargestellt:

Dateityp- und Komprimierungsauswahl beim Herstellen einer Verbindung zu einem Ziel zum Exportieren von Datensätzen.

Beachten Sie den Unterschied im Dateiformat zwischen den beiden Dateitypen, wenn sie komprimiert werden:

  • Beim Exportieren komprimierter JSON-Dateien wird das exportierte Dateiformat json.gz. Das Format des exportierten JSON ist NDJSON, das standardmäßige Austauschformat im Big-Data-Ökosystem. Adobe empfiehlt die Verwendung eines NDJSON-kompatiblen Clients zum Lesen der exportierten Dateien.
  • Beim Exportieren von komprimierten Parquet-Dateien wird das exportierte Dateiformat gz.parquet

Exporte in JSON-Dateien werden unterstützt nur im komprimierten Modus. Exporte in Parquet-Dateien werden im komprimierten und unkomprimierten Modus unterstützt.

Entfernen von Datensätzen aus Zielen remove-dataset

Gehen Sie wie folgt vor, um Datensätze aus einem vorhandenen Datenfluss zu entfernen:

  1. Melden Sie sich bei der Experience Platform-Benutzeroberfläche an und wählen Sie Ziele über die linke Navigationsleiste aus. Wählen Sie Durchsuchen in der oberen Kopfzeile aus, um Ihre vorhandenen Ziel-Datenflüsse anzuzeigen.

    Die Ansicht „Ziel durchsuchen“, wobei eine Zielverbindung angezeigt wird und der Rest unscharf gemacht wurde.

    note tip
    TIP
    Wählen Sie das Symbol Filter oben links, um das Sortier-Bedienfeld zu öffnen. Das Sortier-Bedienfeld bietet eine Liste aller Ihrer Ziele. Sie können mehr als ein Ziel aus der Liste auswählen, um eine gefilterte Auswahl von Datenflüssen anzuzeigen, die mit dem ausgewählten Ziel verknüpft sind.
  2. Wählen Sie in der Spalte Aktivierungsdaten das Steuerelement für Datensätze aus, um alle Datensätze anzuzeigen, die diesem Exportdatenfluss zugeordnet sind.

    Die verfügbare Navigationsoption für Datensätze, die in der Spalte „Aktivieriungsdaten“ hervorgehoben ist.

  3. Die Seite Aktivierungsdaten für dieses Ziel wird angezeigt. Aktivieren Sie die Kontrollkästchen links in der Datensatzliste, um die Datensätze auszuwählen, die Sie entfernen möchten, und wählen Sie dann Datensätze entfernen in der rechten Leiste aus, um den Trigger zum Entfernen des Datensatzbestätigungsdialogfelds anzuzeigen.

    Der Dialog „Datensatz entfernen“, der die Steuerung „Datensatz entfernen“ in der rechten Leiste anzeigt.

  4. Wählen Sie im Bestätigungsdialog die Option Entfernen aus, um den Datensatz sofort aus den Exporten in das Ziel zu entfernen.

    Dialogfeld mit der Option „Löschen des Datensatzes aus dem Datenfluss bestätigen“.

Berechtigungen für den Datensatzexport licensing-entitlement

Informationen dazu, wie viele Daten Sie pro Experience Platform-Anwendung und Jahr exportieren dürfen, finden Sie in den Produktbeschreibungsdokumenten. Sie können beispielsweise die Real-Time CDP-Produktbeschreibung ().

Beachten Sie, dass die Berechtigungen für den Datenexport für verschiedene Programme nicht additiv sind. Wenn Sie beispielsweise Real-Time CDP Ultimate und Adobe Journey Optimizer Ultimate erwerben, ist die Berechtigung für den Profilexport gemäß den Produktbeschreibungen höher als die beiden Berechtigungen. Die Berechnung Ihrer Volumenberechtigungen erfolgt anhand der Gesamtzahl der lizenzierten Profile und der Multiplikation mit 500 KB für Real-Time CDP Prime bzw. 700 KB für Real-Time CDP Ultimate, um zu bestimmen, wie viel Datenvolumen Ihnen zusteht.

Wenn Sie dagegen Add-ons wie Data Distiller erworben haben, stellt das Datenexportlimit, zu dem Sie berechtigt sind, die Summe aus der Produktebene und dem Add-on dar.

Sie können Ihre Profilexporte anhand Ihrer vertraglichen Beschränkungen im Dashboard Lizenznutzung“ anzeigen und.

Bekannte Einschränkungen known-limitations

Beachten Sie die folgenden Einschränkungen für die allgemeine Verfügbarkeit von Releases von Datensatzexporten:

  • Experience Platform exportiert möglicherweise mehrere Dateien, selbst für kleine Datensätze. Der Datensatzexport ist für die Integration von System zu System ausgelegt und für Leistung optimiert, sodass die Anzahl der exportierten Dateien nicht angepasst werden kann.
  • Die Namen exportierter Dateien können derzeit nicht angepasst werden.
  • Über API erstellte Datensätze sind derzeit nicht für den Export verfügbar.
  • Die Benutzeroberfläche hindert Sie derzeit nicht daran, einen Datensatz zu löschen, während er an ein Ziel exportiert wird. Löschen Sie keine Datensätze, während sie an Ziele exportiert werden. Entfernen Sie den Datensatz aus einem Ziel-Datenfluss, bevor Sie ihn löschen.
  • Überwachungsmetriken für Datensatzexporte werden derzeit mit Zahlen für Profilexporte gemischt, sodass sie nicht die tatsächlichen Exportzahlen widerspiegeln.
  • Daten mit einem Zeitstempel, der älter als 365 Tage ist, werden aus Datensatzexporten ausgeschlossen. Weitere Informationen finden Sie in der Leitplanken für geplante Datensatzexporte

Häufig gestellte Fragen faq

Können wir eine Datei ohne Ordner erzeugen, wenn wir nur unter / als Ordnerpfad speichern? Wenn wir keinen Ordnerpfad benötigen, wie werden dann Dateien mit doppelten Namen in einem Ordner oder Speicherort generiert?

Antwort
Ab der Version vom September 2024 ist es möglich, den Ordnernamen anzupassen und sogar / zum Exportieren von Dateien für alle Datensätze im selben Ordner zu verwenden. Adobe empfiehlt dies nicht für Ziele, die mehrere Datensätze exportieren, da systemgenerierte Dateinamen, die zu verschiedenen Datensätzen gehören, im selben Ordner gemischt werden.

Können Sie die Manifestdatei zu einem Ordner und die Datendateien zu einem anderen Ordner weiterleiten?

Antwort
Nein, es gibt keine Möglichkeit, die Manifestdatei an einen anderen Speicherort zu kopieren.

Können wir die Reihenfolge oder den Zeitpunkt der Dateibereitstellung steuern?

Antwort
Es gibt Optionen für die Planung des Exports. Es gibt keine Möglichkeiten, das Kopieren der Dateien zu verzögern oder zu sequenzieren. Sie werden an Ihren Speicherort kopiert, sobald sie generiert werden.

Welche Formate sind für die Manifestdatei verfügbar?

Antwort
Die Manifestdatei liegt im JSON-Format vor.

Gibt es API-Verfügbarkeit für die Manifestdatei?

Antwort
Für die Manifestdatei ist keine API verfügbar, sie enthält jedoch eine Liste der Dateien, die den Export umfassen.

Können wir der Manifestdatei zusätzliche Details hinzufügen (d. h. die Anzahl der Einträge)? Wenn ja, wie?

Antwort
Es ist nicht möglich, der Manifestdatei zusätzliche Informationen hinzuzufügen. Die Anzahl der Einträge ist über die flowRun-Entität verfügbar (abfragbar über API). Weitere Informationen finden Sie unter Überwachung von Zielen.

Wie werden Datendateien aufgeteilt? Wie viele Datensätze pro Datei?

Antwort
Datendateien werden gemäß der Standardpartitionierung im Data Lake von Experience Platform aufgeteilt. Größere Datensätze haben eine höhere Anzahl von Partitionen. Die Standardpartitionierung kann vom Benutzer nicht konfiguriert werden, da sie für das Lesen optimiert ist.

Können wir einen Schwellenwert (Anzahl der Datensätze pro Datei) festlegen?

Antwort
Nein, das ist nicht möglich.

Wie senden wir einen Datensatz erneut, wenn der erste Versand fehlerhaft ist?

Antwort
Für die meisten Arten von Systemfehlern werden automatisch weitere Zustellversuche unternommen.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6