> 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/cs/data-api/data-overview-1/syncing-data-via-file-protocols-1.md). # Synchronizace dat pomocí souborových protokolů Tato část vysvětluje protokoly podporované společností Epsilon Retail Media a poskytuje pokyny pro pojmenování souborů s cílem zefektivnit automatické stahování z vašeho serveru. Pro bezpečné stahování zašlete zástupci společnosti Epsilon Retail Media potřebné údaje—typ protokolu, hostitele, port, cestu k souboru—a veškeré požadované přihlašovací údaje, jako je uživatelské jméno a heslo. Své datové soubory musíte uložit na serveru, abyste umožnili jejich načítání prostřednictvím standardních protokolů, jako jsou Google Cloud Storage (GCS), HTTPS a SFTP. ## Podporované protokoly Zde jsou podporované protokoly, které nabízejí bezpečné metody ukládání a přenosu souborů a zajišťují bezpečnou komunikaci se systémy Epsilon Retail Media . ### GCS (doporučeno) GCS je náš preferovaný mechanismus pro ukládání a načítání souborů díky svým robustním bezpečnostním funkcím a bezproblémové integraci se společností Epsilon Retail Media . ### HTTPS Protokol HTTPS poskytuje bezpečnou metodu přenosu souborů podporou autentizace na základě hesla. To zajišťuje šifrovanou komunikaci mezi vaším serverem a společností Epsilon Retail Media. {% hint style="warning" %} Větší soubory je lepší synchronizovat přes GCS Zdrojová data s více než 100 000 produkty je nejlepší synchronizovat metodou bucketů, aby se zlepšil výkon. {% endhint %} ### SFTP Při použití protokolu pro bezpečný přenos souborů (SFTP) podporuje Epsilon Retail Media dva způsoby autentizace pro stahování datových souborů: * **Uživatelské jméno a heslo**: Tato standardní metoda používá k autentizaci přístupu přihlašovací údaje. * **Autentizace veřejným klíčem**: Můžete také použít veřejný klíč společnosti Epsilon Retail Media. Za tímto účelem se ujistěte, že níže uvedený veřejný klíč je nainstalován na vašem SFTP serveru, což usnadní bezpečné přenosy souborů. #### 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== ``` #### Produkce ``` 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== ``` ## Komprese a šifrování dat Před nahráním dat na server k synchronizaci může být nutné soubory zkomprimovat a zašifrovat. Pokud se u datových souborů použije komprese i šifrování, Epsilon Retail Media předpokládá, že komprese probíhá před šifrováním. * Pro kompresi dat podporujeme formáty zip a gzip. Doporučujeme však gzip před zip vzhledem k jeho lepším kompresním poměrům a široké podpoře. Zkomprimované soubory jsou před zpracováním dekomprimovány. * V případě šifrování dat se soubory po stažení dešifrují. K zašifrování souborů před nahráním na váš server použijte poskytnuté veřejné klíče, čímž zajistíte, že k datům bude mít bezpečný přístup pouze společnost Epsilon Retail Media . ## Konvence pojmenování souborů S cílem umožnit společnosti Epsilon Retail Media stáhnout a zpracovat váš datový soubor je nutné zadat podrobnosti o protokolu, hostiteli, portu a cestě k souboru. Zvolte si vhodný denní čas, abyste zajistili, že váš datový soubor bude na serveru připraven, protože společnost Epsilon Retail Media jej bude stahovat každý den. Nejjednodušším přístupem ke specifikaci denního cílového souboru pro stahování společností Epsilon Retail Mediaje použití explicitního názvu souboru. To umožňuje společnosti Epsilon Retail Media přímo načíst soubor z vašeho serveru. Pro ty, kteří používají protokoly FTP, FTPS nebo SFTP, nabízíme také další metody specifikace cílových souborů prostřednictvím takzvaných režimů cílových souborů. Tyto možnosti zahrnují: * Rolling\_earliest * Rolling\_earliest\_24\_hours * Rolling\_latest * Rolling\_latest\_24\_hours. Výběr režimu cílového souboru vyžaduje poskytnutí textové šablony pro názvy datových souborů. Tato šablona obsahuje speciální řetězec, `{\*}`, který pomáhá společnosti Epsilon Retail Media porovnávat názvy souborů na vašem serveru a každý den vybrat správný soubor. Například uvažujme šablonu `ERMCatalogData_AU_{\*}.txt`. Tato šablona vyžaduje, aby názvy souborů začínaly na `ERMCatalogData_AU` a končily na `.txt`. Při použití této šablony by odpovídaly následující názvy souborů: `ERMCatalogProduct_AU_20190315.txt` `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190312.txt` Aby se zabránilo stahování datových souborů, které se stále nahrávají, Epsilon Retail Media stahuje pouze soubory, které byly naposledy změněny více než jednu minutu před přístupem k serveru. Ačkoli šabloně může odpovídat více souborů, Epsilon Retail Media zpracovává vždy pouze jeden soubor. Výběr příslušného souboru z více kandidátů se řídí zvoleným režimem cílového souboru, který je podrobně popsán níže. ### Rolling\_earliest V tomto režimu cílového souboru jsou soubory filtrovány na základě poskytnuté šablony názvu. Po vyfiltrování jsou soubory seřazeny vzestupně podle svých názvů a k stáhnutí je vybrán první soubor v tomto pořadí. Například pokud je šablona názvu souboru `ERMCatalogData_AU_{\*}.txt` a vyfiltrovaný seznam názvů souborů obsahuje následující: `ERMCatalogProduct_AU_20190312.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190314.txt` V tomto režimu je pak k stáhnutí vybrán soubor `ERMCatalogProduct_AU_20190312.txt` . ### Rolling\_earliest\_24\_hours V tomto režimu cílového souboru jsou soubory nejprve vyfiltrovány na základě zadané šablony názvu. Z vyfiltrovaného seznamu se berou v úvahu pouze soubory změněné za posledních 24 hodin. Soubory jsou poté seřazeny vzestupně podle názvu a k stáhnutí je vybrán první soubor v tomto pořadí. Například předpokládejme, že aktuální čas je `2019-03-15 10:30:07`, a šablona názvu souboru je `ERMCatalogData_AU_{\*}.txt`. Pokud vyfiltrovaný seznam názvů souborů obsahuje následující: | Název souboru | Naposledy změněno | | ----------------------------------- | ----------------- | | 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žimu je pak k stáhnutí vybrán soubor `ERMCatalogProduct_AU_20190314.txt` . ### Rolling\_latest V tomto režimu cílového souboru jsou soubory filtrovány na základě zadané šablony názvu. Po vyfiltrování jsou soubory seřazeny sestupně podle svých názvů. První soubor v tomto seřazeném seznamu je vybrán k stáhnutí. Například pokud je šablona názvu souboru `ERMCatalogData_AU_{\*}.txt`, a vyfiltrovaný seznam názvů souborů obsahuje následující: `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190312.txt` V tomto režimu je pak k stáhnutí vybrán soubor `ERMCatalogProduct_AU_20190314.txt` je vybrán k stáhnutí. Tento režim je podobný režimu Rolling\_earliest, ale namísto řazení souborů vzestupně jsou řazeny sestupně. ### Rolling\_latest\_24\_hours V tomto režimu cílového souboru jsou soubory nejprve vyfiltrovány pomocí zadané šablony názvu. Z vyfiltrovaného seznamu se berou v úvahu pouze soubory změněné za posledních 24 hodin. Soubory jsou poté seřazeny sestupně podle svých názvů a první soubor v tomto pořadí je vybrán k stáhnutí. Například předpokládejme, že aktuální čas je `2019-03-15 10:30:07`, a šablona názvu souboru je `ERMCatalogData_AU_{\*}.txt`. Pokud vyfiltrovaný seznam názvů souborů obsahuje: | Název souboru | Naposledy změněno | | ----------------------------------- | ----------------- | | 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žimu je pak k stáhnutí vybrán soubor `ERMCatalogProduct_AU_20190315.txt` je vybrán k stáhnutí. Tento režim je podobný režimu Rolling\_earliest\_24\_hours, ale zde jsou soubory řazeny sestupně namísto vzestupně. --- # 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/cs/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.