Aktivieren von Zielgruppen für dateibasierte Ziele mithilfe der Flow Service-API
Verwenden Sie die erweiterten Dateiexportfunktionen, um auf erweiterte Anpassungsfunktionen beim Exportieren von Dateien aus der Experience Platform zuzugreifen:
- Zusätzliche Dateibenennungsoptionen.
- Möglichkeit zum Festlegen benutzerdefinierter Datei-Kopfzeilen in exportierten Dateien durch den verbesserten Zuordnungsschritt.
- Möglichkeit, den Dateityp der exportierten Datei auszuwählen.
- Möglichkeit zum Anpassen der Formatierung exportierter CSV-Datendateien.
Diese Funktion wird von den folgenden sechs Cloud-Speicherkarten unterstützt:
In diesem Artikel wird der Workflow erläutert, der zur Verwendung der Flow Service-API erforderlich ist, um qualifizierte Profile aus Adobe Experience Platform an einen der oben verknüpften Cloud-Speicher zu exportieren.
Erste Schritte get-started
Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Adobe Experience Platform voraus:
- Experience Data Model (XDM) System: Das standardisierte Framework, mit dem Kundenerlebnisdaten von Experience Platform organisiert werden.
- Segmentation Service: Adobe Experience Platform Segmentation Service ermöglicht Ihnen, aus Ihren Real-Time Customer Profile -Daten Zielgruppen zu erstellen und in Adobe Experience Platform Zielgruppen zu generieren.
- Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse besser entwickeln und weiterentwickeln können.
Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um Daten für dateibasierte Ziele in Platform aktivieren zu können.
Erforderliche Berechtigungen permissions
Zum Exportieren von Profilen 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 🔗.
{width="100" modal="regular"}
Lesen von Beispiel-API-Aufrufen reading-sample-api-calls
In diesem Tutorial wird anhand von Beispielen für API-Aufrufe die korrekte Formatierung von Anfragen aufgezeigt. Dazu gehören Pfade, erforderliche Kopfzeilen und ordnungsgemäß formatierte Anfrage-Payloads. Außerdem wird ein Beispiel für eine von der API im JSON-Format zurückgegebene Antwort bereitgestellt. Informationen zu den Konventionen, die in der Dokumentation für Beispiel-API-Aufrufe verwendet werden, finden Sie im Abschnitt zum Lesen von Beispiel-API-Aufrufen im Handbuch zur Fehlerbehebung für Experience Platform
Sammeln der Werte für erforderliche und optionale Kopfzeilen gather-values-headers
Um Platform -APIs aufrufen zu können, müssen Sie zunächst das Tutorial zur Experience Platform-Authentifizierung 2} abschließen.Durch Abschluss des Authentifizierungs-Tutorials werden die Werte für die einzelnen erforderlichen Header in allen Experience Platform-API-Aufrufen bereitgestellt, wie unten dargestellt:
- Authorization: Bearer
{ACCESS_TOKEN}
- x-api-key:
{API_KEY}
- x-gw-ims-org-id:
{ORG_ID}
Ressourcen in Experience Platform lassen sich in spezifischen virtuellen Sandboxes isolieren. Bei Anfragen an Platform-APIs können Sie den Namen und die ID der Sandbox angeben, in der der Vorgang ausgeführt werden soll. Dies sind optionale Parameter.
- x-sandbox-name:
{SANDBOX_NAME}
Für alle Anfragen, die eine Payload enthalten (POST
, PUT
, PATCH
), ist eine zusätzliche Kopfzeile vom Medientyp erforderlich:
- Content-Type:
application/json
API-Referenzdokumentation api-reference-documentation
Eine zugehörige Referenzdokumentation für alle API-Vorgänge finden Sie in diesem Tutorial. Weitere Informationen finden Sie in der Dokumentation zur API für Fluss-Service - Ziele auf der Adobe Developer-Website🔗. Wir empfehlen, dass Sie dieses Tutorial und die API-Referenzdokumentation parallel verwenden.
Glossar glossary
Beschreibungen der Begriffe, auf die Sie in diesem API-Tutorial treffen werden, finden Sie im Abschnitt Glossar Abschnitt der API-Referenzdokumentation.
Auswählen des Ziels, an das Zielgruppen exportiert werden sollen select-destination
Ermitteln Sie vor dem Start des Workflows zum Exportieren von Profilen die Kennungen für Verbindungsspezifikationen und Flussspezifikationen des Ziels, an das Sie Zielgruppen exportieren möchten. Verwenden Sie die nachstehende Tabelle als Referenz.
4fce964d-3f37-408f-9778-e597338a21ee
1a0514a6-33d4-4c7f-aff8-594799c47549
6d6b59bf-fb58-4107-9064-4d246c0e5bb2
752d422f-b16f-4f0d-b1c6-26e448e3b388
be2c3209-53bc-47e7-ab25-145db8b873e1
17be2013-2549-41ce-96e7-a70363bec293
10440537-2a7b-4583-ac39-ed38d4b848e8
cd2fc47e-e838-4f38-a581-8fff2f99b63a
c5d93acb-ea8b-4b14-8f53-02138444ae99
585c15c4-6cbf-4126-8f87-e26bff78b657
36965a81-b1c6-401b-99f8-22508f1e6a26
fd36aaa4-bf2b-43fb-9387-43785eeeb799
Sie benötigen diese IDs, um in den nächsten Schritten dieses Tutorials verschiedene Flussdienstentitäten zu erstellen. Sie müssen auch auf Teile der Verbindungsspezifikation selbst verweisen, um bestimmte Entitäten einzurichten, damit Sie die Verbindungsspezifikation von den Flow Service-APIs abrufen können. Siehe die folgenden Beispiele zum Abrufen von Verbindungsspezifikationen für alle Ziele in der Tabelle:
Anfrage
accordion | ||
---|---|---|
Abrufen connection spec für Amazon S3 | ||
|
Antwort
accordion | ||
---|---|---|
Amazon S3 - Verbindungsspezifikation | ||
|
Anfrage
accordion | ||
---|---|---|
Abrufen connection spec für Azure Blob Storage | ||
|
Antwort
accordion | ||
---|---|---|
Azure Blob Storage – Connection spec | ||
|
Anfrage
accordion | ||
---|---|---|
Abrufen connection spec für Azure Data Lake Gen 2(ADLS Gen2) | ||
|
Antwort
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) – Connection spec | ||
|
Anfrage
accordion | ||
---|---|---|
Abrufen connection spec für Data Landing Zone(DLZ) | ||
|
Antwort
accordion | ||
---|---|---|
Data Landing Zone(DLZ) – Connection spec | ||
|
Anfrage
accordion | ||
---|---|---|
Abrufen connection spec für Google Cloud Storage | ||
|
Antwort
accordion | ||
---|---|---|
Google Cloud Storage – Connection spec | ||
|
Anfrage
accordion | ||
---|---|---|
Abrufen connection spec für SFTP | ||
|
Antwort
accordion | ||
---|---|---|
SFTP - Connection spec | ||
|
Gehen Sie wie folgt vor, um einen Zielgruppenexport-Datenfluss zu einem Cloud-Speicher-Ziel einzurichten. Bei einigen Schritten unterscheiden sich die Anforderungen und Antworten zwischen den verschiedenen Cloud-Speicher-Zielen. Verwenden Sie in diesen Fällen die Registerkarten auf der Seite, um die Anforderungen und Antworten abzurufen, die spezifisch für das Ziel sind, mit dem Sie Zielgruppen verbinden und exportieren möchten. Verwenden Sie unbedingt die korrekten connection spec
und flow spec
für das Ziel, das Sie konfigurieren.
Erstellen einer Source-Verbindung create-source-connection
Nachdem Sie entschieden haben, an welches Ziel Sie Zielgruppen exportieren, müssen Sie eine Quellverbindung erstellen. Die Quellverbindung stellt die Verbindung zum internen Experience Platform-Profilspeicher dar.
Anfrage
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare beim Kopieren und Einfügen der Anforderung in Ihr Terminal Ihrer Wahl.
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Eine erfolgreiche Antwort gibt die Kennung (id
) der neu erstellten Quellverbindung und eine etag
zurück. Notieren Sie sich die Kennung der Quellverbindung, wie Sie sie später beim Erstellen des Datenflusses benötigen.
Erstellen einer Basisverbindung create-base-connection
Eine Basisverbindung speichert die Anmeldeinformationen sicher in Ihrem Ziel. Je nach Zieltyp können die für die Authentifizierung an diesem Ziel erforderlichen Anmeldeinformationen variieren. Um diese Authentifizierungsparameter zu finden, rufen Sie zunächst die connection spec
für Ihr gewünschtes Ziel ab, wie im Abschnitt Ziel auswählen, an das Zielgruppen exportiert werden sollen beschrieben, und sehen Sie sich dann die authSpec
der Antwort an. Referenzieren Sie die folgenden Registerkarten für die authSpec
-Eigenschaften aller unterstützten Ziele.
accordion | ||
---|---|---|
Amazon S3 - Connection spec mit auth spec | ||
Beachten Sie die hervorgehobene Zeile mit Inline-Kommentaren im Beispiel connection spec unten, die zusätzliche Informationen darüber enthalten, wo die Authentifizierungsparameter in der connection spec zu finden sind.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec mit auth spec | ||
Beachten Sie die hervorgehobene Zeile mit Inline-Kommentaren im Beispiel connection spec unten, die zusätzliche Informationen darüber enthalten, wo die Authentifizierungsparameter in der connection spec zu finden sind.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec mit auth spec | ||
Beachten Sie die hervorgehobene Zeile mit Inline-Kommentaren im Beispiel connection spec unten, die zusätzliche Informationen darüber enthalten, wo die Authentifizierungsparameter in der connection spec zu finden sind.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Connection spec mit auth spec | |||||
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec mit auth spec | ||
Beachten Sie die hervorgehobene Zeile mit Inline-Kommentaren im Beispiel connection spec unten, die zusätzliche Informationen darüber enthalten, wo die Authentifizierungsparameter in der connection spec zu finden sind.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Connection spec mit auth spec anzeigen | |||||
Beachten Sie die hervorgehobene Zeile mit Inline-Kommentaren im Beispiel connection spec unten, die zusätzliche Informationen darüber enthalten, wo die Authentifizierungsparameter in der connection spec zu finden sind.
|
Mithilfe der in der Authentifizierungsspezifikation angegebenen Eigenschaften (d. h. authSpec
aus der Antwort) können Sie eine Basisverbindung mit den erforderlichen Anmeldeinformationen erstellen, die für jeden Zieltyp spezifisch sind, wie in den folgenden Beispielen dargestellt:
Anfrage
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Basis-Verbindungsanforderung mit Zugriffsschlüssel und geheimer Schlüsselauthentifizierung | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Basisverbindungsanforderung mit übernommener Rollenauthentifizierung | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
Antwort
accordion | ||
---|---|---|
Amazon S3 Antwort auf Basisverbindung | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Grundlegende Verbindungsanforderung | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
Antwort
accordion | ||
---|---|---|
Azure Blob Storage - Antwort auf Basisverbindung | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Grundlegende Verbindungsanforderung | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
Antwort
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Antwort auf Basisverbindung | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Grundlegende Verbindungsanforderung | |||||
|
Antwort
accordion | ||
---|---|---|
Data Landing Zone - Antwort auf Basisverbindung | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Grundlegende Verbindungsanforderung | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
Antwort
accordion | ||
---|---|---|
Google Cloud Storage - Antwort auf Basisverbindung | ||
|
Anfrage
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP mit Passwort - Grundlegende Verbindungsanforderung | |||||||||||||||||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP mit SSH-Schlüssel - Basis-Verbindungsanforderung | |||||||||||||||||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
Antwort
accordion | ||
---|---|---|
SFTP - Antwort auf Basisverbindung | ||
|
Verschlüsselung zu exportierten Dateien hinzufügen
Optional können Sie Ihren exportierten Dateien Verschlüsselung hinzufügen. Dazu müssen Sie Elemente aus dem encryptionSpecs
hinzufügen. Siehe Anforderungsbeispiel unten mit hervorgehobenen obligatorischen Parametern:
code language-json line-numbers data-start-1 data-line-offset-4 h-26-27 |
---|
|
Anfrage
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare beim Kopieren und Einfügen der Anforderung in Ihr Terminal Ihrer Wahl.
code language-shell line-numbers data-start-1 data-line-offset-4 h-19 |
---|
|
Antwort
code language-json |
---|
|
Notieren Sie die Verbindungs-ID aus der Antwort. Diese ID ist im nächsten Schritt beim Erstellen der Zielverbindung erforderlich.
Erstellen einer Zielverbindung create-target-connection
Als Nächstes müssen Sie eine Zielverbindung erstellen. Zielverbindungen speichern die Exportparameter für die exportierten Zielgruppen. Zu den Exportparametern gehören Exportspeicherort, Dateiformat, Komprimierung und andere Details. Für CSV-Dateien können Sie beispielsweise mehrere Exportoptionen auswählen. Ausführliche Informationen zu allen unterstützten CSV-Exportoptionen finden Sie auf der Seite Dateiformatierungskonfigurationen .
Die unterstützten Eigenschaften für die einzelnen Zieltypen finden Sie in den connection spec
-Eigenschaften des Ziels. targetSpec
Referenzieren Sie die folgenden Registerkarten für die targetSpec
-Eigenschaften aller unterstützten Ziele.
accordion | ||
---|---|---|
Amazon S3 - Connection spec zeigt Zielverbindungsparameter an | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Beispiel unten connection spec , die zusätzliche Informationen darüber enthalten, wo die Parameter target spec in der Verbindungsspezifikation zu finden sind. Im Beispiel unten sehen Sie auch, welche Zielparameter für Zielgruppenexport-Ziele nicht gelten.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec zeigt Zielverbindungsparameter an | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Beispiel unten connection spec , die zusätzliche Informationen darüber enthalten, wo die Parameter target spec in der Verbindungsspezifikation zu finden sind. Im Beispiel unten sehen Sie auch, welche Zielparameter für Zielgruppenexport-Ziele nicht gelten.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec zeigt Zielverbindungsparameter an | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Beispiel unten connection spec , die zusätzliche Informationen darüber enthalten, wo die Parameter target spec in der Verbindungsspezifikation zu finden sind. Im Beispiel unten sehen Sie auch, welche Zielparameter für Zielgruppenexport-Ziele nicht gelten.
|
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec zeigt Zielverbindungsparameter an | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Beispiel unten connection spec , die zusätzliche Informationen darüber enthalten, wo die Parameter target spec in der Verbindungsspezifikation zu finden sind. Im Beispiel unten sehen Sie auch, welche Zielparameter für Zielgruppenexport-Ziele nicht gelten.
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec zeigt Zielverbindungsparameter an | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Beispiel unten connection spec , die zusätzliche Informationen darüber enthalten, wo die Parameter target spec in der Verbindungsspezifikation zu finden sind. Im Beispiel unten sehen Sie auch, welche Zielparameter für Zielgruppenexport-Ziele nicht gelten.
|
accordion | ||
---|---|---|
SFTP - Connection spec zeigt Zielverbindungsparameter an | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Beispiel unten connection spec , die zusätzliche Informationen darüber enthalten, wo die Parameter target spec in der Verbindungsspezifikation zu finden sind. Im Beispiel unten sehen Sie auch, welche Zielparameter für Zielgruppenexport-Ziele nicht gelten.
|
Mithilfe des obigen Spezifikationen können Sie eine zielgerichtete Verbindungsanforderung erstellen, die speziell auf Ihr gewünschtes Cloud-Speicher-Ziel zugeschnitten ist, wie in den Registerkarten unten dargestellt.
Anfrage
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Target-Verbindungsanforderung | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Target-Verbindungsanforderung mit CSV-Optionen | |||||
|
Antwort
accordion | ||
---|---|---|
Target-Verbindung - Antwort | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Target-Verbindungsanforderung | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Target-Verbindungsanforderung mit CSV-Optionen | |||||
|
Antwort
accordion | ||
---|---|---|
Target-Verbindung - Antwort | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Target-Verbindungsanforderung | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Target-Verbindungsanforderung mit CSV-Optionen | |||||
|
Antwort
accordion | ||
---|---|---|
Target-Verbindung - Antwort | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Target-Verbindungsanforderung | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Target-Verbindungsanforderung mit CSV-Optionen | |||||
|
Antwort
accordion | ||
---|---|---|
Target-Verbindung - Antwort | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Target-Verbindungsanforderung | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Target-Verbindungsanforderung mit CSV-Optionen | |||||
|
Antwort
accordion | ||
---|---|---|
Target-Verbindung - Antwort | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
SFTP - Target-Verbindungsanforderung | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Target-Verbindungsanforderung mit CSV-Optionen | |||||
|
Antwort
accordion | ||
---|---|---|
Target-Verbindung - Antwort | ||
|
Beachten Sie die target connection ID
aus der Antwort. Diese ID ist im nächsten Schritt beim Erstellen des Datenflusses für den Zielgruppen-Export erforderlich.
Bei einer erfolgreichen Antwort werden die ID (id
) der neuen Zielquellenverbindung und eine etag
zurückgegeben. Notieren Sie sich die Ziel-Verbindungs-ID, wie Sie sie später beim Erstellen des Datenflusses benötigen.
Erstellen eines Datenflusses create-dataflow
Der nächste Schritt in der Zielkonfiguration besteht darin, einen Datenfluss zu erstellen. Ein Datenfluss verknüpft zuvor erstellte Entitäten und bietet außerdem Optionen zum Konfigurieren des Zeitplans für den Zielgruppenexport. Verwenden Sie zum Erstellen des Datenflusses je nach gewünschtem Cloud-Speicher-Ziel die folgenden Payloads und ersetzen Sie die Kennungen der Flussentität aus vorherigen Schritten. Beachten Sie, dass Sie in diesem Schritt keine Informationen im Zusammenhang mit der Attribut- oder Identitätszuordnung zum Datenfluss hinzufügen. Das wird im nächsten Schritt folgen.
Anfrage
accordion | ||
---|---|---|
Erstellen des Zielgruppen-Export-Datenflusses zum Ziel Amazon S3 - Anfrage | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
Antwort
accordion | ||
---|---|---|
Datenfluss erstellen - Antwort | ||
|
Anfrage
accordion | ||
---|---|---|
Erstellen des Zielgruppen-Export-Datenflusses zum Ziel Azure Blob Storage - Anfrage | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
Antwort
accordion | ||
---|---|---|
Datenfluss erstellen - Antwort | ||
|
Anfrage
accordion | ||
---|---|---|
Erstellen des Zielgruppen-Export-Datenflusses zum Ziel Azure Data Lake Gen 2(ADLS Gen2) - Anfrage | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
Antwort
accordion | ||
---|---|---|
Datenfluss erstellen - Antwort | ||
|
Anfrage
accordion | ||
---|---|---|
Erstellen des Zielgruppen-Export-Datenflusses zum Ziel Data Landing Zone - Anfrage | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
Antwort
accordion | ||
---|---|---|
Datenfluss erstellen - Antwort | ||
|
Anfrage
accordion | ||
---|---|---|
Erstellen des Zielgruppen-Export-Datenflusses zum Ziel Google Cloud Storage - Anfrage | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
Antwort
accordion | ||
---|---|---|
Datenfluss erstellen - Antwort | ||
|
Anfrage
accordion | ||
---|---|---|
Erstellen eines Zielgruppen-Export-Datenflusses zum SFTP-Ziel - Anfrage | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anforderung, wenn Sie die Anforderung kopieren und in Ihr Terminal Ihrer Wahl einfügen.
|
Antwort
accordion | ||
---|---|---|
Datenfluss erstellen - Antwort | ||
|
Notieren Sie die Datenfluss-ID aus der Antwort. Diese ID wird in späteren Schritten benötigt.
Hinzufügen von Zielgruppen zum Export
In diesem Schritt können Sie auch auswählen, welche Zielgruppen Sie an das Ziel exportieren möchten. Ausführliche Informationen zu diesem Schritt und zum Anfrageformat zum Hinzufügen einer Zielgruppe zum Datenfluss finden Sie in den Beispielen im Abschnitt Aktualisieren eines Ziel-Datenflusses der API-Referenzdokumentation.
Einrichten der Attribut- und Identitätszuordnung attribute-and-identity-mapping
Nachdem Sie Ihren Datenfluss erstellt haben, müssen Sie eine Zuordnung für die Attribute und Identitäten einrichten, die Sie exportieren möchten. Dies umfasst drei Schritte, die unten aufgeführt sind:
- Eingabeschema erstellen
- Ausgabeschema erstellen
- Richten Sie einen Zuordnungssatz ein, um die erstellten Schemata zu verbinden.
Um beispielsweise die folgende Zuordnung zu erhalten, die in der Benutzeroberfläche angezeigt wird, müssen Sie die drei oben aufgelisteten und in den nächsten Überschriften detaillierten Schritte ausführen.
Eingabeschema erstellen
Um ein Eingabeschema zu erstellen, müssen Sie zunächst Ihr Vereinigungsschema und die Identitäten abrufen, die an das Ziel exportiert werden können. Dies ist das Schema von Attributen und Identitäten, die Sie als Quellzuordnung auswählen können.
Sehen Sie sich unten Beispiele für Anfragen und Antworten an, um Attribute und Identitäten abzurufen.
Anfrage zum Abrufen von Attributen
code language-shell |
---|
|
Antwort
Die folgende Antwort wurde aus Gründen der Kürze gekürzt.
code language-json |
---|
|
Anforderung zum Abrufen von Identitäten
code language-shell |
---|
|
Antwort
Die Antwort gibt die Identitäten zurück, die Sie beim Erstellen des Eingabeschema verwenden können. Beachten Sie, dass diese Antwort sowohl die in Experience Platform eingerichteten Identitäts-Namespaces standard als auch custom zurückgibt.
code language-json |
---|
|
Als Nächstes müssen Sie die Antwort von oben kopieren und zum Erstellen Ihres Eingabeschema verwenden. Sie können die gesamte JSON-Antwort aus der obigen Antwort kopieren und in das unten angegebene jsonSchema
-Objekt platzieren.
Anfrage zum Erstellen eines Eingabeschema
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Die ID in der Antwort stellt die eindeutige Kennung des von Ihnen erstellten Eingabeschema dar. Kopieren Sie die ID aus der Antwort, da Sie sie in einem späteren Schritt wiederverwenden werden.
Ausgabeschema erstellen
Als Nächstes müssen Sie das Ausgabeschema für Ihren Export einrichten. Zunächst müssen Sie Ihr bestehendes Partnerschema finden und untersuchen.
Anfrage
Beachten Sie, dass im folgenden Beispiel der connection spec ID
für Amazon S3 verwendet wird. Ersetzen Sie diesen Wert durch die für Ihr Ziel spezifische Verbindungsspezifikations-ID.
code language-shell |
---|
|
Antwort mit einem Beispielschema
Inspect die Antwort, die Sie beim Ausführen des oben genannten Aufrufs erhalten haben. Sie müssen einen Drilldown in die Antwort durchführen, um das Objekt targetSpec.attributes.partnerSchema.jsonSchema
zu finden
code language-json |
---|
|
Als Nächstes müssen Sie ein Ausgabeschema erstellen. Kopieren Sie die obige JSON-Antwort und fügen Sie sie in das nachstehende jsonSchema
-Objekt ein.
Anfrage
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Die ID in der Antwort stellt die eindeutige Kennung des von Ihnen erstellten Eingabeschema dar. Kopieren Sie die ID aus der Antwort, da Sie sie in einem späteren Schritt wiederverwenden werden.
Zuordnungssatz erstellen create-mapping-set
Verwenden Sie anschließend die Datenvorbereitung-API , um den Zuordnungssatz mithilfe der Eingabe-Schema-ID, der Ausgabeschema-ID und der gewünschten Feldzuordnungen zu erstellen.
Anfrage
note important |
---|
IMPORTANT |
|
code language-shell line-numbers data-start-1 data-line-offset-4 h-16-38 |
---|
|
Antwort
code language-json |
---|
|
Notieren Sie sich die Kennung des Zuordnungssatzes, wie Sie sie im nächsten Schritt benötigen, um den vorhandenen Datenfluss mit der Zuordnungsset-ID zu aktualisieren.
Rufen Sie als Nächstes die Kennung des Datenflusses ab, den Sie aktualisieren möchten.
Informationen zum Abrufen der Kennung eines Datenflusses finden Sie unter Abrufen der Details eines Ziel-Datenflusses .
Schließlich müssen Sie den Datenfluss mit den soeben erstellten Mapping-Set-Informationen PATCH
auswählen.
Anfrage
code language-shell |
---|
|
Antwort
Die Antwort der Flow Service-API gibt die ID des aktualisierten Datenflusses zurück.
code language-json |
---|
|
Anderen Datenfluss-Updates durchführen other-dataflow-updates
Verwenden Sie den Vorgang PATCH
, um Aktualisierungen an Ihrem Datenfluss vorzunehmen. Sie können beispielsweise Ihren Datenflüssen eine Marketing-Aktion hinzufügen. Oder Sie können Ihren Datenfluss aktualisieren, um Felder als Pflichtschlüssel oder Deduplizierungsschlüssel auszuwählen.
Hinzufügen einer Marketing-Aktion add-marketing-action
Informationen zum Hinzufügen einer Marketing-Aktion finden Sie in den Beispielen für Anfragen und Antworten unten.
If-Match
ist bei einer PATCH
-Anfrage erforderlich. Der Wert für diese Kopfzeile ist die eindeutige Version des Datenflusses, den Sie aktualisieren möchten. Der eTag-Wert wird bei jeder erfolgreichen Aktualisierung einer Flussentität wie Datenfluss, Zielverbindung und anderen aktualisiert.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
-Endpunkt, wobei {ID}
die Datenfluss-ID ist, die Sie aktualisieren möchten.If-Match
in doppelte Anführungszeichen setzen, wie in den Beispielen unten bei der Durchführung von PATCH
-Anfragen.Anfrage
code language-shell |
---|
|
Antwort
Bei einer erfolgreichen Antwort wird zusammen mit der ID des aktualisierten Datenflusses und dem aktualisierten eTag der Antwortcode 200
zurückgegeben.
code language-json |
---|
|
Einen obligatorischen Schlüssel hinzufügen add-mandatory-key
Informationen zum Hinzufügen eines obligatorischen Schlüssels finden Sie in den Beispielen für Anfragen und Antworten unten.
If-Match
ist bei einer PATCH
-Anfrage erforderlich. Der Wert für diese Kopfzeile ist die eindeutige Version des Datenflusses, den Sie aktualisieren möchten. Der eTag-Wert wird bei jeder erfolgreichen Aktualisierung einer Flussentität wie Datenfluss, Zielverbindung und anderen aktualisiert.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
-Endpunkt, wobei {ID}
die Datenfluss-ID ist, die Sie aktualisieren möchten.If-Match
in doppelte Anführungszeichen setzen, wie in den Beispielen unten bei der Durchführung von PATCH
-Anfragen.Anfrage
code language-shell |
---|
|
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Deduplizierungsschlüssel hinzufügen add-deduplication-key
Informationen zum Hinzufügen eines Deduplizierungsschlüssels finden Sie in den unten stehenden Anforderungs- und Antwortbeispielen
If-Match
ist bei einer PATCH
-Anfrage erforderlich. Der Wert für diese Kopfzeile ist die eindeutige Version des Datenflusses, den Sie aktualisieren möchten. Der eTag-Wert wird bei jeder erfolgreichen Aktualisierung einer Flussentität wie Datenfluss, Zielverbindung und anderen aktualisiert.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
-Endpunkt, wobei {ID}
die Datenfluss-ID ist, die Sie aktualisieren möchten.If-Match
in doppelte Anführungszeichen setzen, wie in den Beispielen unten bei der Durchführung von PATCH
-Anfragen.Anfrage
code language-shell |
---|
|
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Validieren des Datenflusses (Abrufen der Datenflüsse) get-dataflow-runs
Um die Ausführungen eines Datenflusses zu überprüfen, verwenden Sie die DataFlow-Ausführungen-API:
Anfrage
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Informationen zu den verschiedenen Parametern, die von der DataFlow-Ausführungs-API zurückgegeben werden, finden Sie in der API-Referenzdokumentation.
Umgang mit API-Fehlern api-error-handling
Die API-Endpunkte in diesem Tutorial folgen den allgemeinen Experience Platform API-Fehlermeldungsprinzipien. Weitere Informationen zur Interpretation von Fehlerantworten finden Sie unter API-Status-Codes und Fehler in der Anforderungsheader im Handbuch zur Fehlerbehebung für Platform.
Nächste Schritte next-steps
In diesem Tutorial haben Sie Platform erfolgreich mit einem Ihrer bevorzugten Cloud-Speicher-Ziele verbunden und einen Datenfluss zum entsprechenden Ziel eingerichtet, um Zielgruppen zu exportieren. Auf den folgenden Seiten finden Sie weitere Details, z. B. wie Sie vorhandene Datenflüsse mit der Flow Service-API bearbeiten: