Phần này giải thích các giao thức được Epsilon Retail Media hỗ trợ và cung cấp hướng dẫn đặt tên tệp để đơn giản hóa việc tải xuống tự động từ máy chủ của bạn. Để tải xuống an toàn, hãy gửi cho đại diện Epsilon Retail Media của bạn các thông tin chi tiết cần thiết—loại giao thức, máy chủ, cổng, đường dẫn tệp—và bất kỳ thông tin xác thực nào được yêu cầu, chẳng hạn như tên người dùng và mật khẩu. Bạn phải lưu trữ các tệp dữ liệu của mình trên máy chủ để có thể truy xuất thông qua các giao thức chuẩn, chẳng hạn như Google Cloud Storage (GCS), HTTPS và SFTP.
Các giao thức được hỗ trợ
Sau đây là các giao thức được hỗ trợ, cung cấp các phương pháp lưu trữ và truyền tệp an toàn, đảm bảo liên lạc an toàn với hệ thống Epsilon Retail Media.
GCS (nên dùng)
GCS là cơ chế lưu trữ và truy xuất tệp được chúng tôi ưa chuộng nhờ các tính năng bảo mật mạnh mẽ và khả năng tích hợp liền mạch với hệ thống Epsilon Retail Media.
HTTPS
Giao thức HTTPS cung cấp phương pháp truyền tệp an toàn bằng cách hỗ trợ xác thực dựa trên mật khẩu. Điều này đảm bảo liên lạc được mã hóa giữa máy chủ của bạn và Epsilon Retail Media.
SFTP
Khi sử dụng Giao thức truyền tệp an toàn (SFTP), Epsilon Retail Media hỗ trợ hai phương pháp xác thực để tải xuống các tệp dữ liệu:
- Tên người dùng và mật khẩu: Phương pháp tiêu chuẩn này sử dụng thông tin đăng nhập để xác thực quyền truy cập.
- Xác thực khóa công khai: Bạn cũng có thể sử dụng khóa công khai của Epsilon Retail Media. Để thực hiện được điều này, hãy đảm bảo cài đặt khóa công khai được cung cấp bên dưới trên máy chủ SFTP của bạn để tạo điều kiện truyền tệp an toàn.
Phân đoạn
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDMd4w5Z6hsjlUc0/r3dTJ+IaM9Mm+l3ZTrX3D5+30ZNiAb3Mhvlp8gv37CFKzqM90oFejl15bbr5dymjycsOWInxqkMyLOTbdMFAk7hmicNvN5bt3tx/Z0UewNvAx0Uw9Qxu7SCMSAalk9l7dqLp5RFFj+RHq9ApV8KIA/Fw2mjCw2vrJhiRWeuUuNNQTbGFBA5y72ATeYA2p0ZK3/TTJxyxCL70zGVxFG0jdAurfXKujYaF73Ql/gl5wmtnxGvTORtvObQdc2jCTsynj1w17LSZAdeoPQGnQkVCk37ZUnWTw8s4RYjHFVunsTDxJO5Qnw5yj8oqhe5IdpQyavUj+otRd6900q/3dK60IELH6AFz+ZEqudlBh8ZO2hvHIDS2Ii5S3LunlejykAVdRl7RVHA17Pk3mmrHCS6i3n9ZliBYeVQiKme2jHVB+ESrHFxQWl3ct9MYFNlAqwuhTFQRSG9ioSEHX5Dnmqk8aqbm/4pYY4b7YHOcIpHrtrVrFTJ3vLM1If1OVrDQidFhi1ArmoCU+PO65jNSeMj27m/HoX7Mbcmi8F++Op3MgP8iJrohE0Wjz+use7nlDtQTtDxDeEQQYGqsz4DOtH/jn1TWRynaXZqwPqC5Q6b52QM22T+E3rgT/4G7yJU3IRKioByOck251MEtOEgSCvvIAaV685fQ==
Sản xuất
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==
Nén và mã hóa dữ liệu
Trước khi tải dữ liệu lên máy chủ để đồng bộ hóa, bạn có thể cần nén và mã hóa các tệp. Khi sử dụng cả nén và mã hóa trên các tệp dữ liệu, Epsilon Retail Media cho rằng nén xảy ra trước mã hóa.
- Đối với nén dữ liệu, chúng tôi hỗ trợ các định dạng zip và gzip. Tuy nhiên, chúng tôi khuyên dùng gzip thay vì zip vì gzip có tỷ lệ nén tốt hơn và được hỗ trợ rộng rãi. Các tệp nén được giải nén trước khi xử lý.
- Đối với mã hóa dữ liệu, các tệp sẽ được giải mã khi tải xuống. Hãy sử dụng khóa công khai được cung cấp để mã hóa tệp trước khi tải lên máy chủ của bạn, đảm bảo chỉ Epsilon Retail Media có thể truy cập dữ liệu một cách an toàn.
Quy ước đặt tên tệp
Để cho phép Epsilon Retail Media tải xuống và xử lý tệp dữ liệu của bạn, bạn cần cung cấp thông tin chi tiết về giao thức, máy chủ, cổng và đường dẫn tệp. Chọn thời gian thuận tiện trong ngày để đảm bảo tệp dữ liệu của bạn đã sẵn sàng trên máy chủ vì Epsilon Retail Media sẽ tải tệp đó xuống mỗi ngày.
Cách tiếp cận đơn giản nhất để chỉ định tệp đích hàng ngày cho các bản tải xuống của Epsilon Retail Media là sử dụng tên tệp rõ ràng. Điều này cho phép Epsilon Retail Media trực tiếp lấy tệp từ máy chủ của bạn.
Đối với những người sử dụng giao thức FTP, FTPS hoặc SFTP, chúng tôi cũng cung cấp các phương pháp bổ sung để chỉ định tệp đích thông qua thứ mà chúng tôi gọi là chế độ tệp đích. Các tùy chọn này bao gồm:
- Rolling_earliest
- Rolling_earliest_24_hours
- Rolling_latest
- Rolling_latest_24_hours.
Việc chọn chế độ tệp đích yêu cầu bạn phải cung cấp mẫu dạng văn bản cho tên tệp dữ liệu. Mẫu này bao gồm một chuỗi đặc biệt, {\*}
, giúp Epsilon Retail Media khớp các tên tệp trên máy chủ của bạn và chọn tệp chính xác mỗi ngày.
Ví dụ, hãy xem xét mẫu này CitrusAdCatalogData_AU_{\*}.txt
. Mẫu này yêu cầu rằng tên tệp phải bắt đầu bằng CitrusAdCatalogData_AU
và kết thúc bằng .txt
. Khi sử dụng mẫu này, các tên tệp sau đây sẽ khớp:
CitrusAdCatalogProduct_AU_20190315.txt
CitrusAdCatalogProduct_AU_20190314.txt
CitrusAdCatalogProduct_AU_20190312.txt
Để tránh tải xuống các tệp dữ liệu vẫn đang trong quá trình tải lên, Epsilon Retail Media chỉ tải xuống các tệp được sửa đổi lần cuối hơn một phút trước khi truy cập máy chủ.
Mặc dù nhiều tệp có thể khớp với mẫu nhưng Epsilon Retail Media chỉ xử lý một tệp tại một thời điểm. Việc lựa chọn tệp phù hợp từ nhiều ứng viên được hướng dẫn bởi chế độ tệp đích đã chọn, chế độ này sẽ được thảo luận chi tiết bên dưới.
Rolling_earliest
Trong chế độ tệp đích này, các tệp được lọc dựa trên mẫu tên được cung cấp. Sau khi lọc, các tệp sẽ được sắp xếp theo thứ tự tăng dần của tên tệp, và tệp đầu tiên theo thứ tự này sẽ được chọn để tải xuống.
Ví dụ, nếu mẫu tên tệp là CitrusAdCatalogData_AU_{\*}.txt
và danh sách các tên tệp được lọc bao gồm như sau:
CitrusAdCatalogProduct_AU_20190312.txt
CitrusAdCatalogProduct_AU_20190313.txt
CitrusAdCatalogProduct_AU_20190314.txt
Trong chế độ này, tệp CitrusAdCatalogProduct_AU_20190312.txt
được chọn để tải xuống.
Rolling_earliest_24_hours
Trong chế độ tệp đích này, các tệp ban đầu được lọc dựa trên mẫu tên đã chỉ định. Từ danh sách đã được lọc, chỉ những tệp nào đã được sửa đổi trong vòng 24 giờ qua mới được xem xét. Các tệp sau đó được sắp xếp theo thứ tự tăng dần theo tên, và tệp đầu tiên trong thứ tự này được chọn để tải xuống.
Ví dụ, giả định rằng thời gian hiện tại là 2019-03-15 10:30:07
, và mẫu tên tệp là CitrusAdCatalogData_AU_{\*}.txt
. Nếu danh sách tên tệp đã được lọc bao gồm các mục sau:
Tên tệp | Sửa đổi lần cuối |
---|---|
CitrusAdCatalogProduct_AU_20190312.txt | 13/03/19 15:35:11 |
CitrusAdCatalogProduct_AU_20190313.txt | 13/03/19 15:35:08 |
CitrusAdCatalogProduct_AU_20190314.txt | 14/03/19 15:35:10 |
CitrusAdCatalogProduct_AU_20190315.txt | 15/03/19 10:05:07 |
Trong chế độ này, tệp CitrusAdCatalogProduct_AU_20190314.txt
được chọn để tải xuống.
Rolling_latest
Trong chế độ tệp đích này, các tệp được lọc dựa trên mẫu tên đã chỉ định. Sau khi lọc, các tệp được sắp xếp theo thứ tự giảm dần theo tên của chúng. Tệp đầu tiên trong danh sách đã được sắp xếp này sẽ được chọn để tải xuống.
Ví dụ, nếu mẫu tên tệp là CitrusAdCatalogData_AU_{\*}.txt
, và danh sách các tên tệp đã được lọc bao gồm như sau:
CitrusAdCatalogProduct_AU_20190314.txt
CitrusAdCatalogProduct_AU_20190313.txt
CitrusAdCatalogProduct_AU_20190312.txt
Trong chế độ này, tệp CitrusAdCatalogProduct_AU_20190314.txt
được chọn để tải xuống.
Chế độ này tương tự như Rolling_earliest, nhưng các tệp được sắp xếp theo thứ tự giảm dần thay vì tăng dần.
Rolling_latest_24_hours
Trong chế độ tệp đích này, các tệp ban đầu được lọc bằng mẫu tên đã chỉ định. Từ danh sách đã được lọc, chỉ những tệp nào đã được sửa đổi trong vòng 24 giờ qua mới được xem xét. Sau đó, các tệp được sắp xếp theo thứ tự giảm dần theo tên và tệp đầu tiên theo thứ tự này sẽ được chọn để tải xuống.
Ví dụ, giả định rằng thời gian hiện tại là 2019-03-15 10:30:07
, và mẫu tên tệp là CitrusAdCatalogData_AU_{\*}.txt
. Nếu danh sách tên tệp đã lọc bao gồm:
Tên tệp | Sửa đổi lần cuối |
---|---|
CitrusAdCatalogProduct_AU_20190312.txt | 13/03/19 15:35:11 |
CitrusAdCatalogProduct_AU_20190313.txt | 13/03/19 15:35:08 |
CitrusAdCatalogProduct_AU_20190314.txt | 14/03/19 15:35:10 |
CitrusAdCatalogProduct_AU_20190315.txt | 15/03/19 10:05:07 |
Trong chế độ này, tệp CitrusAdCatalogProduct_AU_20190315.txt
được chọn để tải xuống.
Chế độ này tương tự như Rolling_earliest_24_hours, nhưng ở đây các tệp được sắp xếp theo thứ tự giảm dần thay vì tăng dần.