SFTP-Verbindung
Ziel-Änderungsprotokoll changelog
Mit der Experience Platform-Version vom Juli 2023 bietet das SFTP-Ziel neue Funktionen, wie unten aufgeführt:
- Unterstützung für den Datensatzexport.
- Zusätzliche Dateibenennungsoptionen.
- Möglichkeit zum Festlegen benutzerdefinierter Datei-Kopfzeilen in exportierten Dateien durch den verbesserten Zuordnungsschritt.
- Möglichkeit zum Anpassen der Formatierung exportierter CSV-Datendateien.
Übersicht overview
Stellen Sie mit Ihrem SFTP-Server eine aktive ausgehende Verbindung her, um durch Trennzeichen getrennte Datendateien regelmäßig von Adobe Experience Platform zu exportieren.
Verbindung zu SFTP über API oder Benutzeroberfläche herstellen connect-api-or-ui
- Um über die Platform-Benutzeroberfläche eine Verbindung zu Ihrem SFTP-Speicherort herzustellen, lesen Sie die Abschnitte Verbindung zum Ziel herstellen und Zielgruppen für dieses Ziel aktivieren unten.
- Um programmgesteuert eine Verbindung zu Ihrem SFTP-Speicherort herzustellen, lesen Sie das Tutorial 🔗 zur Fluss-Service-API, um mithilfe von Zielgruppen für dateibasierte Ziele aktivieren zu können.
Unterstützte Zielgruppen supported-audiences
In diesem Abschnitt wird beschrieben, welche Zielgruppentypen Sie an dieses Ziel exportieren können.
Exporttyp und -häufigkeit export-type-frequency
Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.
Datensätze exportieren export-datasets
Dieses Ziel unterstützt Datensatzexporte. Vollständige Informationen zum Einrichten von Datensatzexporten finden Sie in den Tutorials:
- Exportieren von Datensätzen mithilfe der Platform-Benutzeroberfläche🔗.
- So exportieren Datensätze programmgesteuert mit der Flow Service-API.
Dateiformat der exportierten Daten file-format
Beim Exportieren von Zielgruppendaten erstellt Platform eine .csv
-, parquet
- oder .json
-Datei am von Ihnen angegebenen Speicherort. Weitere Informationen zu den Dateien finden Sie im Abschnitt Unterstützte Dateiformate für den Export im Tutorial zur Aktivierung der Zielgruppe.
Beim Exportieren von Datensätzen erstellt Platform eine .parquet
- oder .json
-Datei am von Ihnen angegebenen Speicherort. Weitere Informationen zu den Dateien finden Sie im Abschnitt Überprüfen des erfolgreichen Datensatzexports im Tutorial zum Exportieren von Datensätzen.
Herstellen einer Verbindung mit dem Ziel connect
Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Tutorial zur Zielkonfiguration beschrieben vor. Füllen Sie im Workflow zum Konfigurieren des Ziels die Felder aus, die in den beiden folgenden Abschnitten aufgeführt sind.
Authentifizierungsinformationen authentication-information
Wenn Sie den Authentifizierungstyp SFTP mit Kennwort auswählen, um eine Verbindung zu Ihrem SFTP-Speicherort herzustellen:
-
Domäne: Die Adresse Ihres SFTP-Speicherorts;
-
Benutzername: Der Benutzername, mit dem Sie sich bei Ihrem SFTP-Speicherort anmelden.
-
Port: Der von Ihrem SFTP-Speicherort verwendete Port.
-
Passwort: Das Passwort, mit dem Sie sich bei Ihrem SFTP-Speicherort anmelden.
-
Verschlüsselungsschlüssel: Optional können Sie Ihren RSA-formatierten öffentlichen Schlüssel anhängen, um Ihren exportierten Dateien eine Verschlüsselung hinzuzufügen. Ein Beispiel für einen korrekt formatierten Verschlüsselungsschlüssel finden Sie in der folgenden Abbildung.
Wenn Sie den Authentifizierungstyp SFTP mit SSH-Schlüssel für die Verbindung mit Ihrem SFTP-Speicherort auswählen:
-
Domain: Geben Sie die IP-Adresse oder den Domain-Namen Ihres SFTP-Kontos ein.
-
Port: Der von Ihrem SFTP-Speicherort verwendete Port.
-
Benutzername: Der Benutzername, mit dem Sie sich bei Ihrem SFTP-Speicherort anmelden.
-
SSH-Schlüssel: Der private SSH-Schlüssel, der zum Anmelden bei Ihrem SFTP-Speicherort verwendet wird. Der private Schlüssel muss eine im RSA-Format formatierte Base64-kodierte Zeichenfolge sein und darf nicht kennwortgeschützt sein.
-
Verschlüsselungsschlüssel: Optional können Sie Ihren RSA-formatierten öffentlichen Schlüssel anhängen, um Ihren exportierten Dateien eine Verschlüsselung hinzuzufügen. Ein Beispiel für einen korrekt formatierten Verschlüsselungsschlüssel finden Sie in der folgenden Abbildung.
Zieldetails destination-details
Geben Sie nach Herstellung der Authentifizierungsverbindung zum SFTP-Speicherort die folgenden Informationen für das Ziel ein:
-
Name: Geben Sie einen Namen ein, der Ihnen beim Identifizieren dieses Ziels in der Experience Platform-Benutzeroberfläche hilft.
-
Beschreibung: Geben Sie eine Beschreibung für dieses Ziel ein.
-
Ordnerpfad: Geben Sie den Pfad zum Ordner in Ihrem SFTP-Speicherort ein, in den die Dateien exportiert werden sollen.
-
Dateityp: Wählen Sie das Format, das Experience Platform für die exportierten Dateien verwenden soll. Wenn Sie die Option CSV auswählen, können Sie auch die Dateiformatierungsoptionen konfigurieren.
-
Komprimierungsformat: Wählen Sie den Komprimierungstyp aus, den Experience Platform für die exportierten Dateien verwenden soll.
-
Manifestdatei einschließen: Schalten Sie diese Option ein, wenn Sie möchten, dass die Exporte eine Manifest-JSON-Datei mit Informationen zum Exportspeicherort, zur Exportgröße und mehr enthalten. Das Manifest wird mit dem Format
manifest-<<destinationId>>-<<dataflowRunId>>.json
benannt. Anzeigen einer Beispielmanifestdatei. Die Manifestdatei enthält die folgenden Felder:flowRunId
: Der Datenfluss-Lauf , der die exportierte Datei generiert hat.scheduledTime
: Die Uhrzeit in UTC, zu der die Datei exportiert wurde.exportResults.sinkPath
: Der Pfad in Ihrem Speicherort, an dem die exportierte Datei abgelegt wird.- 0: Der Name der exportierten Datei.
exportResults.name
size
: Die Größe der exportierten Datei in Byte.
Aktivieren von Zielgruppen für dieses Ziel activate
- Um Daten zu aktivieren, 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"}
Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Zielgruppendaten für Batch-Profilexportziele .
Überprüfen auf einen erfolgreichen Datenexport exported-data
Um zu überprüfen, ob die Daten erfolgreich exportiert wurden, überprüfen Sie Ihren SFTP-Speicher und stellen Sie sicher, dass die exportierten Dateien die erwarteten Profilpopulationen enthalten.
Zulassungsliste von IP-Adressen ip-address-allow-list
Lesen Sie den Artikel IP-Adresse Zulassungsliste, wenn Sie einer Adobe IPs hinzufügen müssen.