Ziel der Data Landing Zone
Übersicht overview
Data Landing Zone ist eine von Adobe Experience Platform bereitgestellte Azure Blob-Speicherschnittstelle, die Ihnen Zugriff auf eine sichere, Cloud-basierte Dateispeichereinrichtung gewährt, um Dateien aus Platform zu exportieren. Sie haben Zugriff auf einen Data Landing Zone-Container pro Sandbox, und das gesamte Datenvolumen über alle Container hinweg ist auf die Gesamtdaten beschränkt, die mit Ihrer Produkt- und Services-Lizenz von Platform bereitgestellt werden. Alle Kunden von Platform und deren Anwendungen wie Customer Journey Analytics, Journey Orchestration, Intelligent Services und Real-Time Customer Data Platform erhalten einen Data Landing Zone -Container pro Sandbox. 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, und die Daten werden im Ruhezustand und bei der Übertragung mit standardmäßigen Azure Blob-Speichersicherheitsmechanismen geschützt. SAS steht für gemeinsame Zugriffssignatur.
Mit der SAS-basierten Authentifizierung können Sie sicher über eine öffentliche Internetverbindung auf Ihren Data Landing Zone-Container zugreifen. Für die Verwendung Ihres Data Landing Zone-Containers sind keine Netzwerkänderungen erforderlich. Sie müssen also keine Zulassungslisten oder regionenübergreifende Setups für Ihr Netzwerk konfigurieren.
Platform erzwingt eine strikte sieben Tage lange Lebensdauer („time-to-live“, TTL) für alle Dateien, die in einen Data Landing Zone-Container hochgeladen werden. Alle Dateien werden nach sieben Tagen gelöscht.
Verbindung zu Ihrem Data Landing Zone-Speicher über API oder Benutzeroberfläche herstellen connect-api-or-ui
- Um über die Platform-Benutzeroberfläche eine Verbindung zu Ihrem Speicherort für die Dateneinstiegszone herzustellen, lesen Sie die Abschnitte Verbindung zum Ziel herstellen und Zielgruppen für dieses Ziel aktivieren weiter unten.
- Um eine programmgesteuerte Verbindung zum Speicherort für Daten-Landing-Zone herzustellen, lesen Sie das Tutorial Aktivieren von Zielgruppen für dateibasierte Ziele mithilfe der Flow Service-API.
Unterstützte Zielgruppen supported-audiences
In diesem Abschnitt wird beschrieben, welche Zielgruppentypen Sie an dieses Ziel exportieren können.
Exporttyp und -häufigkeit export-type-frequency
Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.
Datensätze exportieren export-datasets
Dieses Ziel unterstützt Datensatzexporte. Vollständige Informationen zum Einrichten von Datensatzexporten finden Sie in den Tutorials:
- Exportieren von Datensätzen mithilfe der Platform-Benutzeroberfläche🔗.
- So exportieren Datensätze programmgesteuert mit der Flow Service-API.
Dateiformat der exportierten Daten file-format
Beim Exportieren von Zielgruppendaten erstellt Platform eine .csv-, parquet- oder .json-Datei am von Ihnen angegebenen Speicherort. Weitere Informationen zu den Dateien finden Sie im Abschnitt Unterstützte Dateiformate für den Export im Tutorial zur Aktivierung der Zielgruppe.
Beim Exportieren von Datensätzen erstellt Platform eine .parquet - oder .json -Datei am von Ihnen angegebenen Speicherort. Weitere Informationen zu den Dateien finden Sie im Abschnitt Überprüfen des erfolgreichen Datensatzexports im Tutorial zum Exportieren von Datensätzen.
Voraussetzungen prerequisites
Beachten Sie die folgenden Voraussetzungen, die erfüllt sein müssen, bevor Sie das Ziel Data Landing Zone verwenden können.
Verbinden Sie Ihren Data Landing Zone-Container mit Azure Storage Explorer
Sie können Azure Storage Explorer verwenden, um den Inhalt Ihres Data Landing Zone Containers zu verwalten. Um mit der Verwendung von Data Landing Zone zu beginnen, müssen Sie zunächst Ihre Anmeldeinformationen abrufen, sie in Azure Storage Explorer eingeben und Ihren Data Landing Zone-Container mit Azure Storage Explorer verbinden.
Wählen Sie in der Benutzeroberfläche von Azure Storage Explorer in der linken Navigationsleiste das Verbindungssymbol aus. Das Fenster Ressource auswählen wird angezeigt, in dem Sie Optionen für das Verbinden finden. 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, müssen Sie einen Anzeigenamen und die BlobContainer-SAS-URL angeben, die mit Ihrem Data Landing Zone-Container übereinstimmt.
Rufen Sie die Anmeldeinformationen für Ihren Data Landing Zone ab retrieve-dlz-credentials
Sie müssen die Platform-APIs verwenden, um Ihre Data Landing Zone -Anmeldedaten abzurufen. Der API-Aufruf zum Abrufen Ihrer Anmeldedaten wird unten 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
dlz_destinationdlz_destination -Typ ermöglicht es der API, einen Zielbehälter für die Einstiegszone von den anderen Behältertypen zu unterscheiden, die Ihnen zur Verfügung stehen.Anfrage
Im folgenden Anfragebeispiel werden Anmeldeinformationen für eine vorhandene Landingzone 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 Einstiegszone zurück, einschließlich Ihrer aktuellen SASToken und SASUri sowie der storageAccountName, die Ihrem Einstiegszonen-Container entsprechen.
{
"containerName": "dlz-user-container",
"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-user-container?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}
containerNameSASTokenSASUriData Landing Zone Anmeldedaten aktualisieren update-dlz-credentials
Sie können Ihre Anmeldedaten bei Bedarf auch aktualisieren. Sie können Ihre SASToken aktualisieren, indem Sie eine POST-Anfrage an den /credentials -Endpunkt der Connectors -API richten.
API-Format
POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh
dlz_destinationdlz_destination -Typ ermöglicht es der API, einen Zielbehälter für die Einstiegszone von den anderen Behältertypen zu unterscheiden, die Ihnen zur Verfügung stehen.refreshrefresh können Sie Ihre Landingzone-Anmeldedaten zurücksetzen und automatisch eine neue SASToken generieren.Anfrage
Mit der folgenden Anfrage werden Ihre Landingzone-Anmeldedaten aktualisiert.
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-user-container",
"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-user-container?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 die Data Landing Zone SAS-URL ein, wie im oben beschriebenen API-Aufruf zurückgegeben, und wählen Sie dann Weiter aus.
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.
Da Ihr Data Landing Zone-Container jetzt 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, müssen Sie in der Experience Platform-Benutzeroberfläche eine Verbindung zum Ziel Data Landing Zone herstellen, wie im folgenden Abschnitt beschrieben.
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
Stellen Sie sicher, dass Sie Ihren Data Landing Zone-Container mit Azure Storage Explorer verbunden haben, wie im Abschnitt Voraussetzungen 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.
-
Name: Geben Sie einen bevorzugten Namen für das Ziel ein.
-
Beschreibung: Optional. Hier können Sie beispielsweise erwähnen, für welche Kampagne Sie dieses Ziel verwenden.
-
Ordnerpfad: Geben Sie den Pfad zum Zielordner ein, in dem die exportierten Dateien gespeichert werden.
-
Dateityp: Wählen Sie das Format, das Experience Platform für die exportierten Dateien verwenden soll. Wenn Sie die Option CSV auswählen, können Sie auch die Dateiformatierungsoptionen konfigurieren.
-
Komprimierungsformat: Wählen Sie den Komprimierungstyp aus, den Experience Platform für die exportierten Dateien verwenden soll.
-
Manifestdatei einschließen: Schalten Sie diese Option ein, wenn Sie möchten, dass die Exporte eine Manifest-JSON-Datei mit Informationen zum Exportspeicherort, zur Exportgröße und mehr enthalten. Das Manifest wird mit dem Format
manifest-<<destinationId>>-<<dataflowRunId>>.jsonbenannt. Anzeigen einer Beispielmanifestdatei. Die Manifestdatei enthält die folgenden Felder:flowRunId: Der Datenfluss-Lauf , der die exportierte Datei generiert hat.scheduledTime: Die Uhrzeit in UTC, zu der die Datei exportiert wurde.exportResults.sinkPath: Der Pfad in Ihrem Speicherort, an dem die exportierte Datei abgelegt wird.- 0: Der Name der exportierten Datei.
exportResults.name size: Die Größe der exportierten Datei in Byte.
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 alle Details für Ihre Zielverbindung eingegeben haben, klicken Sie auf Weiter.
Aktivieren von Zielgruppen für dieses Ziel activate
- Um Daten zu aktivieren, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen .Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
- Um identities zu exportieren, benötigen Sie die Zugriffssteuerungsberechtigung Identitätsdiagramm anzeigen 🔗.
Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Zielgruppendaten für Batch-Profilexportziele .
Planung
Im Schritt Planung können Sie für Ihr Data Landing Zone-Ziel den Exportplan einrichten, und Sie können dort auch den Namen Ihrer exportierten Dateien konfigurieren.
Zuordnen von Attributen und Identitäten map
Im Schritt Zuordnung können Sie festlegen, welche Attribute 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.
Überprüfen auf einen erfolgreichen Datenexport exported-data
Überprüfen Sie, ob die Daten erfolgreich exportiert wurden, indem Sie Ihren Data Landing Zone-Speicher überprüfen, und stellen Sie sicher, dass die exportierten Dateien die erwarteten Profilpopulationen enthalten.