Ziel der Data Landing Zone

Letzte Aktualisierung: 2024-01-22
  • Erstellt für:
  • Developer
    User
    Admin
    Leader
WICHTIG

Diese Dokumentationsseite bezieht sich auf die Data Landing Zone Ziel. Es gibt auch eine Data Landing Zone source im Quellkatalog. Weitere Informationen finden Sie im Abschnitt Data Landing Zone source Dokumentation.

Übersicht

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 Kundinnen und Kunden von Platform sowie die zugehörigen Anwendungs-Services 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. 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.

Verbinden Sie Ihre Data Landing Zone Speicher über API oder Benutzeroberfläche

Unterstützte Zielgruppen

In diesem Abschnitt wird beschrieben, welche Zielgruppentypen Sie an dieses Ziel exportieren können.

Audience Origin Unterstützt Beschreibung
Segmentation Service Über die Experience Platform generierte Zielgruppen Segmentierungsdienst.
Benutzerdefinierte Uploads Zielgruppen, die aus CSV-Dateien in Experience Platform importiert werden.

Exporttyp und -häufigkeit

Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.

Element Typ Anmerkungen
Exporttyp Profilbasiert Sie exportieren alle Teile eines Segments zusammen mit den entsprechenden Schemafeldern (wie etwa Ihre PPID), gemäß der Auswahl im Bildschirm „Profilattribute auswählen“ des Zielaktivierungs-Workflows.
Exporthäufigkeit Batch Batch-Ziele exportieren Dateien in Schritten von drei, sechs, acht, zwölf oder vierundzwanzig Stunden auf nachgelagerte Plattformen. Weitere Informationen finden Sie unter Batch-Datei-basierte Ziele.

Voraussetzungen

Beachten Sie die folgenden Voraussetzungen, die erfüllt sein müssen, bevor Sie die Data Landing Zone Ziel.

Verbinden Sie Data Landing Zone Container zu Azure Storage Explorer

Sie können Azure Storage Explorer die Inhalte Ihrer Data Landing Zone Container. Zu Beginn der Verwendung von Data Landing Zone, müssen Sie zunächst Ihre Anmeldedaten abrufen und sie in Azure Storage Explorerund verbinden Sie Ihre Data Landing Zone Container zu Azure Storage Explorer.

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 eine Ressource aus, die in der Azure-Benutzeroberfläche hervorgehoben ist.

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

Wählen Sie die Verbindungsmethode aus, die in der Azure-Benutzeroberfläche hervorgehoben ist.

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 Ihre Data Landing Zone

Sie müssen die Platform-APIs zum Abrufen Ihrer Data Landing Zone Anmeldedaten. Der API-Aufruf zum Abrufen Ihrer Anmeldedaten wird unten beschrieben. Informationen zum Abrufen der erforderlichen Werte für Ihre Kopfzeilen finden Sie im Abschnitt Erste Schritte mit Adobe Experience Platform-APIs Handbuch.

API-Format

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination
Abfrageparameter Beschreibung
dlz_destination Die dlz_destination Mit type kann die API einen Zielcontainer für die Einstiegszone von den anderen Behältertypen 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 Landingzone zurück, einschließlich Ihrer aktuellen SASToken und SASUriund die storageAccountName , der Ihrem Landingzone-Container entspricht.

{
    "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"
}
Eigenschaft Beschreibung
containerName Der Name Ihrer Landingzone.
SASToken Das Token für die gemeinsame Zugriffssignatur für Ihre Landingzone. Diese Zeichenfolge enthält alle Informationen, die zum Autorisieren einer Anfrage erforderlich sind.
SASUri Der URI der Freigegebenen Zugriffssignatur für Ihre Landingzone. Diese Zeichenfolge ist eine Kombination aus dem URI für die Landingzone, für die Sie authentifiziert werden, und dem zugehörigen SAS-Token.

Aktualisieren Data Landing Zone Anmeldeinformationen

Sie können Ihre Anmeldedaten bei Bedarf auch aktualisieren. Sie können Ihre SASToken , indem Sie eine POST an die /credentials Endpunkt der Connectors API.

API-Format

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh
Abfrageparameter Beschreibung
dlz_destination Die dlz_destination Mit type kann die API einen Zielcontainer für die Einstiegszone von den anderen Behältertypen unterscheiden, die Ihnen zur Verfügung stehen.
refresh Die refresh Mit dieser Aktion können Sie Ihre Landingzone-Anmeldedaten zurücksetzen und automatisch eine neue SASToken.

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.

{
    "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 Data Landing Zone SAS-URL, wie im oben beschriebenen API-Aufruf zurückgegeben, und wählen Sie dann Nächste.

Geben Sie Verbindungsinformationen ein, die in der Azure-Benutzeroberfläche hervorgehoben sind.

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.

Zusammenfassung der in der Azure-Benutzeroberfläche angezeigten Einstellungen.

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

Zusammenfassung des DLZ-Benutzercontainers, der in der Azure-Benutzeroberfläche hervorgehoben wurde.

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 eine Verbindung zum Data Landing Zone Ziel in der Experience Platform-Benutzeroberfläche, wie im folgenden Abschnitt beschrieben.

Herstellen einer Verbindung mit dem Ziel

WICHTIG

Um eine Verbindung zum Ziel herzustellen, benötigen Sie die Ziele anzeigen und Ziele verwalten Zugriffssteuerungsberechtigungen. Lesen Sie die Zugriffskontrolle – Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.

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

Stellen Sie sicher, dass Sie Ihre Data Landing Zone Container zu Azure Storage Explorer wie in Voraussetzungen Abschnitt. weil Data Landing Zone ist ein von Adobe bereitgestellter Speicher, müssen Sie keine weiteren Schritte in der Experience Platform-Benutzeroberfläche ausführen, um sich beim Ziel zu authentifizieren.

Ausfüllen der Zieldetails

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 aus, das Experience Platform für die exportierten Dateien verwenden soll. Wenn Sie CSV können Sie auch 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 JSON-Manifestdatei mit Informationen zum Exportspeicherort, zur Exportgröße und mehr enthalten. Das Manifest wird im Format manifest-<<destinationId>>-<<dataflowRunId>>.json. Anzeigen von Beispielmanifestdatei. Die Manifestdatei enthält die folgenden Felder:
    • flowRunId: Die dataflow run die die exportierte Datei generiert hat.
    • scheduledTime: Die Uhrzeit in UTC, zu der die Datei exportiert wurde.
    • exportResults.sinkPath: Der Pfad in Ihrem Speicherort, unter dem die exportierte Datei abgelegt wird.
    • exportResults.name: Der Name der exportierten Datei.
    • size: Die Größe der exportierten Datei in Byte.

Aktivieren von Warnhinweisen

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

WICHTIG

Siehe Aktivieren von Zielgruppendaten für Batch-Profil-Export-Ziele für Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel.

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

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.

Exportieren von Datensätzen

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

Überprüfen auf einen erfolgreichen Datenexport

Ü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.

Auf dieser Seite