> 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/ko/data-api/data-overview-1/syncing-data-via-file-protocols-1.md). # 파일 프로토콜을 통한 데이터 동기화 이 섹션에서는 다음에서 지원하는 프로토콜에 대해 설명합니다. Epsilon Retail Media 서버에서 자동 다운로드가 원활하게 이루어지도록 파일 이름을 지정하기 위한 지침을 제공합니다. 안전한 다운로드를 위해 프로토콜 유형, 호스트, 포트, 파일 경로 등 필요한 세부 정보와 사용자 이름 및 비밀번호와 같이 필요한 인증 자격 증명을 Epsilon Retail Media 담당자에게 보내세요. Google Cloud Storage(GCS), HTTPS 및 SFTP와 같은 표준 프로토콜을 통한 검색이 가능하도록 데이터 파일을 서버에 저장해야 합니다. ## 지원되는 프로토콜 다음은 안전한 파일 저장 및 전송 방법을 제공하여 Epsilon Retail Media 시스템과의 안전한 통신을 보장하는 지원 프로토콜입니다. ### GCS(권장) GCS는 강력한 보안 기능과 다음과의 원활한 통합으로 인해 파일 저장 및 검색에 선호되는 메커니즘입니다. Epsilon Retail Media 시스템과의 안전한 통신을 보장하는 지원 프로토콜입니다. ### HTTPS HTTPS 프로토콜은 비밀번호 기반 인증을 지원하여 안전한 파일 전송 방법을 제공합니다. 이를 통해 서버와 Epsilon Retail Media. {% hint style="warning" %} 간의 암호화된 통신이 보장됩니다. 대용량 파일은 GCS를 통해 동기화하는 것이 좋습니다 100,000개가 넘는 상품 피드는 성능 향상을 위해 버킷 방법론으로 동기화하는 것이 가장 좋습니다. {% endhint %} ### SFTP SFTP(Secure File Transfer Protocol)를 사용할 때 Epsilon Retail Media 에서는 데이터 파일 다운로드를 위한 두 가지 인증 방법을 지원합니다. * **사용자 이름 및 비밀번호**: 이 표준 방법은 자격 증명을 사용하여 액세스를 인증합니다. * **공개 키 인증**: 다음을 사용할 수도 있습니다. Epsilon Retail Media의 공개 키입니다. 이를 위해 아래에 제공된 공개 키가 SFTP 서버에 설치되어 있는지 확인하여 안전한 파일 전송을 용이하게 하세요. #### 스테이징 ``` ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDMd4w5Z6hsjlUc0/r3dTJ+IaM9Mm+l3ZTrX3D5+30ZNiAb3Mhvlp8gv37CFKzqM90oFejl15bbr5dymjycsOWInxqkMyLOTbdMFAk7hmicNvN5bt3tx/Z0UewNvAx0Uw9Qxu7SCMSAalk9l7dqLp5RFFj+RHq9ApV8KIA/Fw2mjCw2vrJhiRWeuUuNNQTbGFBA5y72ATeYA2p0ZK3/TTJxyxCL70zGVxFG0jdAurfXKujYaF73Ql/gl5wmtnxGvTORtvObQdc2jCTsynj1w17LSZAdeoPQGnQkVCk37ZUnWTw8s4RYjHFVunsTDxJO5Qnw5yj8oqhe5IdpQyavUj+otRd6900q/3dK60IELH6AFz+ZEqudlBh8ZO2hvHIDS2Ii5S3LunlejykAVdRl7RVHA17Pk3mmrHCS6i3n9ZliBYeVQiKme2jHVB+ESrHFxQWl3ct9MYFNlAqwuhTFQRSG9ioSEHX5Dnmqk8aqbm/4pYY4b7YHOcIpHrtrVrFTJ3vLM1If1OVrDQidFhi1ArmoCU+PO65jNSeMj27m/HoX7Mbcmi8F++Op3MgP8iJrohE0Wjz+use7nlDtQTtDxDeEQQYGqsz4DOtH/jn1TWRynaXZqwPqC5Q6b52QM22T+E3rgT/4G7yJU3IRKioByOck251MEtOEgSCvvIAaV685fQ== ``` #### 프로덕션 ``` 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== ``` ## 데이터 압축 및 암호화 동기화를 위해 서버에 데이터를 업로드하기 전에 파일을 압축하고 암호화해야 할 수도 있습니다. 데이터 파일에 압축과 암호화가 모두 사용되는 경우 Epsilon Retail Media 에서는 암호화 전에 압축이 발생하는 것으로 간주합니다. * 데이터 압축의 경우 zip 및 gzip 형식을 지원합니다. 그러나 더 나은 압축률과 광범위한 지원으로 인해 zip보다 gzip을 권장합니다. 압축된 파일은 처리 전에 압축 해제됩니다. * 데이터 암호화의 경우 파일 다운로드 시 암호화가 해제됩니다. 제공된 공개 키를 사용하여 서버에 업로드하기 전에 파일을 암호화하면 Epsilon Retail Media 만 데이터에 안전하게 액세스할 수 있습니다. ## 파일 명명 규칙 다음에서 Epsilon Retail Media 데이터 파일을 다운로드하고 처리할 수 있도록 프로토콜, 호스트, 포트 및 파일 경로 세부 정보를 제공해야 합니다. 데이터 파일이 서버에 준비되도록 편리한 일일 시간을 선택하세요. Epsilon Retail Media 에서 매일 다운로드합니다. 다음에서 일일 대상 파일을 지정하는 가장 간단한 방법은 Epsilon Retail Media다운로드는 명시적 파일 이름을 사용하면 됩니다. 이를 통해 Epsilon Retail Media 에서 서버로부터 직접 파일을 가져올 수 있습니다. FTP, FTPS 또는 SFTP 프로토콜을 사용하는 경우 대상 파일 모드라는 기능을 통해 대상 파일을 지정하는 추가 방법도 제공합니다. 이러한 옵션은 다음과 같습니다. * Rolling\_earliest * Rolling\_earliest\_24\_hours * Rolling\_latest * Rolling\_latest\_24\_hours. 대상 파일 모드를 선택하려면 데이터 파일 이름에 대한 텍스트 기반 템플릿을 제공해야 합니다. 이 템플릿에는 다음과 같은 특수 문자열이 포함됩니다. `{\*}`, 이것은 다음과 같은 작업을 도와줍니다. Epsilon Retail Media 매일 서버의 파일 이름을 일치시키고 올바른 파일을 선택합니다. 예를 들어 템플릿이 `ERMCatalogData_AU_{\*}.txt`인 경우를 생각해 보세요. 이 템플릿은 파일 이름이 다음과 같이 시작해야 합니다. `ERMCatalogData_AU` 그리고 다음과 같이 끝나야 합니다. `.txt`. 이 템플릿을 사용하면 다음 파일 이름이 일치합니다. `ERMCatalogProduct_AU_20190315.txt` `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190312.txt` 업로드 중인 데이터 파일이 다운로드되지 않도록, Epsilon Retail Media 은(는) 서버에 액세스하기 1분 이전에 마지막으로 수정된 파일만 다운로드합니다. 여러 파일이 템플릿과 일치하더라도, Epsilon Retail Media 은(는) 한 번에 하나의 파일만 처리합니다. 아래에서 자세히 설명하는 선택한 대상 파일 모드에 따라 여러 후보 중에서 적절한 파일을 선택하게 됩니다. ### Rolling\_earliest 이 대상 파일 모드에서는 제공된 이름 템플릿을 기반으로 파일이 필터링됩니다. 필터링된 파일은 이름의 오름차순으로 정렬되며, 이 순서의 첫 번째 파일이 다운로드용으로 선택됩니다. 예를 들어 파일 이름 템플릿이 `ERMCatalogData_AU_{\*}.txt` 이고 필터링된 파일 이름 목록에 다음이 포함되어 있는 경우: `ERMCatalogProduct_AU_20190312.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190314.txt` 이 모드에서는 파일 `ERMCatalogProduct_AU_20190312.txt` 이(가) 다운로드용으로 선택됩니다. ### Rolling\_earliest\_24\_hours 이 대상 파일 모드에서는 지정된 이름 템플릿을 기반으로 파일이 먼저 필터링됩니다. 필터링된 목록에서 지난 24시간 이내에 수정된 파일만 고려됩니다. 그런 다음 파일은 이름별 오름차순으로 정렬되고 이 순서의 첫 번째 파일이 다운로드용으로 선택됩니다. 예를 들어 현재 시간이 `2019-03-15 10:30:07`이고 파일 이름 템플릿이 `ERMCatalogData_AU_{\*}.txt`이라고 가정해 보겠습니다. 필터링된 파일 이름 목록에 다음이 포함되어 있는 경우: | 파일 이름 | 최종 수정일 | | ----------------------------------- | ----------------- | | 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 | 이 모드에서는 파일 `ERMCatalogProduct_AU_20190314.txt` 이(가) 다운로드용으로 선택됩니다. ### Rolling\_latest 이 대상 파일 모드에서는 지정된 이름 템플릿을 기반으로 파일이 필터링됩니다. 필터링 후 파일은 이름별 내림차순으로 정렬됩니다. 이 정렬된 목록의 첫 번째 파일이 다운로드용으로 선택됩니다. 예를 들어 파일 이름 템플릿이 `ERMCatalogData_AU_{\*}.txt`이고 필터링된 파일 이름 목록에 다음이 포함되어 있는 경우: `ERMCatalogProduct_AU_20190314.txt` `ERMCatalogProduct_AU_20190313.txt` `ERMCatalogProduct_AU_20190312.txt` 이 모드에서는 파일 `ERMCatalogProduct_AU_20190314.txt` 이(가) 다운로드용으로 선택됩니다. 이 모드는 Rolling\_earliest와 유사하지만 파일을 오름차순으로 정렬하는 대신 내림차순으로 정렬합니다. ### Rolling\_latest\_24\_hours 이 대상 파일 모드에서는 지정된 이름 템플릿을 사용하여 파일이 먼저 필터링됩니다. 필터링된 목록에서 지난 24시간 이내에 수정된 파일만 고려됩니다. 그런 다음 파일은 이름별 내림차순으로 정렬되고 이 순서의 첫 번째 파일이 다운로드용으로 선택됩니다. 예를 들어 현재 시간이 `2019-03-15 10:30:07`이고 파일 이름 템플릿이 `ERMCatalogData_AU_{\*}.txt`이라고 가정해 보겠습니다. 필터링된 파일 이름 목록에 다음이 포함된 경우: | 파일 이름 | 최종 수정일 | | ----------------------------------- | ----------------- | | 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 | 이 모드에서는 파일 `ERMCatalogProduct_AU_20190315.txt` 이(가) 다운로드용으로 선택됩니다. 이 모드는 Rolling\_earliest\_24\_hours와 유사하지만 오름차순이 아닌 내림차순으로 파일이 정렬됩니다. --- # 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/ko/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.