> 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/sv/data-api/data-overview-1/syncing-data-via-file-protocols-1.md). # Synkronisera data via filprotokoll Det här avsnittet förklarar de protokoll som stöds av Epsilon Retail Media och ger riktlinjer för namngivning av filer för att effektivisera automatiska nedladdningar från din server. För säkra nedladdningar, skicka nödvändiga detaljer – protokolltyp, värd, port, filsökväg – och eventuella autentiseringsuppgifter som krävs, såsom användarnamn och lösenord, till din Epsilon Retail Media representant. Du måste lagra dina datafiler på servern för att möjliggöra hämtning via standardprotokoll, såsom Google Cloud Storage (GCS), HTTPS och SFTP. ## Protokoll som stöds Här är de protokoll som stöds och som erbjuder säkra metoder för fillagring och överföring, vilket säkerställer säker kommunikation med Epsilon Retail Media system. ### GCS (rekommenderas) GCS är vår föredragna mekanism för fillagring och hämtning på grund av dess robusta säkerhetsfunktioner och sömlösa integration med Epsilon Retail Media system. ### HTTPS HTTPS-protokollet ger en säker metod för filöverföring genom att stödja lösenordsbaserad autentisering. Detta säkerställer krypterad kommunikation mellan din server och Epsilon Retail Media. {% hint style="warning" %} Större filer synkroniseras bäst via GCS Feeds med över 100 000 produkter synkroniseras bäst med bucket-metodik för att förbättra prestandan. {% endhint %} ### SFTP När du använder Secure File Transfer Protocol (SFTP), Epsilon Retail Media stöder två autentiseringsmetoder för att ladda ner datafiler: * **Användarnamn och lösenord**: Denna standardmetod använder autentiseringsuppgifter för att bekräfta åtkomst. * **Autentisering med public key**: Du kan också använda Epsilon Retail Medias public key. För detta ska du se till att den public key som tillhandahålls nedan är installerad på din SFTP-server för att underlätta säkra filöverföringar. #### 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== ``` ## Datakomprimering och kryptering Innan du överför data till din server för synkronisering kan du behöva komprimera och kryptera filerna. När både komprimering och kryptering används på datafiler, Epsilon Retail Media antar att komprimering sker före kryptering. * För datakomprimering stöds zip- och gzip-format. Vi rekommenderar dock gzip framför zip på grund av dess bättre komprimeringsgrad och utbredda stöd. Komprimerade filer dekoderas före bearbetning. * För datakryptering dekrypteras filerna vid nedladdning. Använd de tillhandahållna public keys för att kryptera filer innan de överförs till din server, vilket säkerställer att endast Epsilon Retail Media har säker åtkomst till data. ## Namnkonvention för filer För att möjliggöra för Epsilon Retail Media att ladda ner och bearbeta din datafil behöver du ange detaljer för protokoll, värd, port och filsökväg. Välj en lämplig daglig tidpunkt för att säkerställa att din datafil är redo på servern, eftersom Epsilon Retail Media kommer att ladda ner den varje dag. Det mest direkta sättet att ange en daglig målfil för Epsilon Retail Medias nedladdningar är att använda ett explicit filnamn. Detta gör att Epsilon Retail Media direkt kan hämta filen från din server. För dem som använder protokollen FTP, FTPS eller SFTP erbjuder vi också ytterligare metoder för att ange målfiler genom vad vi kallar målfillägen. Dessa alternativ inkluderar: * Rolling\_earliest * Rolling\_earliest\_24\_hours * Rolling\_latest * Rolling\_latest\_24\_hours. När du väljer ett målfilläge måste du tillhandahålla en textbaserad mall för datafilnamn. Denna mall innehåller en specialsträng, `{\*}`, som hjälper Epsilon Retail Media att matcha filnamn på din server och välja rätt fil varje dag. Överväg till exempel mallen `ERMCatalogData_AU_{\*}.txt`. Denna mall kräver att filnamnen börjar med `ERMCatalogData_AU` och slutar med `.txt`. Med denna mall skulle följande filnamn matcha: `ERMCatalogProduct_AU_20190315.txt` `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190312.txt` För att undvika att ladda ner datafiler som fortfarande håller på att överföras, Epsilon Retail Media laddar endast ner filer som senast ändrades mer än en minut innan servern nås. Även om flera filer kan matcha mallen, Epsilon Retail Media bearbetar endast en fil i taget. Valet av lämplig fil från flera kandidater styrs av det valda målfilläget, vilket diskuteras i detalj nedan. ### Rolling\_earliest I detta målfilläge filtreras filer baserat på den tillhandahållna namnnamnsmallen. När de har filtrerats sorteras filerna i stigande ordning efter sina namn, och den första filen i denna ordning väljs för nedladdning. Om filnamnsmallen till exempel är `ERMCatalogData_AU_{\*}.txt` och den filtrerade listan över filnamn innehåller följande: `ERMCatalogProduct_AU_20190312.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190314.txt` I detta läge väljs sedan filen `ERMCatalogProduct_AU_20190312.txt` för nedladdning. ### Rolling\_earliest\_24\_hours I detta målfilläge filtreras filer initialt baserat på den angivna namnmallen. Från den filtrerade listan beaktas endast filer som ändrats under de senaste 24 timmarna. Filerna sorteras sedan i stigande ordning efter namn, och den första filen i denna ordning väljs för nedladdning. Anta till exempel att den aktuella tiden är `2019-03-15 10:30:07`, och filnamnsmallen är `ERMCatalogData_AU_{\*}.txt`. Om den filtrerade listan över filnamn innehåller följande: | Filnamn | Senast ändrad | | ----------------------------------- | ----------------- | | 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 | I detta läge väljs sedan filen `ERMCatalogProduct_AU_20190314.txt` för nedladdning. ### Rolling\_latest I detta målfilläge filtreras filer baserat på den angivna namnmallen. Efter filtrering sorteras filerna i fallande ordning efter sina namn. Den första filen i denna sorterade lista väljs för nedladdning. Om filnamnsmallen till exempel är `ERMCatalogData_AU_{\*}.txt`, och den filtrerade listan över filnamn innehåller följande: `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190312.txt` I detta läge väljs sedan filen `ERMCatalogProduct_AU_20190314.txt` väljs för nedladdning. Detta läge liknar Rolling\_earliest, men istället för att sortera filerna i stigande ordning sorteras de i fallande ordning. ### Rolling\_latest\_24\_hours I detta målfilläge filtreras filer initialt med hjälp av den angivna namnmallen. Från den filtrerade listan beaktas endast filer som ändrats under de senaste 24 timmarna. Filerna sorteras sedan i fallande ordning efter sina namn, och den första filen i denna ordning väljs för nedladdning. Anta till exempel att den aktuella tiden är `2019-03-15 10:30:07`, och filnamnsmallen är `ERMCatalogData_AU_{\*}.txt`. Om den filtrerade listan över filnamn innehåller: | Filnamn | Senast ändrad | | ----------------------------------- | ----------------- | | 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 | I detta läge väljs sedan filen `ERMCatalogProduct_AU_20190315.txt` väljs för nedladdning. Detta läge liknar Rolling\_earliest\_24\_hours, men här sorteras filerna i fallande ordning snarare än i stigande. --- # 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/sv/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.