Ziel der Data Landing Zone

Exportieren Sie Datendateien aus Adobe CX Enterprise Programmen an Ihren Data Landing Zone Cloud-Speicherort.

Unterstützte Adobe CX Enterprise supported-applications

Dieses Ziel ist in den folgenden Adobe CX Enterprise-Programmen verfügbar:

Funktionsweise von Data Landing Zone overview

Data Landing Zone ist eine von Adobe Experience Platform bereitgestellte Cloud-Speicherschnittstelle. Verwenden Sie diese Option, um Dateien aus Experience Platform an einen sicheren, Cloud-basierten Dateispeicherort zu exportieren. Experience Platform und seine Programme (z. B. Customer Journey Analytics, Journey Orchestration, Intelligent Services und Real-Time Customer Data Platform) stellen einen Data Landing Zone-Container pro Sandbox bereit. Das gesamte Datenvolumen über alle Container hinweg ist auf die Gesamtdaten beschränkt, die mit Ihrer Lizenz für Experience Platform-Produkte und -Services bereitgestellt werden.

Experience Platform löscht nach sieben Tagen automatisch alle Dateien in einem Data Landing Zone. Sie können exportierte ​ auch manuell löschen bevor die sieben Tage vergehen.

Der Data Landing Zone-Ziel-Connector ist für Experience Platform verfügbar, das auf Azure oder Amazon Web Services (AWS) ausgeführt wird. Der Authentifizierungsmechanismus hängt von der Cloud ab, in der das Ziel bereitgestellt wird. Alles andere über das Ziel und seine Anwendungsfälle ist dasselbe. Weitere Informationen zu den beiden Authentifizierungsmechanismen finden Sie in den Abschnitten Authentifizieren bei der im Azure Blob bereitgestellten Data Landing Zone und Authentifizieren bei der von AWS bereitgestellten Data Landing Zone.

{modal="regular"}

Verbinden mit dem Data Landing Zone-Speicher über API oder Benutzeroberfläche connect-api-or-ui

Unterstützte Zielgruppen supported-audiences

In diesem Abschnitt wird beschrieben, welche Arten von Zielgruppen Sie an dieses Ziel exportieren können. Die unterstützten Zielgruppen unterscheiden sich je nach der Adobe CX Enterprise, von der aus Sie sie für dieses Ziel aktivieren.

Real-Time CDP supported-audiences-rtcdp

Die folgenden Zielgruppen werden bei der Aktivierung über Real-Time CDP unterstützt:

Unterstützte Zielgruppen nach Zielgruppen-Datentyp:

Real-Time CDP Collaboration supported-audiences-collaboration

In Real-Time CDP Collaboration können Sie Zielgruppen ​ von Adobe Experience Platform oder anderen Cloud-Quellen beziehen. Zielgruppen in Real-Time CDP Collaboration bestehen aus "" ​. Sie können diese Zielgruppen in einer Collaboration für die Datenzusammenarbeit oder für Paid-Media-Aktivitäten verwenden.

Exporttyp und -häufigkeit export-type-frequency

Informationen zum Zielexporttyp und zur Häufigkeit finden Sie in der folgenden Tabelle.

Datensätze exportieren export-datasets

Dieses Ziel unterstützt Datensatzexporte. Vollständige Informationen zum Einrichten von Datensatzexporten finden Sie in den Tutorials:

Dateiformat der exportierten Daten file-format

Beim Exportieren Zielgruppendaten erstellt Experience Platform eine .csv-, parquet- oder .json-Datei an dem von Ihnen angegebenen Speicherort. Weitere Informationen zu den Dateien finden Sie im Abschnitt Unterstützte Dateiformate für den Export im Tutorial zur Zielgruppenaktivierung.

Beim Exportieren Datensätze erstellt Experience Platform eine .parquet- oder .json-Datei an dem von Ihnen angegebenen Speicherort. Weitere Informationen zu den Dateien finden Sie im Abschnitt Überprüfen eines erfolgreichen Datensatzexports im Tutorial zum Exportieren von Datensätzen.

Authentifizierung bei der im Azure Blob bereitgestellten Data Landing Zone authenticate-dlz-azure

Sie können Dateien in Ihrem Container lesen und schreiben, indem Sie Azure Storage Explorer oder die Befehlszeilenschnittstelle verwenden.

Data Landing Zone unterstützt die SAS-basierte Authentifizierung. Standardmäßige Azure Blob-Speichersicherheitsmechanismen schützen die Daten im Ruhezustand und bei der Übertragung. SAS steht für Shared Access Signature.

Um Ihre Daten über eine öffentliche Internetverbindung zu schützen, verwenden Sie die SAS-basierte Authentifizierung, um sicher auf Ihren Data Landing Zone-Container zuzugreifen. Sie müssen keine Netzwerkänderungen vornehmen, um auf Ihren Data Landing Zone-Container zuzugreifen. Dies bedeutet, dass Sie keine Zulassungslisten oder regionenübergreifende Setups für Ihr Netzwerk konfigurieren müssen.

Verbinden des Data Landing Zone Containers mit Azure Storage Explorer connect-container-to-storage-explorer

Verwenden Sie den Azure Storage ​Explorer), um den Inhalt Ihres Data Landing Zone-Containers zu verwalten. Um mit der Verwendung von Data Landing Zone zu beginnen, rufen Sie zunächst Ihre Anmeldeinformationen ab. Geben Sie sie dann in Azure Storage Explorer ein, um Ihren Data Landing Zone-Container zu verbinden.

Öffnen Sie in Azure Storage Explorer das Dialogfeld „Verbinden“. Das Fenster Ressource auswählen wird mit den Ressourcen angezeigt, mit denen Sie eine Verbindung herstellen können. Wählen Sie Blob container aus, um eine Verbindung zu Ihrem Data Landing Zone-Speicher herzustellen.

Wählen Sie als Nächstes Shared Access Signature URL (SAS) als Verbindungsmethode und klicken Sie dann auf Weiter.

Nachdem Sie Ihre Verbindungsmethode ausgewählt haben, geben Sie einen Anzeigenamen und die Blob-Container-SAS- an, die Ihrem Data Landing Zone-Container entspricht.

Abrufen der Anmeldeinformationen für Ihre Data Landing Zone retrieve-dlz-credentials

Verwenden Sie die Experience Platform-APIs, um Ihre Data Landing Zone-Anmeldedaten abzurufen, wie in diesem Abschnitt beschrieben. Informationen zum Abrufen der erforderlichen Werte für Ihre Kopfzeilen finden Sie im Handbuch Erste Schritte mit Adobe Experience Platform-APIs.

API-Format

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination

Anfrage

Im folgenden Anfragebeispiel werden Anmeldeinformationen für eine vorhandene Landing Zone abgerufen.

curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \

Antwort

Die folgende Antwort gibt die Anmeldeinformationen für Ihre Landing Zone zurück, einschließlich Ihrer aktuellen SASToken und SASUri sowie der storageAccountName, die Ihrem Landing Zone-Container entspricht.

{
    "containerName": "dlz-destination",
    "SASToken": "sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D",
    "storageAccountName": "dlblobstore99hh25i3df123",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-destination?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}

Aktualisieren Data Landing Zone Anmeldeinformationen update-dlz-credentials

Sie können Ihre Anmeldedaten jederzeit aktualisieren. Um Ihre SASToken zu aktualisieren, stellen Sie eine POST-Anfrage an den /credentials-Endpunkt der Connectors-API.

API-Format

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh

Anfrage

Die folgende Anfrage aktualisiert Ihre Anmeldeinformationen für die Landing Zone.

curl -X POST \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \

Antwort

Die folgende Antwort gibt aktualisierte Werte für Ihre SASToken und SASUri zurück.

{
    "containerName": "dlz-destination",
    "SASToken": "sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D",
    "storageAccountName": "dlblobstore99hh25i3dflek",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-destination?sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D"
}

Geben Sie Ihren Anzeigenamen (containerName) und Data Landing Zone SAS-URL an, wie im oben beschriebenen API-Aufruf zurückgegeben, und klicken Sie dann auf Weiter.

Das Fenster Zusammenfassung wird angezeigt. Es gibt Ihnen einen Überblick über Ihre Einstellungen, einschließlich Informationen zu Ihrem Blob-Endpunkt und Berechtigungen. Wenn Sie bereit sind, klicken Sie auf Verbinden.

Eine erfolgreiche Verbindung aktualisiert Ihre Benutzeroberfläche von Azure Storage Explorer mit Ihrem Data Landing Zone-Container.

Wenn Ihr Data Landing Zone-Container mit Azure Storage Explorer verbunden ist, können Sie damit beginnen, Dateien von Experience Platform in Ihren Data Landing Zone-Container zu exportieren. Um Dateien zu exportieren, stellen Sie in der Experience Platform-Benutzeroberfläche eine Verbindung zum Data Landing Zone-Ziel her, wie unter Mit dem Ziel verbinden beschrieben.

Authentifizierung bei der von AWS bereitgestellten Data Landing Zone authenticate-dlz-aws

Führen Sie die Schritte in diesem Abschnitt aus, um Anmeldeinformationen für Ihre Data Landing Zone-Instanz auf AWS bereitzustellen. Verwenden Sie dann einen Client Ihrer Wahl, um eine Verbindung zu Ihrer Data Landing Zone-Instanz herzustellen.

Abrufen der Anmeldeinformationen für Ihre Data Landing Zone retrieve-dlz-credentials-aws

Verwenden Sie die Experience Platform-APIs, um Ihre Data Landing Zone-Anmeldedaten abzurufen, wie in diesem Abschnitt beschrieben. Informationen zum Abrufen der erforderlichen Werte für Ihre Kopfzeilen finden Sie im Handbuch Erste Schritte mit Adobe Experience Platform-APIs.

API-Format

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination

Anfrage

Im folgenden Anfragebeispiel werden Anmeldeinformationen für eine vorhandene Landing Zone abgerufen.

curl --request GET \
  --url 'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  --header 'Authorization: Bearer ***' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key' \
  --header 'x-gw-ims-org-id: yourorg@AdobeOrg'

Antwort

Die folgende Antwort gibt die Anmeldeinformationen für Ihre Landing Zone zurück, einschließlich Ihrer aktuellen awsAccessKeyId, awsSecretAccessKey und anderer Informationen.

{
    "credentials": {
        "awsAccessKeyId": "ABCDW3MEC6HE2T73ZVKP",
        "awsSecretAccessKey": "A1B2Zdxj6y4xfR0QZGtf/phj/hNMAbOGtzM/JNeE",
        "awsSessionToken": "***"
    },
    "dlzPath": {
        "bucketName": "your-bucket-name",
        "dlzFolder": "dlz-destination"
    },
    "dlzProvider": "Amazon S3",
    "expiryTime": 1734494017
}

Herstellen einer Verbindung mit dem Ziel connect

Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Tutorial zur Zielkonfiguration beschrieben vor. Füllen Sie im Zielkonfigurations-Workflow die Felder aus, die in den beiden folgenden Abschnitten aufgeführt sind.

Beim Ziel authentifizieren authenticate

Wenn Ihr Data Landing Zone in Azure bereitgestellt wird, stellen Sie sicher, dass Sie Ihren Data Landing Zone-Container mit Azure Storage Explorer verbunden haben, wie in Verbinden Ihres Data Landing Zone-Containers mit dem Azure Storage Explorer beschrieben. Da Data Landing Zone ein von Adobe bereitgestellter Speicher ist, müssen Sie keine weiteren Schritte in der Experience Platform-Benutzeroberfläche ausführen, um sich beim Ziel zu authentifizieren.

Ausfüllen der Zieldetails destination-details

Füllen Sie die folgenden erforderlichen und optionalen Felder aus, um Details für das Ziel zu konfigurieren. Ein Sternchen neben einem Feld in der Benutzeroberfläche zeigt an, dass das Feld erforderlich ist.

Aktivieren von Warnhinweisen enable-alerts

Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status des Datenflusses zu Ihrem Ziel 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 Zielwarnhinweisen über die Benutzeroberfläche.

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

Aktivieren von Zielgruppen für dieses Ziel activate

Sie können Zielgruppen für dieses Ziel aus Real-Time CDP oder aus einem Real-Time CDP Collaboration Projekt aktivieren.

Aktivieren von Zielgruppen aus Real-Time CDP activate-rtcdp

Anweisungen ​ Aktivieren von Zielgruppen für dieses Ziel finden Sie ​Aktivieren von Zielgruppendaten für Batch-Profil-).

Planung scheduling

Im Schritt Planung können Sie Exportplan einrichten für Ihr Data Landing Zone Ziel festlegen und den Namen Ihrer exportierten Dateien konfigurieren.

Zuordnen von Attributen und Identitäten map

Im Schritt Zuordnung können Sie auswählen, welche Attribut- und Identitätsfelder für Ihre Profile exportiert werden sollen. Sie können auch festlegen, dass die Kopfzeilen in der exportierten Datei in einen beliebigen Anzeigenamen geändert werden. Weitere Informationen finden Sie im Zuordnungsschritt im Tutorial zur Benutzeroberfläche der Aktivierung von Batch-Zielen.

Aktivieren von Zielgruppen aus Real-Time CDP Collaboration activate-collaboration

Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel aus einem Real-Time CDP Collaboration Projekt finden Sie in der Übersicht über Real-Time CDP Collaboration-Ziele.

Überprüfen auf einen erfolgreichen Datenexport exported-data

Um sicherzustellen, dass der Export erfolgreich war, überprüfen Sie Ihren Data Landing Zone und stellen Sie sicher, dass die exportierten Dateien die erwarteten Profilpopulationen enthalten.

Exportierte Dateien löschen delete-exported-files

Experience Platform löscht exportierte Dateien nach sieben Tagen automatisch aus Ihrem Data Landing Zone. Sie können Dateien auch manuell aus Ihrem Container löschen, bevor die sieben Tage vergehen. Das manuelle Löschen ist für Data Landing Zone Container verfügbar, die sowohl in Azure als auch in AWS bereitgestellt werden.