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 zur Auswahl der Dateityp der exportierten Datei.
- 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 Flussdienst-API , um qualifizierte Profile aus Adobe Experience Platform in 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 das Erstellen von Zielgruppen und das Generieren von Zielgruppen in Adobe Experience Platform aus dem Real-Time Customer Profile Daten.
- 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
Für den Export von Profilen benötigen Sie die Ziele anzeigen, Ziele aktivieren, Anzeigen von Profilen, und Segmente anzeigen Zugriffssteuerungsberechtigungen. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
Export identities, benötigen Sie die Identitätsdiagramm anzeigen Zugriffsberechtigung.
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 Aufrufe an Platform APIs verwenden, müssen Sie zunächst die Tutorial zur Experience Platform-Authentifizierung. 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}
Bei allen Anfragen, die eine Payload enthalten (POST, PUT, PATCH), ist eine zusätzliche Medientyp-Kopfzeile 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. Siehe Abschnitt Flussdienst - Dokumentation zur Ziel-API 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 Glossarabschnitt 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 | ||
---|---|---|
Retrieve connection spec für Amazon S3 | ||
|
Antwort
accordion | ||
---|---|---|
Amazon S3 - Verbindungsspezifikation | ||
|
Anfrage
accordion | ||
---|---|---|
Retrieve connection spec für Azure Blob Storage | ||
|
Antwort
accordion | ||
---|---|---|
Azure Blob Storage – Connection spec | ||
|
Anfrage
accordion | ||
---|---|---|
Retrieve connection spec für Azure Data Lake Gen 2(ADLS Gen2) | ||
|
Antwort
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) – Connection spec | ||
|
Anfrage
accordion | ||
---|---|---|
Retrieve connection spec für Data Landing Zone(DLZ) | ||
|
Antwort
accordion | ||
---|---|---|
Data Landing Zone(DLZ) – Connection spec | ||
|
Anfrage
accordion | ||
---|---|---|
Retrieve connection spec für Google Cloud Storage | ||
|
Antwort
accordion | ||
---|---|---|
Google Cloud Storage – Connection spec | ||
|
Anfrage
accordion | ||
---|---|---|
Retrieve 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. Stellen Sie sicher, dass Sie die richtige connection spec
und flow spec
für das Ziel, das Sie konfigurieren.
Erstellen einer Quellverbindung 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.
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 ID (id
) der neu erstellten Quellverbindung und einer etag
. Notieren Sie sich die Kennung der Quellverbindung, wie Sie sie später beim Erstellen des Datenflusses benötigen.
Erstellen einer Basisverbindung create-base-connection
A 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, wie im Abschnitt beschrieben Auswählen des Ziels, an das Zielgruppen exportiert werden sollen und dann die authSpec
der Antwort. Verweisen Sie auf die folgenden Registerkarten für die authSpec
Eigenschaften aller unterstützten Ziele.
accordion | ||
---|---|---|
Amazon S3 - Connection spec Anzeige auth spec | ||
Beachten Sie die hervorgehobene Zeile mit Inline-Kommentaren im connection spec Beispiel unten, das zusätzliche Informationen darüber bereitstellt, wo die Authentifizierungsparameter in der connection spec.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec Anzeige auth spec | ||
Beachten Sie die hervorgehobene Zeile mit Inline-Kommentaren im connection spec Beispiel unten, das zusätzliche Informationen darüber bereitstellt, wo die Authentifizierungsparameter in der connection spec.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec Anzeige auth spec | ||
Beachten Sie die hervorgehobene Zeile mit Inline-Kommentaren im connection spec Beispiel unten, das zusätzliche Informationen darüber bereitstellt, wo die Authentifizierungsparameter in der connection spec.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Connection spec Anzeige auth spec | |||||
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec Anzeige auth spec | ||
Beachten Sie die hervorgehobene Zeile mit Inline-Kommentaren im connection spec Beispiel unten, das zusätzliche Informationen darüber bereitstellt, wo die Authentifizierungsparameter in der connection spec.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Connection spec Anzeige auth spec | |||||
Beachten Sie die hervorgehobene Zeile mit Inline-Kommentaren im connection spec Beispiel unten, das zusätzliche Informationen darüber bereitstellt, wo die Authentifizierungsparameter in der connection spec.
|
Verwenden der im Authentifizierungsspezifikat 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 - Basierende 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.
|
++Amazon S3 - Basisverbindungsanforderung mit übernommener Rollenauthentifizierung
note tip |
---|
TIP |
Informationen zum Abrufen der erforderlichen Authentifizierungsberechtigungen finden Sie im Abschnitt beim Ziel authentifizieren auf der Zieldokumentationsseite für Amazon S3. |
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.
code language-shell line-numbers data-start-1 data-line-offset-4 h-17 |
---|
|
+++
Antwort
accordion | ||
---|---|---|
Amazon S3 Basisverbindungsantwort | ||
|
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
. 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 die Exportparameter für die exportierten Zielgruppen speichern. 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 in der Seite mit Dateiformatierungskonfigurationen.
Siehe Abschnitt targetSpec
Eigenschaften, die im connection spec
, um die unterstützten Eigenschaften für jeden Zieltyp zu verstehen. Verweisen Sie auf die folgenden Registerkarten für die targetSpec
Eigenschaften aller unterstützten Ziele.
accordion | ||
---|---|---|
Amazon S3 - Connection spec Anzeigen der Zielverbindungsparameter | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im connection spec Beispiel unten, das zusätzliche Informationen darüber bereitstellt, wo die target spec Parameter in der Verbindungsspezifikation. Im folgenden Beispiel sehen Sie auch, welche Zielparameter not für Zielgruppenexport-Ziele.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec Anzeigen der Zielverbindungsparameter | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im connection spec Beispiel unten, das zusätzliche Informationen darüber bereitstellt, wo die target spec Parameter in der Verbindungsspezifikation. Im folgenden Beispiel sehen Sie auch, welche Zielparameter not für Zielgruppenexport-Ziele.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec Anzeigen der Zielverbindungsparameter | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im connection spec Beispiel unten, das zusätzliche Informationen darüber bereitstellt, wo die target spec Parameter in der Verbindungsspezifikation. Im folgenden Beispiel sehen Sie auch, welche Zielparameter not für Zielgruppenexport-Ziele.
|
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec Anzeigen der Zielverbindungsparameter | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im connection spec Beispiel unten, das zusätzliche Informationen darüber bereitstellt, wo die target spec Parameter in der Verbindungsspezifikation. Im folgenden Beispiel sehen Sie auch, welche Zielparameter not für Zielgruppenexport-Ziele.
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec Anzeigen der Zielverbindungsparameter | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im connection spec Beispiel unten, das zusätzliche Informationen darüber bereitstellt, wo die target spec Parameter in der Verbindungsspezifikation. Im folgenden Beispiel sehen Sie auch, welche Zielparameter not für Zielgruppenexport-Ziele.
|
accordion | ||
---|---|---|
SFTP - Connection spec Anzeigen der Zielverbindungsparameter | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im connection spec Beispiel unten, das zusätzliche Informationen darüber bereitstellt, wo die target spec Parameter in der Verbindungsspezifikation. Im folgenden Beispiel sehen Sie auch, welche Zielparameter not für Zielgruppenexport-Ziele.
|
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.
Eine erfolgreiche Antwort gibt die ID (id
) der neuen Zielquellenverbindung und einer etag
. 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. A dataflow verknüpft zuvor erstellte Entitäten und bietet außerdem Optionen zum Konfigurieren des Zielgruppenexport-Zeitplans. 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 Datenflusses zum Zielgruppenexport in Amazon S3 destination - Request | ||
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 Datenflusses zum Zielgruppenexport in Azure Blob Storage destination - Request | ||
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 Datenflusses zum Zielgruppenexport in Azure Data Lake Gen 2(ADLS Gen2) destination - Request | ||
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 Datenflusses zum Zielgruppenexport in Data Landing Zone destination - Request | ||
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 Datenflusses zum Zielgruppenexport in Google Cloud Storage destination - Request | ||
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 dem Anfrageformat zum Hinzufügen einer Zielgruppe zum Datenfluss finden Sie in den Beispielen in der Ziel-Datenfluss aktualisieren Abschnitt 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 Ihre Vereinigungsschema und die Identitäten, 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 beide standard und custom Identitäts-Namespaces, die Sie unter Experience Platform einrichten.
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 die jsonSchema
unten angegeben.
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 die Variable connection spec ID
für Amazon S3. 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 zu finden targetSpec.attributes.partnerSchema.jsonSchema
code language-json |
---|
|
Als Nächstes müssen Sie ein Ausgabeschema erstellen. Kopieren Sie die oben angegebene JSON-Antwort und fügen Sie sie in die jsonSchema
-Objekt weiter unten.
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 als Nächstes das 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.
Siehe Abrufen der Details eines Ziel-Datenflusses für Informationen zum Abrufen der Kennung eines Datenflusses.
Schließlich müssen Sie den Datenfluss mit den soeben erstellten Mapping-Set-Informationen PATCH.
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 die PATCH
operation.Beispielsweise können Sie Ihre Datenflüsse aktualisieren, um Felder als Pflichtschlüssel oder Deduplizierungsschlüssel auszuwählen.
Einen obligatorischen Schlüssel hinzufügen add-mandatory-key
So fügen Sie eine Pflichtschlüsselfinden Sie unten die Beispiele für Anfragen und Antworten .
Anfrage
code language-shell |
---|
|
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Deduplizierungsschlüssel hinzufügen add-deduplication-key
So fügen Sie eine Deduplizierungsschlüsselfinden Sie unten die Beispiele für Anfragen und Antworten .
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 Verschiedene Parameter, die von der DataFlow-Ausführungs-API zurückgegeben werden in der API-Referenzdokumentation.
Umgang mit API-Fehlern api-error-handling
Die API-Endpunkte in diesem Tutorial folgen den allgemeinen Experience Platform API-Fehlermeldungsprinzipien. Siehe Abschnitt API-Statuscodes und Fehler in der Anfragekopfzeile Weitere Informationen zur Interpretation von Fehlerantworten finden Sie im Handbuch zur Fehlerbehebung bei 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: