Ziel der Data Landing Zone

IMPORTANT
Diese Dokumentationsseite verweist auf das Data Landing Zone Ziel. Es gibt auch eine Data Landing Zone Quelle im Quellkatalog. Weitere Informationen finden Sie in der Dokumentation Data Landing Zone Quelle .

Übersicht overview

Data Landing Zone ist eine von Adobe Experience Platform bereitgestellte Cloud-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 Programme wie Customer Journey Analytics, Journey Orchestration, Intelligent Services und Real-Time Customer Data Platform erhalten einen Data Landing Zone-Container pro Sandbox.

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.

Der Data Landing Zone-Ziel-Connector ist für Kundinnen und Kunden verfügbar, die den Azure- oder Amazon Web Service-Cloud-Support verwenden. Der Authentifizierungsmechanismus unterscheidet sich je nach Cloud, in der das Ziel bereitgestellt wird, alle weiteren Informationen zum Ziel und zu dessen Anwendungsfällen sind identisch. Weitere Informationen zu den beiden verschiedenen Authentifizierungsmechanismen finden Sie in den Abschnitten Authentifizieren bei der in Azure Blob bereitgestellten Data Landing Zone und Authentifizieren bei der von AWS bereitgestellten Data Landing Zone.

Diagramm, das zeigt, wie sich die Implementierung des Data Landing Zone-Ziels je nach Cloud-Unterstützung unterscheidet. {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.

Zielgruppenherkunft
Unterstützt
Beschreibung
Segmentation Service
Zielgruppen, die über den Experience Platform (-Service) generiert.
Benutzerdefinierte Uploads
Zielgruppen, die aus CSV-Dateien in Experience Platform importiert werden.

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.

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.

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 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 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 in Azure Blob bereitgestellten Data Landing Zone authenticate-dlz-azure

AVAILABILITY
Dieser Abschnitt gilt für Implementierungen von Experience Platform, die auf Microsoft Azure ausgeführt werden. Weitere Informationen zur unterstützten Experience Platform-Infrastruktur finden Sie in der Übersicht zur Experience Platform-Multi-Cloud.

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

Verbinden des Data Landing Zone Containers mit Azure Storage Explorer

Sie können Azure Storage Explorer verwenden, um den Inhalt Ihres Data Landing Zone-Containers zu verwalten. Um Data Landing Zone verwenden zu können, 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.

Ressource auswählen, 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.

In der Azure-Benutzeroberfläche hervorgehobene Verbindungsmethode auswählen.

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.

recommendation-more-help

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

Sie müssen die Platform-APIs verwenden, um Ihre Data Landing Zone-Anmeldedaten abzurufen. Der API-Aufruf zum Abrufen Ihrer Anmeldeinformationen 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
Abfrageparameter
Beschreibung
dlz_destination
Der dlz_destination ermöglicht es der API, einen Landing Zone-Ziel-Container von den anderen Containertypen zu unterscheiden, die Ihnen zur Verfügung stehen.

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"
}
Eigenschaft
Beschreibung
containerName
Der Name Ihrer Landing Zone.
SASToken
Das Shared Access Signature Token für Ihre Landing Zone. Diese Zeichenfolge enthält alle Informationen, die zum Autorisieren einer Anfrage erforderlich sind.
SASUri
Der Signatur-URI für den gemeinsamen Zugriff für Ihre Landing Zone. Diese Zeichenfolge ist eine Kombination aus dem URI zur Landing Zone, für die Sie authentifiziert werden, und dem entsprechenden SAS-Token,

Aktualisieren Data Landing Zone Anmeldeinformationen 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 stellen.

API-Format

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh
Abfrageparameter
Beschreibung
dlz_destination
Der dlz_destination ermöglicht es der API, einen Landing Zone-Ziel-Container von den anderen Containertypen zu unterscheiden, die Ihnen zur Verfügung stehen.
refresh
Mit der refresh Aktion können Sie Ihre Anmeldeinformationen für die Landing Zone zurücksetzen und automatisch eine neue SASToken generieren.

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.

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-Benutzer-Containers, der in der Azure-Benutzeroberfläche hervorgehoben ist.

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 herstellen, wie im folgenden Abschnitt beschrieben.

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

AVAILABILITY
Dieser Abschnitt gilt für Implementierungen von Experience Platform, die auf Amazon Web Services (AWS) ausgeführt werden. Experience Platform, das auf AWS ausgeführt wird, steht derzeit einer begrenzten Anzahl von Kunden zur Verfügung. Weitere Informationen zur unterstützten Experience Platform-Infrastruktur finden Sie in der Übersicht zur Experience Platform-Multi-Cloud.

Führen Sie die folgenden Schritte aus, um Anmeldeinformationen für Ihre auf AWS bereitgestellte Data Landing Zone-Instanz zu erhalten. 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

Sie müssen die Platform-APIs verwenden, um Ihre Data Landing Zone-Anmeldedaten abzurufen. Der API-Aufruf zum Abrufen Ihrer Anmeldeinformationen 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'
Abfrageparameter
Beschreibung
dlz_destination
Fügen Sie den dlz_destination Abfrageparameter hinzu, um anzugeben, dass Data Landing Zone Container-Anmeldeinformationen vom Typ Ziel abgerufen werden sollen. Informationen zum Verbinden und Abrufen von Anmeldeinformationen für eine Data Landing Zone Quelle finden Sie in der Quellendokumentation.

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
}
Eigenschaft
Beschreibung
credentials
Dieses Objekt enthält die awsAccessKeyId, awsSecretAccessKey und awsSessionToken, die Experience Platform verwendet, um Dateien an Ihren bereitgestellten Data Landing Zone-Speicherort zu exportieren.
dlzPath
Dieses Objekt enthält den Pfad im von Adobe bereitgestellten AWS-Speicherort, an dem exportierte Dateien abgelegt werden.
dlzProvider
Gibt an, dass dies eine von Amazon S3 bereitgestellte Data Landing Zone ist.
expiryTime
Gibt an, wann die Anmeldeinformationen im credentials ablaufen. Um die Anmeldeinformationen zu aktualisieren, führen Sie die Anfrage erneut aus.

Herstellen einer Verbindung mit dem Ziel connect

IMPORTANT
Um eine Verbindung mit dem Ziel herzustellen, benötigen Sie 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 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 aus, das Experience Platform für die exportierten Dateien verwenden soll. Bei Auswahl der Option CSV 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 die Exporte eine JSON-Manifestdatei enthalten sollen, die Informationen zum Exportspeicherort, zur Exportgröße und mehr enthält. Das Manifest wird mit dem Format manifest-<<destinationId>>-<<dataflowRunId>>.json benannt. Anzeigen einer Beispielmanifestdatei. Die Manifestdatei enthält die folgenden Felder:

    • flowRunId: Die Datenflussausführung die die exportierte Datei generiert hat.
    • scheduledTime: Die Zeit in UTC, zu der die Datei exportiert wurde.
    • exportResults.sinkPath: Der Pfad an Ihrem Speicherort, an 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 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

IMPORTANT
  • Zum Aktivieren von Daten benötigen Sie die Berechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigenZugriffssteuerung. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.

  • Zum Exportieren Identitäten benötigen Sie die Berechtigung Identitätsdiagramm anzeigen Zugriffssteuerung.

    Wählen Sie einen im Workflow hervorgehobenen Identity-Namespace aus, um Zielgruppen für Ziele zu aktivieren. {width="100" modal="regular"}

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

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.

7f4d1967-bf93-4dba-9789-bb6b505339d6