> 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/sk/data-api/data-overview-1/syncing-data-via-file-protocols-1.md). # Synchronizácia údajov prostredníctvom súborových protokolov Táto časť vysvetľuje protokoly podporované spoločnosťou Epsilon Retail Media a poskytuje pokyny na pomenovanie súborov na zjednodušenie automatického sťahovania z vášho servera. Pre bezpečné sťahovanie pošlite svojmu Epsilon Retail Media zástupcovi potrebné údaje – typ protokolu, hostiteľa, port, cestu k súboru – a všetky požadované overovacie údaje, ako je používateľské meno a heslo. Svoje dátové súbory musíte uložiť na serveri, aby ste umožnili ich získavanie prostredníctvom štandardných protokolov, ako sú Google Cloud Storage (GCS), HTTPS a SFTP. ## Podporované protokoly Tu sú podporované protokoly, ktoré ponúkajú bezpečné metódy ukladania a prenosu súborov a zaisťujú bezpečnú komunikáciu so systémami Epsilon Retail Media . ### GCS (odporúčané) GCS je náš preferovaný mechanizmus na ukladanie a získavanie súborov vďaka svojim robustným bezpečnostným funkciám a bezproblémovej integrácii s Epsilon Retail Media . ### HTTPS Protokol HTTPS poskytuje bezpečné spájanie na prenos súborov tým, že podporuje overovanie pomocou hesla. To zaisťuje šifrovanú komunikáciu medzi vaším serverom a Epsilon Retail Media. {% hint style="warning" %} Väčšie súbory sa lepšie synchronizujú cez GCS Feedy s viac ako 100 000 produktmi sa najlepšie synchronizujú metódou bucketov, aby sa zvýšil výkon. {% endhint %} ### SFTP Pri použití protokolu na bezpečný prenos súborov (SFTP) Epsilon Retail Media podporuje dve metódy overenia na sťahovanie dátových súborov: * **Používateľské meno a heslo**: Táto štandardná metóda používa na overenie prístupu prihlasovacie údaje. * **Overenie verejným kľúčom**: Môžete použiť aj Epsilon Retail Mediaverejný kľúč. Pre túto možnosť sa uistite, že verejný kľúč poskytnutý nižšie je nainštalovaný na vašom SFTP serveri, aby sa uľahčili bezpečné prenosy súborov. #### 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== ``` #### Produkcia ``` 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== ``` ## Kompresia a šifrovanie údajov Pred odovzdaním údajov na server na synchronizáciu budete možno musieť súbory skomprimovať a zašifrovať. Ak sa na dátové súbory použije kompresia aj šifrovanie, Epsilon Retail Media predpokladá, že kompresia prebehne pred šifrovaním. * Pre kompresiu údajov podporujeme formáty zip a gzip. Odporúčame však gzip namiesto zip kvôli lepším kompresným pomerom a rozsiahlosti podpory. Skomprimované súbory sa pred spracovaním dekomprimujú. * Pokiaľ ide o šifrovanie údajov, súbory sa po stiahnutí dešifrujú. Pred odovzdaním na server použite poskytnuté verejné kľúče na zašifrovanie súborov, čím sa zaistí, že k údajom bude mať bezpečný prístup iba Epsilon Retail Media . ## Konvencia pomenovania súborov Aby ste umožnili Epsilon Retail Media sťahovať a spracovávať váš dátový súbor, musíte poskytnúť informácie o protokole, hostiteľovi, porte a ceste k súboru. Vyberte si vhodný denný čas, aby ste sa uistili, že váš dátový súbor je pripravený na serveri, pretože Epsilon Retail Media ho bude sťahovať každý deň. Najjednoduchší prístup k určeniu denného cieľového súboru pre Epsilon Retail Mediasťahovanie je použitie explicitného názvu súboru. To umožňuje Epsilon Retail Media priamo získať súbor z vášho servera. Pre tých, ktorí používajú protokoly FTP, FTPS alebo SFTP, ponúkame aj ďalšie metódy na určenie cieľových súborov prostredníctvom takzvaných režimov cieľových súborov (target file modes). Tieto možnosti zahŕňajú: * Rolling\_earliest * Rolling\_earliest\_24\_hours * Rolling\_latest * Rolling\_latest\_24\_hours. Výber režimu cieľového súboru vyžaduje, aby ste poskytli textovú šablónu pre názvy dátových súborov. Táto šablóna obsahuje špeciálny reťazec, `{\*}`, ktorý pomáha Epsilon Retail Media zhodovať názvy súborov na vašom serveri a vybrať správny súbor každý deň. Zvážte napríklad šablónu `ERMCatalogData_AU_{\*}.txt`. Táto šablóna vyžaduje, aby sa názvy súborov začínali na `ERMCatalogData_AU` a končili na `.txt`. S použitím tejto šablóny by sa zhodovali nasledujúce názvy súborov: `ERMCatalogProduct_AU_20190315.txt` `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190312.txt` Aby sa predišlo sťahovaniu dátových súborov, ktoré sa stále odovzdávajú, Epsilon Retail Media sťahuje iba súbory, ktoré boli naposledy upravené viac ako jednu minútu pred prístupom na server. Hoci šablóne môže zodpovedať viacero súborov, Epsilon Retail Media spracováva naraz iba jeden súbor. Výber vhodného súboru z viacerých kandidátov sa riadi zvoleným režimom cieľového súboru, ktorý je podrobne popísaný nižšie. ### Rolling\_earliest V tomto režime cieľového súboru sa súbory filtrujú na základe poskytnutej šablóny názvu. Po vyfiltrovaní sa súbory zoradia vo vzostupnom poradí podľa ich názvov a na stiahnutie sa vyberie prvý súbor v tomto poradí. Ak je napríklad šablóna názvu súboru `ERMCatalogData_AU_{\*}.txt` a vyfiltrovaný zoznam názvov súborov obsahuje nasledujúce položky: `ERMCatalogProduct_AU_20190312.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190314.txt` V tomto režime sa potom na stiahnutie vyberie súbor `ERMCatalogProduct_AU_20190312.txt` . ### Rolling\_earliest\_24\_hours V tomto režime cieľového súboru sa súbory najskôr vyfiltrujú na základe zadefinovanej šablóny názvu. Z vyfiltrovaného zoznamu sa berú do úvahy iba súbory upravené za posledných 24 hodín. Súbory sa potom zoradia vo vzostupnom poradí podľa názvu a na stiahnutie sa vyberie prvý súbor v tomto poradí. Predpokladajme napríklad, že aktuálny čas je `2019-03-15 10:30:07`a šablóna názvu súboru je `ERMCatalogData_AU_{\*}.txt`. Ak vyfiltrovaný zoznam názvov súborov obsahuje nasledujúce položky: | Názov súboru | Naposledy upravené | | ----------------------------------- | ------------------ | | 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 | V tomto režime sa potom na stiahnutie vyberie súbor `ERMCatalogProduct_AU_20190314.txt` . ### Rolling\_latest V tomto režime cieľového súboru sa súbory filtrujú na základe zadefinovanej šablóny názvu. Po vyfiltrovaní sa súbory zoradia v zostupnom poradí podľa ich názvov. Prvý súbor v tomto zoradenom zozname sa vyberie na stiahnutie. Ak je napríklad šablóna názvu súboru `ERMCatalogData_AU_{\*}.txt`a vyfiltrovaný zoznam názvov súborov obsahuje nasledujúce položky: `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190312.txt` V tomto režime sa potom na stiahnutie vyberie súbor `ERMCatalogProduct_AU_20190314.txt` sa vyberie na stiahnutie. Tento režim je podobný ako Rolling\_earliest, ale namiesto zoradenia súborov vo vzostupnom poradí sa zoradia v zostupnom poradí. ### Rolling\_latest\_24\_hours V tomto režime cieľového súboru sa súbory najskôr vyfiltrujú pomocou zadefinovanej šablóny názvu. Z vyfiltrovaného zoznamu sa berú do úvahy iba súbory upravené za posledných 24 hodín. Súbory sa potom zoradia v zostupnom poradí podľa ich názvov a prvý súbor v tomto poradí sa vyberie na stiahnutie. Predpokladajme napríklad, že aktuálny čas je `2019-03-15 10:30:07`a šablóna názvu súboru je `ERMCatalogData_AU_{\*}.txt`. Ak vyfiltrovaný zoznam názvov súborov obsahuje: | Názov súboru | Naposledy upravené | | ----------------------------------- | ------------------ | | 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 | V tomto režime sa potom na stiahnutie vyberie súbor `ERMCatalogProduct_AU_20190315.txt` sa vyberie na stiahnutie. Tento režim je podobný ako Rolling\_earliest\_24\_hours, ale súbory sa tu triedia v zostupnom poradí namiesto vzostupného. --- # 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/sk/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.