Trong phần này, chúng tôi nêu lên các giao thức mà CitrusAd hỗ trợ và cách đặt tên cho các tệp để CitrusAd có thể tải xuống các tệp dữ liệu tự động từ máy chủ của bạn.

Giao thức

CitrusAd hỗ trợ một số cách để truy xuất tệp dữ liệu. Các tệp dữ liệu phải được lưu trữ trên máy chủ của bạn và các tệp sẽ được tải xuống thông qua một trong các giao thức chuẩn.

Hiện tại, CitrusAd hỗ trợ tải xuống các tệp dữ liệu thông qua các giao thức sau:

GCS
SFTP
SCP
HTTPS

Nói chung, bạn sẽ cần cung cấp thông tin về giao thức, máy chủ, cổng và đường dẫn tệp của tệp dữ liệu để CitrusAd có thể tải xuống. Khi cần xác thực để tải xuống tệp dữ liệu, bạn sẽ cần cung cấp cho CitrusAd thông tin xác thực (ví dụ: tên người dùng và mật khẩu) để xác thực với hệ thống của bạn.

Nếu bạn đang sử dụng giao thức SFTP, CitrusAd hỗ trợ hai loại xác thực để tải xuống tệp dữ liệu:

Tên người dùng và mật khẩu
Chìa khóa công khai của CitrusAd.

Trong loại xác thực thứ hai, chìa khóa công khai dưới đây cần được cài đặt vào máy chủ SFTP của bạ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==

Sản xuất:

Nén và mã hóa dữ liệu

Bạn có thể sẽ cần nén và mã hóa dữ liệu trước khi tải lên máy chủ để đồng bộ hóa. Khi các tệp dữ liệu vừa được nén lại vừa được mã hóa, CitrusAd sẽ giả định rằng các tệp dữ liệu được nén trước khi mã hóa.

Khi tệp dữ liệu được mã hóa, CitrusAd sẽ giải mã tệp dữ liệu sau khi tải xuống. Hiện tại, chúng tôi hỗ trợ giải mã dữ liệu cho các tệp được mã hóa bởi các chương trình PGP. Có thể tìm hiểu thêm thông tin về kỹ thuật mã hóa PGP tại https://tools.ietf.org/html/rfc4880.

Nếu bạn chọn sử dụng loại mã hóa này cho các tệp dữ liệu, bạn có thể sử dụng các tệp dữ liệu mã hóa chìa khóa công khai dưới đây trước khi tải tệp lên máy chủ của mình. Chỉ CitrusAd mới có thể giải mã các tệp dữ liệu được mã hóa.

Chìa khóa công khai (Phân đoạn - Chỉ môi trường Trước AU):

Chìa khóa công khai (Môi trường Sản xuất và Tiền Mỹ/Châu Âu):

Khi tệp dữ liệu được phân phối ở dạng nén, chúng tôi sẽ giải nén tệp dữ liệu trước khi xử lý. Hiện tại, chúng tôi hỗ trợ giải nén hai loại định dạng nén là: zip và gzip.

Quy ước đặt tên tệp

Như đã đề cập trước đây, bạn sẽ cần cung cấp thông tin về giao thức, máy chủ lưu trữ, cổng và đường dẫn tệp đến tệp dữ liệu để CitrusAd có thể tải xuống và xử lý tệp dữ liệu. Bạn có thể chọn thời gian hàng ngày thuận tiện để đảm bảo rằng tệp dữ liệu đã sẵn sàng trên máy chủ mỗi ngày và CitrusAd sẽ tải xuống các tệp dữ liệu hàng ngày.

Cách đơn giản nhất để chỉ định tệp đích cho CitrusAd tải xuống mỗi ngày là cung cấp tên tệp rõ ràng. Sau đó CitrusAd sẽ sử dụng tên tệp này để truy xuất tệp dữ liệu từ máy chủ của bạn.

Khi bạn sử dụng các giao thức FTP, FTPS và SFTP để giao tiếp giữa máy chủ của mình và CitrusAd, chúng tôi hỗ trợ các tùy chọn khác để bạn chỉ định các tệp đích cho CitrusAd tải xuống, bao gồm:

Rolling_earliest
Rolling_earliest_24_hours
Rolling_latest
Rolling_latest_24_hours.

Chúng còn được gọi là các chế độ tệp đích.

Khi bạn chọn một trong các tùy chọn nêu trên, bạn sẽ cần cung cấp cho CitrusAd mẫu văn bản cho tên tệp dữ liệu. Trong mẫu văn bản này có một chuỗi đặc biệt, đó là “{*}”. CitrusAd sẽ sử dụng mẫu do bạn cung cấp để khớp với tên tệp trên máy chủ của bạn để chọn và tải xuống tệp đích mỗi ngày.

Lấy “CitrusAdCatalogDataAU{}.txt” làm một ví dụ. Mẫu này quy định rằng tên tệp phù hợp phải bắt đầu bằng tiền tố “CitrusAdCatalogData_AU” và kết thúc bằng hậu tố “.txt”. Khi sử dụng mẫu “CitrusAdCatalogDataAU{_}.txt”, các tên tệp dưới đây phải khớp với mẫu:

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 mà bạn đang tải lên, CitrusAd chỉ tải xuống tệp dữ liệu đã được sửa đổi hơn một phút kể từ khi chúng tôi truy cập máy chủ.

Mặc dù có một số tên tệp phù hợp với mẫu, CitrusAd chỉ tải xuống và xử lý một tệp tại một thời điểm. Để chọn một tệp từ danh sách các ứng viên, chúng tôi xác định các chế độ tệp mục tiêu khác nhau mà bạn có thể chọn. Các chế độ tệp đích được thảo luận chi tiết hơn bên dưới.

Rolling_earliest

Trong chế độ tệp đích này, chúng tôi sử dụng mẫu để lọc tệp bằng cách sử dụng tên của chúng, sau đó chúng tôi sắp xếp kết quả theo tên tệp tăng dần và trả về kết quả đầu tiên.

Ví dụ: nếu mẫu của tên tệp là “CitrusAdCatalogDataAU{*}.txt” và danh sách tên tệp được lọc theo mẫu như bên dưới, thì tệp “CitrusAdCatalogProduct_AU_20190312.txt” sẽ được chọn để tải xuống trong chế độ tệp đích.

CitrusAdCatalogProduct_AU_20190312.txt
CitrusAdCatalogProduct_AU_20190313.txt
CitrusAdCatalogProduct_AU_20190314.txt

Rolling_earliest_24_hours

Trong chế độ tệp đích này, trước tiên chúng tôi sử dụng mẫu để lọc các tệp bằng tên của chúng. Sau đó, chúng tôi chỉ chọn các tệp được sửa đổi trong vòng 24 giờ gần đây. Cuối cùng, chúng tôi sắp xếp kết quả theo tên tệp tăng dần và trả về kết quả đầu tiên.

Ví dụ: giả định rằng thời gian hiện tại là 10:30:07 ngày 15-03-2019 và mẫu của tên tệp là “CitrusAdCatalogDataAU{*}.txt”. Nếu danh sách tên tệp được lọc theo mẫu nằm trong bảng dưới đây, tệp “CitrusAdCatalogProduct_AU_20190314.txt” sẽ được chọn để tải xuống trong chế độ tệp đích.

Ví dụ về các tệp có tên và thông tin sửa đổi lần cuối

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

Rolling_latest

Trong chế độ tệp đích này, chúng tôi sử dụng mẫu để lọc các tệp bằng tên của chúng. Sau đó, chúng tôi sắp xếp kết quả theo tên tệp giảm dần và trả về kết quả đầu tiên.

Ví dụ: nếu mẫu của tên tệp là “CitrusAdCatalogDataAU{*}.txt” và danh sách tên tệp được lọc theo mẫu như bên dưới, thì tệp “CitrusAdCatalogProduct_AU_20190314.txt” sẽ được chọn để tải xuống trong chế độ tệp đích.

CitrusAdCatalogProduct_AU_20190314.txt
CitrusAdCatalogProduct_AU_20190313.txt
CitrusAdCatalogProduct_AU_20190312.txt

Chế độ tệp đích này tương tự như Rolling_earliest. Tuy nhiên, thay vì sắp xếp các tệp theo tên tệp tăng dần thì chúng tôi sắp xếp theo tên tệp giảm dần.

Rolling_latest_24_hours

Trong chế độ tệp đích này, trước tiên chúng tôi sử dụng mẫu để lọc các tệp bằng tên của chúng. Sau đó, chúng tôi chỉ chọn các tệp được sửa đổi trong vòng 24 giờ gần đây. Cuối cùng, chúng tôi sắp xếp kết quả theo tên tệp giảm dần và trả về kết quả đầu tiên.

Ví dụ: giả định rằng thời gian hiện tại là 10:30:07 ngày 15-03-2019 và mẫu của tên tệp là “CitrusAdCatalogDataAU{*}.txt”. Nếu danh sách tên tệp được lọc theo mẫu nằm trong bảng dưới đây, tệp “CitrusAdCatalogProduct_AU_20190315.txt” sẽ được chọn để tải xuống trong chế độ tệp đích này.

Chế độ tệp đích này tương tự như Rolling_earliest_24_hours. Tuy nhiên, thay vì sắp xếp các tệp theo tên tệp tăng dần thì chúng tôi sắp xếp theo tên tệp giảm dần.

Ví dụ về các tệp có tên và thông tin sửa đổi lần cuối

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