Tệp dữ liệu có cấu trúc (SDF) là tệp CSV có định dạng đặc biệt. Các API này cho phép truy xuất, tạo và chỉnh sửa hàng loạt tài nguyên trong Display & Video 360. Cập nhật tài nguyên hàng loạt bằng cách tải xuống, chỉnh sửa rồi tải lên lại các tệp SDF.
Giao diện người dùng Display & Video 360 hỗ trợ tải và tải tệp SDF lên. Display & Video 360 API hỗ trợ tải tệp SDF xuống.
Định dạng
SDF sử dụng một trong hai định dạng cơ bản là Chuẩn và QA:
- Bạn có thể tải xuống và tải lên các tệp ở định dạng Chuẩn. Dữ liệu trong các tệp này có thể sử dụng mã nhận dạng bằng số để đảm bảo độ chính xác khi tải lên. Bạn có thể cần thông tin tham khảo để diễn giải dữ liệu.
- Bạn có thể tải tệp ở định dạng QA xuống. Các tệp này cung cấp dữ liệu giống như tệp ở định dạng Chuẩn, nhưng sử dụng các giá trị dễ đọc hơn. Ví dụ: một số cột có thể sử dụng tên hiển thị thay cho mã nhận dạng. Các cột dành riêng cho định dạng này sử dụng hậu tố "Qa".
Loại tệp
SDF hỗ trợ 7 loại tài nguyên. Mỗi loại tài nguyên có một loại tệp riêng với cấu trúc cột riêng. Các loại tài nguyên được hỗ trợ là:
- Chiến dịch
- Đơn đặt hàng quảng cáo
- Mục riêng
- Nhóm quảng cáo
- Quảng cáo
- Nguồn khoảng không quảng cáo
- Sản phẩm truyền thông
Chỉ các loại tệp Mục hàng và Nhóm quảng cáo mới hỗ trợ định dạng QA.
Các phiên bản SDF mới được phát hành thường xuyên và các phiên bản cũ hơn sẽ ngừng hoạt động. Các phiên bản mới sẽ cập nhật cấu trúc cột loại tệp. Nếu cần, phiên bản SDF mới sẽ có hướng dẫn di chuyển khi ra mắt.
Tải lỗi xuống
Tải SDF xuống có thể dẫn đến 2 loại lỗi: lỗi Tạo tệp và tài nguyên Bị bỏ qua.
Lỗi tạo tệp
Quá trình tạo SDF có thể kết thúc do lỗi. Nếu quá trình tạo không thành công khi sử dụng Display & Video 360 API, thì tác vụ đã hoàn tất sẽ đặt trường error bằng đối tượng Status. Đối tượng Status sẽ chứa một thông báo nêu chi tiết nguyên nhân gây ra lỗi.
Đọc thêm về những lỗi này trên trang hướng dẫn về lỗi và cảnh báo của chúng tôi.
Lỗi bị bỏ qua
SDF không hỗ trợ tất cả các loại tài nguyên phụ. Nếu không thể đưa một tài nguyên vào SDF, thì một tệp "Bị bỏ qua" (ví dụ: SDF-LineItems-Skipped.csv) sẽ được đưa vào nội dung tải xuống. Tệp này có cấu trúc gồm 2 cột. Cột đầu tiên xác định tài nguyên bị bỏ qua. Cột thứ hai giải thích lý do loại trừ.
Tải tệp lên
Tải tệp SDF lên bằng giao diện người dùng Display & Video 360 để tạo tài nguyên mới hoặc cập nhật tài nguyên hiện có.
Hãy làm theo các bước sau để giảm thiểu lỗi khi cập nhật hoặc tạo tài nguyên bằng SDF:
- Tải tệp SDF xuống bằng API Display & Video 360 hoặc giao diện người dùng.
- Sửa đổi các mục nhập tệp hiện có để cập nhật tài nguyên hiện có.
- Thêm các mục nhập tệp để tạo tài nguyên mới.
- Xoá mọi mục nhập không phải là mục nhập mới hoặc đã được cập nhật. Điều này giúp giảm kích thước tệp và loại bỏ khả năng cập nhật ngoài ý muốn.
- Tải tệp lên giao diện người dùng Display & Video 360.
Sau khi SDF được tải lên và xử lý, bạn có thể tải tệp SDF-ResultFile.zip xuống. Tệp ZIP này có thể chứa 2 tệp:
SDF-{ResourceType}-Updated-ResultFile.csv, liệt kê những tài nguyên đã được cập nhật hoặc tạo thành công.SDF-{ResourceType}-Failed-ResultFile.csv, liệt kê các thao tác không thành công và thông báo lỗi có liên quan.
Tệp ZIP có thể chứa một hoặc cả hai tệp.