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
- Lesen Sie die Abschnitte, um über die Benutzeroberfläche von Platform eine Verbindung zu Ihrem SFTP-Speicherort herzustellen Mit Ziel verbinden und Aktivieren von Zielgruppen für dieses Ziel unten.
- Um eine programmgesteuerte Verbindung zu Ihrem SFTP-Speicherort herzustellen, lesen Sie den Abschnitt Aktivieren von Zielgruppen für dateibasierte Ziele mithilfe des Tutorials zur Flow Service-API.
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.
Exportieren von Datensätzen export-datasets
Dieses Ziel unterstützt Datensatzexporte. Vollständige Informationen zum Einrichten von Datensatzexporten finden Sie in den Tutorials:
Dateiformat der exportierten Daten file-format
Beim Exportieren Zielgruppendaten, erstellt Platform eine .csv, parquetoder .json -Datei an dem Speicherort gespeichert, den Sie bereitgestellt haben. Weitere Informationen zu den Dateien finden Sie unter unterstützte Dateiformate für den Export im Tutorial zur Aktivierung der Zielgruppe.
Beim Exportieren Datensätze, erstellt Platform eine .parquet oder .json -Datei an dem Speicherort gespeichert, den Sie bereitgestellt haben. Weitere Informationen zu den Dateien finden Sie unter Ü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 die SFTP mit Kennwort Authentifizierungstyp für die Verbindung mit Ihrem SFTP-Speicherort:
-
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 bei der Identifizierung 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 aus, das Experience Platform für die exportierten Dateien verwenden soll. Wenn Sie CSV können Sie auch 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 JSON-Manifestdatei mit Informationen zum Exportspeicherort, zur Exportgröße und mehr enthalten. Das Manifest wird im Format
manifest-<<destinationId>>-<<dataflowRunId>>.json. Anzeigen von Beispielmanifestdatei. Die Manifestdatei enthält die folgenden Felder:flowRunId: Die dataflow run die die exportierte Datei generiert hat.scheduledTime: Die Uhrzeit in UTC, zu der die Datei exportiert wurde.exportResults.sinkPath: Der Pfad in Ihrem Speicherort, unter dem die exportierte Datei abgelegt wird.exportResults.name: Der Name der exportierten Datei.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 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.
Siehe Aktivieren von Zielgruppendaten für Batch-Profil-Export-Ziele für Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel.
Ü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
Siehe Abschnitt IP-Adressen-Zulassungsliste , wenn Sie Adobe-IPs zu einer Zulassungsliste hinzufügen müssen.