> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/de/data-api/data-overview-1/syncing-data-via-file-protocols-1.md). # Daten über Dateiprotokolle synchronisieren In diesem Abschnitt werden die Protokolle erläutert, die unterstützt werden von Epsilon Retail Media und bietet Richtlinien für die Benennung von Dateien, um automatische Downloads von Ihrem Server zu optimieren. Für sichere Downloads senden Sie Ihrem Epsilon Retail Media -Vertreter die erforderlichen Details – Protokolltyp, Host, Port, Dateipfad – und alle erforderlichen Authentifizierungsdaten wie Benutzername und Passwort. Sie müssen Ihre Datendateien auf dem Server speichern, um den Abruf über Standardprotokolle wie Google Cloud Storage (GCS), HTTPS und SFTP zu ermöglichen. ## Unterstützte Protokolle Hier sind die unterstützten Protokolle, die sichere Methoden für die Speicherung und Übertragung von Dateien bieten und eine sichere Kommunikation mit Epsilon Retail Media -Systemen gewährleisten. ### GCS (empfohlen) GCS ist unser bevorzugter Mechanismus für die Dateispeicherung und den Dateiabruf aufgrund seiner robusten Sicherheitsfunktionen und der nahtlosen Integration mit Epsilon Retail Media -Systemen gewährleisten. ### HTTPS Das HTTPS-Protokoll bietet eine sichere Methode für die Dateiübertragung, indem es eine passwortbasierte Authentifizierung unterstützt. Dies gewährleistet eine verschlüsselte Kommunikation zwischen Ihrem Server und Epsilon Retail Media. {% hint style="warning" %} Größere Dateien werden besser über GCS synchronisiert Feeds mit mehr als 100.000 Produkten werden am besten über die Bucket-Methodik synchronisiert, um die Leistung zu verbessern. {% endhint %} ### SFTP Bei Verwendung des Secure File Transfer Protocol (SFTP) Epsilon Retail Media unterstützt zwei Authentifizierungsmethoden zum Herunterladen von Datendateien: * **Benutzername und Passwort**: Diese Standardmethode verwendet Zugangsdaten zur Authentifizierung des Zugriffs. * **Authentifizierung mit öffentlichem Schlüssel**: Sie können auch den Epsilon Retail Mediaöffentlichen Schlüssel von verwenden. Stellen Sie hierfür sicher, dass der unten angegebene öffentliche Schlüssel auf Ihrem SFTP-Server installiert ist, um sichere Dateiübertragungen zu ermöglichen. #### Staging ``` ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDMd4w5Z6hsjlUc0/r3dTJ+IaM9Mm+l3ZTrX3D5+30ZNiAb3Mhvlp8gv37CFKzqM90oFejl15bbr5dymjycsOWInxqkMyLOTbdMFAk7hmicNvN5bt3tx/Z0UewNvAx0Uw9Qxu7SCMSAalk9l7dqLp5RFFj+RHq9ApV8KIA/Fw2mjCw2vrJhiRWeuUuNNQTbGFBA5y72ATeYA2p0ZK3/TTJxyxCL70zGVxFG0jdAurfXKujYaF73Ql/gl5wmtnxGvTORtvObQdc2jCTsynj1w17LSZAdeoPQGnQkVCk37ZUnWTw8s4RYjHFVunsTDxJO5Qnw5yj8oqhe5IdpQyavUj+otRd6900q/3dK60IELH6AFz+ZEqudlBh8ZO2hvHIDS2Ii5S3LunlejykAVdRl7RVHA17Pk3mmrHCS6i3n9ZliBYeVQiKme2jHVB+ESrHFxQWl3ct9MYFNlAqwuhTFQRSG9ioSEHX5Dnmqk8aqbm/4pYY4b7YHOcIpHrtrVrFTJ3vLM1If1OVrDQidFhi1ArmoCU+PO65jNSeMj27m/HoX7Mbcmi8F++Op3MgP8iJrohE0Wjz+use7nlDtQTtDxDeEQQYGqsz4DOtH/jn1TWRynaXZqwPqC5Q6b52QM22T+E3rgT/4G7yJU3IRKioByOck251MEtOEgSCvvIAaV685fQ== ``` #### Produktion ``` ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQCtpIUFoYu8OUesZGP9rffv6/hky1HbQCAhC8hNRmcWpdptzRYsKIZFPz9t2vb85dierTZqJstAEJkePHd25cZ8btIBacbAR49avCIXiBuVgvlJk1+Er2dyYqSzSeFhpzlZxi4CkGo/Nsx7yxPi5693fdVF3vr+/iencw1tdLJJXfT6j1YLBCREg+IziBCO6m9P0QQGEDXYvsOmIzl0CJ8enU7gjvnYL5ify1/aGpoXv9/XcCYJWXTQmvmISknOMdC4pBiuDqsE9CX27FLQQb1ZT5jNrqD5hFsEo0rWqLiCbb5qoxIdMSe/IbA+sewgpgTPNJXeCNLSSH/MHhj2IgiMZGDDDaVaqMZD7N2jeQdI6SQbgvXiLTTUL4gNyO5eN9oqoeJumeZMi0+MQ7kkfHDYGtKe3RMxL7heL650HL+eWDIybezyPdQmfyVew9KuN0uB+2X+2NxQs8ZLqow486XDfUDfo+rPuoIvkYy7Z8ox+gne+1iAk43TCekcDwxlc56R9muMtGLuzzg1x9s9MqsAg5JNWEPQ8giAwCQJwm7h3UcCY3TJCn0LUzYHc7Ycr11JfIXL47vYGH3C0XBYlbEU/8m4VhhexzgJi8G/reclY5pfjtwQGOiobsxLsWgGx6Qoz/qWqmGwQIg+qi7jvA7jnltUP+RTFZpmd18/dSxB+w== ``` ## Datenkomprimierung und -verschlüsselung Bevor Sie Daten zur Synchronisierung auf Ihren Server hochladen, müssen Sie die Dateien möglicherweise komprimieren und verschlüsseln. Wenn sowohl Komprimierung als auch Verschlüsselung für Datendateien verwendet werden, Epsilon Retail Media geht davon aus, dass die Komprimierung vor der Verschlüsselung erfolgt. * Für die Datenkomprimierung unterstützen wir die Formate zip und gzip. Aufgrund besserer Komprimierungsraten und breiter Unterstützung empfehlen wir jedoch gzip gegenüber zip. Komprimierte Dateien werden vor der Verarbeitung entpackt. * Zur Datenverschlüsselung werden Dateien beim Download entschlüsselt. Verwenden Sie die bereitgestellten öffentlichen Schlüssel, um Dateien vor dem Hochladen auf Ihren Server zu verschlüsseln. So wird sichergestellt, dass nur Epsilon Retail Media sicher auf die Daten zugreifen kann. ## Dateibenennungskonvention Um zu ermöglichen, Epsilon Retail Media Ihre Datendatei herunterzuladen und zu verarbeiten, müssen Sie Details zu Protokoll, Host, Port und Dateipfad angeben. Wählen Sie eine günstige tägliche Uhrzeit, um sicherzustellen, dass Ihre Datendatei auf dem Server bereitsteht, da Epsilon Retail Media sie jeden Tag herunterladen wird. Der einfachste Ansatz zur Angabe einer täglichen Zieldatei für Epsilon Retail Medias Downloads ist die Verwendung eines expliziten Dateinamens. Dies ermöglicht Epsilon Retail Media die Datei direkt von Ihrem Server abzurufen. Für diejenigen, die die Protokolle FTP, FTPS oder SFTP verwenden, bieten wir auch zusätzliche Methoden zur Angabe von Zieldateien über sogenannte Zieldatei-Modi an. Diese Optionen umfassen: * Rolling\_earliest * Rolling\_earliest\_24\_hours * Rolling\_latest * Rolling\_latest\_24\_hours. Bei der Auswahl eines Zieldatei-Modus müssen Sie eine textbasierte Vorlage für Datendateinamen angeben. Diese Vorlage enthält eine spezielle Zeichenfolge, `{\*}`, die hilft, Epsilon Retail Media Dateinamen auf Ihrem Server abzugleichen und jeden Tag die richtige Datei auszuwählen. Betrachten Sie beispielsweise die Vorlage `ERMCatalogData_AU_{\*}.txt`. Diese Vorlage erfordert, dass Dateinamen beginnen mit `ERMCatalogData_AU` und enden mit `.txt`. Bei Verwendung dieser Vorlage würden die folgenden Dateinamen übereinstimmen: `ERMCatalogProduct_AU_20190315.txt` `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190312.txt` Um das Herunterladen von Datendateien zu vermeiden, die sich noch im Hochladevorgang befinden, Epsilon Retail Media lädt nur Dateien herunter, die zuletzt mehr als eine Minute vor dem Zugriff auf den Server geändert wurden. Obwohl mehrere Dateien mit der Vorlage übereinstimmen können, Epsilon Retail Media verarbeitet jeweils nur eine Datei. Die Auswahl der geeigneten Datei aus mehreren Kandidaten wird durch den gewählten Zieldatei-Modus gesteuert, der unten ausführlich beschrieben wird. ### Rolling\_earliest In diesem Zieldatei-Modus werden Dateien basierend auf der angegebenen Namensvorlage gefiltert. Nach dem Filtern werden die Dateien in aufsteigender Reihenfolge ihrer Namen sortiert, und die erste Datei in dieser Reihenfolge wird für den Download ausgewählt. Wenn die Dateinamensvorlage beispielsweise lautet `ERMCatalogData_AU_{\*}.txt` und die gefilterte Liste der Dateinamen Folgendes enthält: `ERMCatalogProduct_AU_20190312.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190314.txt` In diesem Modus wird dann die Datei `ERMCatalogProduct_AU_20190312.txt` für den Download ausgewählt. ### Rolling\_earliest\_24\_hours In diesem Zieldatei-Modus werden Dateien zunächst basierend auf der angegebenen Namensvorlage gefiltert. Aus der gefilterten Liste werden nur Dateien berücksichtigt, die innerhalb der letzten 24 Stunden geändert wurden. Die Dateien werden dann in aufsteigender Reihenfolge nach Namen sortiert, und die erste Datei in dieser Reihenfolge wird für den Download ausgewählt. Nehmen wir beispielsweise an, die aktuelle Uhrzeit ist `2019-03-15 10:30:07`, und die Dateinamensvorlage lautet `ERMCatalogData_AU_{\*}.txt`. Wenn die gefilterte Liste der Dateinamen Folgendes enthält: | Dateiname | Zuletzt geändert | | ----------------------------------- | ----------------- | | ERMCatalogProduct\_AU\_20190312.txt | 13/03/19 15:35:11 | | ERMCatalogProduct\_AU\_20190313.txt | 13/03/19 15:35:08 | | ERMCatalogProduct\_AU\_20190314.txt | 14/03/19 15:35:10 | | ERMCatalogProduct\_AU\_20190315.txt | 15/03/19 10:05:07 | In diesem Modus wird dann die Datei `ERMCatalogProduct_AU_20190314.txt` für den Download ausgewählt. ### Rolling\_latest In diesem Zieldatei-Modus werden Dateien basierend auf der angegebenen Namensvorlage gefiltert. Nach dem Filtern werden die Dateien in absteigender Reihenfolge nach ihren Namen sortiert. Die erste Datei in dieser sortierten Liste wird für den Download ausgewählt. Wenn die Dateinamensvorlage beispielsweise lautet `ERMCatalogData_AU_{\*}.txt`, und die gefilterte Liste der Dateinamen Folgendes enthält: `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190312.txt` In diesem Modus wird dann die Datei `ERMCatalogProduct_AU_20190314.txt` wird für den Download ausgewählt. Dieser Modus ähnelt Rolling\_earliest, aber anstatt die Dateien in aufsteigender Reihenfolge zu sortieren, werden sie in absteigender Reihenfolge sortiert. ### Rolling\_latest\_24\_hours In diesem Zieldatei-Modus werden Dateien zunächst mithilfe der angegebenen Namensvorlage gefiltert. Aus der gefilterten Liste werden nur Dateien berücksichtigt, die innerhalb der letzten 24 Stunden geändert wurden. Die Dateien werden dann in absteigender Reihenfolge nach ihren Namen sortiert, und die erste Datei in dieser Reihenfolge wird für den Download ausgewählt. Nehmen wir beispielsweise an, die aktuelle Uhrzeit ist `2019-03-15 10:30:07`, und die Dateinamensvorlage lautet `ERMCatalogData_AU_{\*}.txt`. Wenn die gefilterte Liste der Dateinamen Folgendes enthält: | Dateiname | Zuletzt geändert | | ----------------------------------- | ----------------- | | ERMCatalogProduct\_AU\_20190312.txt | 13/03/19 15:35:11 | | ERMCatalogProduct\_AU\_20190313.txt | 13/03/19 15:35:08 | | ERMCatalogProduct\_AU\_20190314.txt | 14/03/19 15:35:10 | | ERMCatalogProduct\_AU\_20190315.txt | 15/03/19 10:05:07 | In diesem Modus wird dann die Datei `ERMCatalogProduct_AU_20190315.txt` wird für den Download ausgewählt. Dieser Modus ähnelt Rolling\_earliest\_24\_hours, aber hier werden die Dateien in absteigender statt in aufsteigender Reihenfolge sortiert. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.citrusad.com/retail-media-interface/integration/de/data-api/data-overview-1/syncing-data-via-file-protocols-1.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.