Aktivieren von Zielgruppen für dateibasierte Ziele mithilfe der Flow Service-API
Verwenden Sie die erweiterten Dateiexportfunktionen, um beim Exportieren von Dateien vom Experience Platform auf erweiterte Anpassungsfunktionen zuzugreifen:
- Zusätzliche Dateibenennungsoptionen.
- Möglichkeit zum Festlegen benutzerdefinierter Datei-Kopfzeilen in exportierten Dateien durch den verbesserten Zuordnungsschritt.
- Möglichkeit zur Auswahl des Dateityps der exportierten Datei.
- Möglichkeit zum Anpassen der Formatierung exportierter CSV-Datendateien.
Diese Funktion wird von den sechs unten aufgeführten Cloud-Speicherkarten unterstützt:
In diesem Artikel wird der Arbeitsablauf erläutert, der für die Verwendung der Flow Service-API zum Exportieren qualifizierter Profile aus Adobe Experience Platform an einen der oben verknüpften Cloud-Speicherorte erforderlich ist.
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 können Sie aus Ihren Real-Time Customer Profile-Daten Zielgruppen erstellen und Zielgruppen in Adobe Experience Platform 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 kennen müssen, um Daten für dateibasierte Ziele in Platform zu aktivieren.
Erforderliche Berechtigungen permissions
Zum Exportieren von Profilen benötigen Sie die Berechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigenZugriffssteuerungsberechtigungen. 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.
{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 aufzurufen, müssen Sie zunächst das Experience Platform-Authentifizierungs-Tutorial 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 mit einer Payload (POST
, PUT
, PATCH
) ist eine zusätzliche Kopfzeile vom Typ „Medien“ 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 Dokumentation zur Flow Service - Ziele-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 stoßen werden, finden Sie im Glossarabschnitt der API-Referenzdokumentation.
Auswählen des Ziels, in das Zielgruppen exportiert werden sollen select-destination
Bevor Sie den Workflow zum Exportieren von Profilen starten, identifizieren Sie die Verbindungsspezifikations- und Flussspezifikations-IDs 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 die verschiedenen Flow Service-Entitäten zu erstellen. Sie müssen auch auf Teile der Verbindungsspezifikation selbst verweisen, um bestimmte Entitäten einzurichten, damit Sie die Verbindungsspezifikation aus Flow Service-APIs abrufen können. Nachfolgend finden Sie die Beispiele zum Abrufen von Verbindungsspezifikationen für alle Ziele in der Tabelle:
Anfrage
accordion | ||
---|---|---|
connection spec für Amazon S3 abrufen | ||
|
Antwort
accordion | ||
---|---|---|
Amazon S3 - Verbindungsspezifikation | ||
|
Anfrage
accordion | ||
---|---|---|
connection spec für Azure Blob Storage abrufen | ||
|
Antwort
accordion | ||
---|---|---|
Azure Blob Storage – Connection spec | ||
|
Anfrage
accordion | ||
---|---|---|
connection spec für Azure Data Lake Gen 2(ADLS Gen2 abrufen) | ||
|
Antwort
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) – Connection spec | ||
|
Anfrage
accordion | ||
---|---|---|
connection spec für Data Landing Zone(DLZ) abrufen | ||
|
Antwort
accordion | ||
---|---|---|
Data Landing Zone(DLZ) – Connection spec | ||
|
Anfrage
accordion | ||
---|---|---|
connection spec für Google Cloud Storage abrufen | ||
|
Antwort
accordion | ||
---|---|---|
Google Cloud Storage – Connection spec | ||
|
Anfrage
accordion | ||
---|---|---|
connection spec für SFTP abrufen | ||
|
Antwort
accordion | ||
---|---|---|
SFTP - Connection spec | ||
|
Gehen Sie wie folgt vor, um einen Zielgruppenexport-Datenfluss zu einem Cloud-Speicherziel einzurichten. Für einige Schritte unterscheiden sich die Anfragen und Antworten zwischen den verschiedenen Cloud-Speicher-Zielen. Verwenden Sie in diesen Fällen die Registerkarten auf der Seite, um die Anfragen und Antworten abzurufen, die spezifisch für das Ziel sind, mit dem Sie eine Verbindung herstellen und zu dem Sie Audiences exportieren möchten. Stellen Sie sicher, dass Sie die richtigen connection spec
und flow spec
für das Ziel verwenden, 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.
Anfrage
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Bei einer erfolgreichen Antwort werden die ID (id
) der neu erstellten Quellverbindung und ein etag
zurückgegeben. Notieren Sie sich die Quellverbindungs-ID, da Sie sie später beim Erstellen des Datenflusses benötigen werden.
Erstellen einer Basisverbindung create-base-connection
Eine Basisverbindung speichert die Anmeldeinformationen sicher in Ihrem Ziel. Je nach Zieltyp können die Anmeldeinformationen, die zur Authentifizierung für dieses Ziel erforderlich sind, variieren. Um diese Authentifizierungsparameter zu finden, rufen Sie zunächst die connection spec
für Ihr gewünschtes Ziel ab, wie im Abschnitt Auswählen des Ziels, in das Zielgruppen exportiert werden sollen beschrieben, und sehen Sie sich dann die authSpec
der Antwort an. Auf den folgenden Registerkarten finden Sie die authSpec
Eigenschaften aller unterstützten Ziele.
accordion | ||
---|---|---|
Amazon S3 - Connection spec mit auth spec | ||
Beachten Sie die hervorgehobene Zeile mit Inline-Kommentaren im folgenden connection spec, 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 folgenden connection spec, 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 folgenden connection spec, 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 folgenden connection spec, die zusätzliche Informationen darüber enthalten, wo die Authentifizierungsparameter in der connection spec zu finden sind.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Connection spec mit auth spec | |||||
Beachten Sie die hervorgehobene Zeile mit Inline-Kommentaren im folgenden connection spec, 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 Beispielen unten dargestellt:
Anfrage
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Basisverbindungsanfrage 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 Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Basisverbindungsanfrage mit angenommener Rollenauthentifizierung | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
Antwort
accordion | ||
---|---|---|
Antwort der Amazon S3-Basisverbindung | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Basisverbindungsanfrage | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
Antwort
accordion | ||
---|---|---|
Azure Blob Storage - Antwort der Basisverbindung | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Basisverbindungsanfrage | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
Antwort
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Antwort der Basisverbindung | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Basisverbindungsanfrage | |||||
|
Antwort
accordion | ||
---|---|---|
Data Landing Zone - Antwort der Basisverbindung | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Basisverbindungsanfrage | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
Antwort
accordion | ||
---|---|---|
Google Cloud Storage - Antwort der Basisverbindung | ||
|
Anfrage
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP mit Passwort - Basisverbindungsanfrage | |||||||||||||||||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SFTP mit SSH-Schlüssel - Basisverbindungsanfrage | |||||||||||||||||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
Antwort
accordion | ||
---|---|---|
SFTP - Antwort auf Basisverbindung | ||
|
Hinzufügen einer Verschlüsselung zu exportierten Dateien
Optional können Sie Ihren exportierten Dateien eine Verschlüsselung hinzufügen. Dazu müssen Sie Elemente aus dem encryptionSpecs
hinzufügen. Im folgenden Anfragebeispiel sind die obligatorischen Parameter hervorgehoben:
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, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
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. Zielgruppenverbindungen 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. Weitere Informationen zu allen unterstützten CSV-Exportoptionen finden Sie auf der Seite Dateiformatierungskonfigurationen.
Die unterstützten Eigenschaften für jeden Zieltyp werden in den im -connection spec
des Ziels bereitgestellten targetSpec
-Eigenschaften beschrieben. Auf den folgenden Registerkarten finden Sie die targetSpec
Eigenschaften aller unterstützten Ziele.
accordion | ||
---|---|---|
Amazon S3 - Connection spec mit Zielverbindungsparametern | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im folgenden connection spec, die zusätzliche Informationen darüber enthalten, wo die target spec in der Verbindungsspezifikation zu finden sind. Im folgenden Beispiel können Sie auch sehen, welche Zielgruppenparameter für Zielgruppenexportziele nicht anwendbar sind.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec mit Zielverbindungsparametern | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im folgenden connection spec, die zusätzliche Informationen darüber enthalten, wo die target spec in der Verbindungsspezifikation zu finden sind. Im folgenden Beispiel können Sie auch sehen, welche Zielgruppenparameter für Zielgruppenexportziele nicht anwendbar sind.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec mit Zielverbindungsparametern | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im folgenden connection spec, die zusätzliche Informationen darüber enthalten, wo die target spec in der Verbindungsspezifikation zu finden sind. Im folgenden Beispiel können Sie auch sehen, welche Zielgruppenparameter für Zielgruppenexportziele nicht anwendbar sind.
|
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec mit Zielverbindungsparametern | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im folgenden connection spec, die zusätzliche Informationen darüber enthalten, wo die target spec in der Verbindungsspezifikation zu finden sind. Im folgenden Beispiel können Sie auch sehen, welche Zielgruppenparameter für Zielgruppenexportziele nicht anwendbar sind.
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec mit Zielverbindungsparametern | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im folgenden connection spec, die zusätzliche Informationen darüber enthalten, wo die target spec in der Verbindungsspezifikation zu finden sind. Im folgenden Beispiel können Sie auch sehen, welche Zielgruppenparameter für Zielgruppenexportziele nicht anwendbar sind.
|
accordion | ||
---|---|---|
SFTP - Connection spec mit Zielverbindungsparametern | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im folgenden connection spec, die zusätzliche Informationen darüber enthalten, wo die target spec in der Verbindungsspezifikation zu finden sind. Im folgenden Beispiel können Sie auch sehen, welche Zielgruppenparameter für Zielgruppenexportziele nicht anwendbar sind.
|
Mithilfe der obigen Spezifikation können Sie eine Zielverbindungsanfrage für Ihr gewünschtes Cloud-Speicher-Ziel erstellen, wie in den folgenden Registerkarten dargestellt.
Anfrage
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Target-Verbindungsanfrage | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Target-Verbindungsanfrage mit CSV-Optionen | |||||
|
Antwort
accordion | ||
---|---|---|
Zielverbindung - Antwort | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Target-Verbindungsanfrage | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Target-Verbindungsanfrage mit CSV-Optionen | |||||
|
Antwort
accordion | ||
---|---|---|
Zielverbindung - Antwort | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Target-Verbindungsanfrage | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Target-Verbindungsanfrage mit CSV-Optionen | |||||
|
Antwort
accordion | ||
---|---|---|
Zielverbindung - Antwort | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Target-Verbindungsanfrage | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Target-Verbindungsanfrage mit CSV-Optionen | |||||
|
Antwort
accordion | ||
---|---|---|
Zielverbindung - Antwort | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Target-Verbindungsanfrage | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Target-Verbindungsanfrage mit CSV-Optionen | |||||
|
Antwort
accordion | ||
---|---|---|
Zielverbindung - Antwort | ||
|
Anfrage
accordion | |||||
---|---|---|---|---|---|
SFTP - Target-Verbindungsanfrage | |||||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Target-Verbindungsanfrage mit CSV-Optionen | |||||
|
Antwort
accordion | ||
---|---|---|
Zielverbindung - Antwort | ||
|
Notieren Sie die target connection ID
aus der Antwort. Diese ID ist im nächsten Schritt beim Erstellen des Datenflusses zum Exportieren von Zielgruppen erforderlich.
Bei einer erfolgreichen Antwort werden die ID (id
) der neu erstellten Zielquellenverbindung und ein etag
zurückgegeben. Notieren Sie sich die Zielverbindungs-ID, da Sie sie später beim Erstellen des Datenflusses benötigen werden.
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 auch Optionen zum Konfigurieren des Zeitplans für den Zielgruppenexport. Verwenden Sie zum Erstellen des Datenflusses die folgenden Payloads, je nach dem gewünschten Cloud-Speicher-Ziel, und ersetzen Sie die Fluss-Entitäts-IDs aus den 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 eines Zielgruppenexport-Datenflusses zu Amazon S3 Ziel - Anfrage | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
Antwort
accordion | ||
---|---|---|
Datenfluss erstellen - Antwort | ||
|
Anfrage
accordion | ||
---|---|---|
Erstellen eines Zielgruppenexport-Datenflusses zu Azure Blob Storage Ziel - Anfrage | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
Antwort
accordion | ||
---|---|---|
Datenfluss erstellen - Antwort | ||
|
Anfrage
accordion | ||
---|---|---|
Erstellen eines Zielgruppenexport-Datenflusses zu Azure Data Lake Gen 2(ADLS Gen2) Ziel - Anfrage | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
Antwort
accordion | ||
---|---|---|
Datenfluss erstellen - Antwort | ||
|
Anfrage
accordion | ||
---|---|---|
Erstellen eines Zielgruppenexport-Datenflusses zu Data Landing Zone Ziel - Anfrage | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
Antwort
accordion | ||
---|---|---|
Datenfluss erstellen - Antwort | ||
|
Anfrage
accordion | ||
---|---|---|
Erstellen eines Zielgruppenexport-Datenflusses zu Google Cloud Storage Ziel - Anfrage | ||
Beachten Sie die hervorgehobenen Zeilen mit Inline-Kommentaren im Anfragebeispiel, die zusätzliche Informationen bereitstellen. Entfernen Sie die Inline-Kommentare in der Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
Antwort
accordion | ||
---|---|---|
Datenfluss erstellen - Antwort | ||
|
Anfrage
accordion | ||
---|---|---|
Erstellen eines Zielgruppenexport-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 Anfrage, wenn Sie die Anfrage in das Terminal Ihrer Wahl kopieren.
|
Antwort
accordion | ||
---|---|---|
Datenfluss erstellen - Antwort | ||
|
Notieren Sie die Datenfluss-ID aus der Antwort. Diese ID ist in späteren Schritten erforderlich.
Audiences zum Export hinzufügen
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 AktualisierenZieldatenflusses“ 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
- Zuordnungssatz einrichten, 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 aufgeführten und in den nächsten Überschriften beschriebenen Schritte durchlaufen.
Eingabeschema erstellen
Um ein Eingabeschema zu erstellen, müssen Sie zunächst Ihr Vereinigungsschema“die Identitäten abrufen, die an das Ziel exportiert werden können. Dies ist das Schema der Attribute und Identitäten, die Sie als Quellzuordnung auswählen können.
Nachfolgend finden Sie Beispiele für Anfragen und Antworten zum Abrufen von Attributen und Identitäten.
Anforderung zum Abrufen von Attributen
code language-shell |
---|
|
Antwort
Die unten stehende Antwort wurde zur Vereinfachung gekürzt.
code language-json |
---|
|
Anfrage zum Abrufen von Identitäten
code language-shell |
---|
|
Antwort
Die Antwort gibt die Identitäten zurück, die Sie beim Erstellen des Eingabeschemas verwenden können. Beachten Sie, dass diese Antwort sowohl standardmäßige als auch benutzerdefinierte Identity-Namespaces zurückgibt, die Sie in Experience Platform eingerichtet haben.
code language-json |
---|
|
Als Nächstes müssen Sie die Antwort von oben kopieren und zum Erstellen Ihres Eingabeschemas verwenden. Sie können die gesamte JSON-Antwort aus der obigen Antwort kopieren und in das unten angegebene jsonSchema
-Objekt einfügen.
Anforderung zum Erstellen des Eingabeschemas
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Die ID in der Antwort stellt die eindeutige Kennung des von Ihnen erstellten Eingabeschemas 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 vorhandenes Partnerschema finden und überprüfen.
Anfrage
Beachten Sie, dass im folgenden Beispiel die 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 durch den obigen Aufruf erhalten. 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 oben erhaltene JSON-Antwort und fügen Sie sie unten in das jsonSchema
ein.
Anfrage
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Die ID in der Antwort stellt die eindeutige Kennung des von Ihnen erstellten Eingabeschemas 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 Datenvorbereitungs-API um den Zuordnungssatz mithilfe der Eingabeschema-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 die ID des Zuordnungssatzes, da Sie sie im nächsten Schritt benötigen werden, um den vorhandenen Datenfluss mit der Zuordnungssatz-ID zu aktualisieren.
Rufen Sie als Nächstes die ID des Datenflusses ab, den Sie aktualisieren möchten.
Weitere zum Abrufen der ID eines Datenflusses findenunter „Abrufen der Details Zieldatenflusses“.
Schließlich müssen Sie den Datenfluss mit den soeben erstellten Zuordnungssatzinformationen PATCH
.
Anfrage
code language-shell |
---|
|
Antwort
Die Antwort von der Flow Service-API gibt die ID des aktualisierten Datenflusses zurück.
code language-json |
---|
|
Vornehmen anderer Datenfluss-Aktualisierungen other-dataflow-updates
Um Aktualisierungen an Ihrem Datenfluss vorzunehmen, verwenden Sie den Vorgang PATCH
. Sie können beispielsweise eine Marketing-Aktion zu Ihren Datenflüssen hinzufügen. Sie können Ihre Datenflüsse auch aktualisieren, um Felder als obligatorische Schlüssel oder Deduplizierungsschlüssel auszuwählen.
Hinzufügen einer Marketing-Aktion add-marketing-action
Um eine Marketing-Aktion hinzuzufügen, sehen Sie sich die folgenden Anfrage- und Antwortbeispiele an.
PATCH
-Anfrage ist die If-Match
-Kopfzeile 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 aktualisiert, z. B. Datenfluss, Zielverbindung und andere.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
-Endpunkt durch, wobei {ID}
die Datenfluss-ID ist, die Sie aktualisieren möchten.PATCH
Anfragen den Wert des If-Match
-Headers in doppelte Anführungszeichen setzen, wie in den Beispielen unten.Anfrage
code language-shell |
---|
|
Antwort
Bei einer erfolgreichen Antwort wird der Antwort-Code 200
zusammen mit der ID des aktualisierten Datenflusses und dem aktualisierten eTag zurückgegeben.
code language-json |
---|
|
Obligatorischen Schlüssel hinzufügen add-mandatory-key
Informationen zum Hinzufügen obligatorischen Schlüssels finden Sie in den Beispielen für Anfragen und Antworten unten.
PATCH
-Anfrage ist die If-Match
-Kopfzeile 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 aktualisiert, z. B. Datenfluss, Zielverbindung und andere.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
-Endpunkt durch, wobei {ID}
die Datenfluss-ID ist, die Sie aktualisieren möchten.PATCH
Anfragen den Wert des If-Match
-Headers in doppelte Anführungszeichen setzen, wie in den Beispielen unten.Anfrage
code language-shell |
---|
|
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Deduplizierungsschlüssel hinzufügen add-deduplication-key
Informationen zum Hinzufügen Deduplizierungsschlüssels finden Sie in den Anfrage- und Antwortbeispielen unten
PATCH
-Anfrage ist die If-Match
-Kopfzeile 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 aktualisiert, z. B. Datenfluss, Zielverbindung und andere.https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
-Endpunkt durch, wobei {ID}
die Datenfluss-ID ist, die Sie aktualisieren möchten.PATCH
Anfragen den Wert des If-Match
-Headers in doppelte Anführungszeichen setzen, wie in den Beispielen unten.Anfrage
code language-shell |
---|
|
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Datenfluss validieren (Datenflussausführungen abrufen) get-dataflow-runs
Um die Ausführungen eines Datenflusses zu überprüfen, verwenden Sie die Datenflussausführungs-API:
Anfrage
code language-shell |
---|
|
Antwort
code language-json |
---|
|
Informationen zu den verschiedenen von der Datenflussausführungs-API zurückgegebenen Parametern“ finden Sieder API-Referenzdokumentation.
Umgang mit API-Fehlern api-error-handling
Die API-Endpunkte in diesem Tutorial folgen den allgemeinen Grundsätzen für Experience Platform-API-Fehlermeldungen. Weitere Informationen Interpretieren von Fehlerantworten finden Sie unterAPI-Status-Codes undFehler in der Anfragekopfzeile im Handbuch zur Platform-Fehlerbehebung .
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: