> 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/hu/data-api/data-overview-1/syncing-data-via-file-protocols-1.md). # Adatok szinkronizálása fájlprotokollokon keresztül Ez a szakasz az alábbiak által támogatott protokollokat ismerteti: Epsilon Retail Media és útmutatást nyújt a fájlok elnevezéséhez a szerverről történő automatikus letöltések egyszerűsítése érdekében. A biztonságos letöltésekhez adja meg a Epsilon Retail Media képviselőjének a szükséges részleteket – protokoll típusa, host, port, fájlútvonal – és a szükséges hitelesítési adatait, például a felhasználónevet és a jelszót. Az adatfájlokat a szerveren kell tárolnia, hogy lehetővé tegye a lekérést az olyan szabványos protokollokon keresztül, mint a Google Cloud Storage (GCS), a HTTPS és az SFTP. ## Támogatott protokollok Íme a támogatott protokollok, amelyek biztonságos módszereket kínálnak a fájltárolásra és -átvitelre, garantálva a biztonságos kommunikációt a következőkkel: Epsilon Retail Media rendszerek. ### GCS (ajánlott) A GCS a preferált mechanizmusunk a fájlok tárolására és lekérésére, köszönhetően robusztus biztonsági funkcióinak és a következőkkel való zökkenőmentes integrációjának: Epsilon Retail Media rendszerek. ### HTTPS A HTTPS protokoll biztonságos módszert biztosít a fájlátvitelhez a jelszóalapú hitelesítés támogatásával. Ez biztosítja az titkosított kommunikációt a szerver és a következők között: Epsilon Retail Media. {% hint style="warning" %} A nagyobb fájlokat jobb GCS-en keresztül szinkronizálni A 100 000 terméknél nagyobb feedeket a jobb teljesítmény érdekében célszerű bucket módszertannal szinkronizálni. {% endhint %} ### SFTP A Secure File Transfer Protocol (SFTP) használatakor a(z) Epsilon Retail Media két hitelesítési módszert támogat az adatfájlok letöltéséhez: * **Felhasználónév és jelszó**: Ez a szabványos módszer hitelesítő adatokat használ a hozzáférés hitelesítéséhez. * **Nyilvános kulcsos hitelesítés**: Használhatja a következőt is: Epsilon Retail Medianyilvános kulcsa. Ehhez győződjön meg arról, hogy az alább megadott nyilvános kulcs telepítve van az SFTP-szerverén a biztonságos fájlátvitel elősegítése érdekében. #### 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== ``` #### Produkciós ``` 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== ``` ## Adattömörítés és -titkosítás Mielőtt adatokat töltene fel a szerverre a szinkronizáláshoz, előfordulhat, hogy tömörítenie és titkosítania kell a fájlokat. Ha mind a tömörítést, mind a titkosítást alkalmazza az adatfájlokon, a(z) Epsilon Retail Media feltételezi, hogy a tömörítés a titkosítás előtt történik. * Adattömörítésre a zip és gzip formátumokat támogatjuk. Ennek ellenére a gzip használatát javasoljuk a zip helyett a jobb tömörítési aránya és széles körű támogatottsága miatt. A tömörített fájlok a feldolgozás előtt kibontásra kerülnek. * Adattitkosítás esetén a fájlok a letöltéskor kerülnek dekódolásra. Használja a megadott nyilvános kulcsokat a fájlok titkosításához, mielőtt feltöltené őket a szerverre, biztosítva, hogy csak a(z) Epsilon Retail Media férhessen hozzá az adatokhoz biztonságosan. ## Fájlelnevezési konvenció Ahhoz, hogy a(z) Epsilon Retail Media letölthesse és feldolgozhassa az adatfájlt, meg kell adnia a protokollt, a hostot, a portot és a fájlútvonal részleteit. Válasszon egy kényelmes napi időpontot annak biztosítására, hogy az adatfájl készen álljon a szerveren, mivel a(z) Epsilon Retail Media minden nap le fogja tölteni azt. A legegyszerűbb megközelítés egy napi célfájl meghatározására a(z) Epsilon Retail Medialetöltéseihez egy explicit fájlnév használata. Ez lehetővé teszi a(z) Epsilon Retail Media számára, hogy közvetlenül lekérje a fájlt a szerveréről. Az FTP, FTPS vagy SFTP protokollokat használók számára további módszereket is kínálunk a célfájlok meghatározására az úgynevezett célfájl-módokon keresztül. Ezek a opciók a következők: * Rolling\_earliest * Rolling\_earliest\_24\_hours * Rolling\_latest * Rolling\_latest\_24\_hours. A célfájl-mód kiválasztásához meg kell adnia egy szövegalapú sablont az adatfájlok neveihez. Ez a sablon tartalmaz egy speciális karakterláncot, `{\*}`, amely segít a(z) Epsilon Retail Media számára a fájlnevek párosításában a szerveren, és a megfelelő fájl kiválasztásában minden nap. Például vegyük a következő sablont: `ERMCatalogData_AU_{\*}.txt`. Ez a sablon megköveteli, hogy a fájlnevek a következővel kezdődjenek: `ERMCatalogData_AU` és a következővel végződjenek: `.txt`. Ennek a sablonnak a használatával a következő fájlnevek felelnének meg: `ERMCatalogProduct_AU_20190315.txt` `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190312.txt` A még feltöltés alatt álló adatfájlok letöltésének elkerülése érdekében a(z) Epsilon Retail Media csak olyan fájlokat tölt le, amelyeket több mint egy perccel a szerver elérése előtt módosítottak utoljára. Bár több fájl is megfelelhet a sablonnak, a(z) Epsilon Retail Media egyszerre csak egy fájlt dolgoz fel. A megfelelő fájl kiválasztása több jelölt közül a kiválasztott célfájl-mód alapján történik, amelyet az alábbiakban részletesen tárgyalunk. ### Rolling\_earliest Ebben a célfájl-módban a fájlok szűrése a megadott névsablon alapján történik. A szűrés után a fájlok a nevük növekvő sorrendjébe kerülnek rendezésre, és az ebben a sorrendben szereplő első fájl kerül kiválasztásra letöltésre. Például, ha a fájlnév-sablon `ERMCatalogData_AU_{\*}.txt` és a szűrt fájlnevek listája a következőket tartalmazza: `ERMCatalogProduct_AU_20190312.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190314.txt` Ebben a módban a(z) `ERMCatalogProduct_AU_20190312.txt` fájl kerül kiválasztásra letöltésre. ### Rolling\_earliest\_24\_hours Ebben a célfájl-módban a fájlok kezdetben a megadott névsablon alapján kerülnek szűrésre. A szűrt listából csak az elmúlt 24 órában módosított fájlok kerülnek figyelembevételre. A fájlok ezután név szerint növekvő sorrendbe rendeződnek, és az ebben a sorrendben szereplő első fájl kerül kiválasztásra letöltésre. Például tételezzük fel, hogy a jelenlegi idő `2019-03-15 10:30:07`, és a fájlnév-sablon `ERMCatalogData_AU_{\*}.txt`. Ha a szűrt fájlnevek listája a következőket tartalmazza: | Fájlnév | Utoljára módosítva | | ----------------------------------- | ------------------ | | 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 | Ebben a módban a(z) `ERMCatalogProduct_AU_20190314.txt` fájl kerül kiválasztásra letöltésre. ### Rolling\_latest Ebben a célfájl-módban a fájlok szűrése a megadott névsablon alapján történik. A szűrés után a fájlok a nevük alapján csökkenő sorrendbe rendeződnek. Az ebben a rendezett listában szereplő első fájl kerül kiválasztásra letöltésre. Például, ha a fájlnév-sablon `ERMCatalogData_AU_{\*}.txt`, és a szűrt fájlnevek listája a következőket tartalmazza: `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190312.txt` Ebben a módban a(z) `ERMCatalogProduct_AU_20190314.txt` kerül kiválasztásra letöltésre. Ez a mód hasonló a Rolling\_earliest módhoz, de a fájlok növekvő sorrendbe rendezése helyett csökkenő sorrendbe kerülnek rendezésre. ### Rolling\_latest\_24\_hours Ebben a célfájl-módban a fájlok kezdetben a megadott névsablon használatával kerülnek szűrésre. A szűrt listából csak az elmúlt 24 órában módosított fájlok kerülnek figyelembevételre. A fájlok ezután nevük alapján csökkenő sorrendbe rendeződnek, és az ebben a sorrendben szereplő első fájl kerül kiválasztásra letöltésre. Például tételezzük fel, hogy a jelenlegi idő `2019-03-15 10:30:07`, és a fájlnév-sablon `ERMCatalogData_AU_{\*}.txt`. Ha a szűrt fájlnevek listája a következőket tartalmazza: | Fájlnév | Utoljára módosítva | | ----------------------------------- | ------------------ | | 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 | Ebben a módban a(z) `ERMCatalogProduct_AU_20190315.txt` kerül kiválasztásra letöltésre. Ez a mód hasonló a Rolling\_earliest\_24\_hours módhoz, de itt a fájlok csökkenő sorrendbe vannak rendezve a növekvő helyett. --- # 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/hu/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.