Lần cập nhật gần đây nhất: 18/10/2023
Hướng dẫn này sẽ hướng dẫn bạn quy trình di chuyển sang Tệp dữ liệu có cấu trúc (SDF) phiên bản 7 từ một phiên bản trước đó và những thay đổi (cả bắt buộc và đề xuất) mà bạn có thể thực hiện để tối ưu hoá hoạt động tích hợp của mình.
Hãy xem ghi chú phát hành để biết danh sách đầy đủ các điểm khác biệt giữa phiên bản 6 và 7.
Di chuyển phiên bản Tệp dữ liệu có cấu trúc
Để di chuyển sang Tệp dữ liệu có cấu trúc phiên bản 7 từ một phiên bản trước, bạn cần chỉ định phiên bản mới, cập nhật không gian mã nhận dạng cho một tập hợp con các cột hiện có và thêm tính năng tích hợp với các cột mới.
Cập nhật phiên bản Tệp dữ liệu có cấu trúc
Để cập nhật lên phiên bản Tệp dữ liệu có cấu trúc mới, bạn cần cập nhật phiên bản mà bạn chỉ định cho tài nguyên Đối tác và Nhà quảng cáo gốc cũng như các tác vụ tải xuống riêng lẻ trong API Display & Video 360.
Cập nhật chế độ cài đặt tài nguyên mẹ
Phiên bản Tệp dữ liệu có cấu trúc mặc định được đặt ở cấp tài nguyên đối tác và nhà quảng cáo. Phiên bản này được dùng làm phiên bản mặc định khi tải Tệp dữ liệu có cấu trúc xuống thông qua giao diện hoặc API.
Thiết lập trong giao diện
- Ở cấp đối tác
- Chuyển đến đối tác dự định. Chuyển đến trang Thông tin cơ bản trong trình đơn Cài đặt đối tác ở thanh điều hướng bên trái. Cập nhật cấu hình phiên bản SDF trong phần Tệp dữ liệu có cấu trúc thành phiên bản 7.
- Ở cấp nhà quảng cáo
- Chuyển đến nhà quảng cáo mà bạn muốn. Chuyển đến trang Thông tin cơ bản trong trình đơn Cài đặt nhà quảng cáo ở thanh điều hướng bên trái. Cập nhật cấu hình phiên bản SDF trong mục Tệp dữ liệu có cấu trúc thành phiên bản 7. Nếu phiên bản mặc định được đặt ở cấp Đối tác, thì bạn có thể không chỉnh sửa được chế độ cài đặt này.
Đặt trong API
- Ở cấp nhà quảng cáo
- Tạo yêu cầu
advertisers.patchđể cập nhậtdataAccessConfig.sdfConfig.sdfConfig.versionthànhSDF_VERSION_7và nếu cần,dataAccessConfig.sdfConfig.overridePartnerSdfConfigthànhTrue.
Cập nhật các yêu cầu sdfdownloadtasks.create trong API
Khi tạo yêu cầu sdfdownloadtasks.create bằng API Display & Video 360, hãy đặt trường version của nội dung yêu cầu thành SDF_VERSION_7.
Cập nhật mã nhận dạng trong các cột bắt buộc
Trong phiên bản 7, các không gian mã nhận dạng mà một nhóm cột sử dụng đã được cập nhật để tách Tệp dữ liệu có cấu trúc khỏi sản phẩm Tệp đọc thực thể không còn được dùng nữa và điều chỉnh cho phù hợp hơn với các công cụ được hỗ trợ, chẳng hạn như Display & Video 360 API.
Phần này liệt kê mọi cột sử dụng mã nhận dạng khác với phiên bản 6 và hướng dẫn cách truy xuất thông tin tham chiếu về các giá trị mới.
Đơn đặt hàng quảng cáo
| Hướng dẫn di chuyển cột cho phiên bản 7 | |
|---|---|
|
Nhắm mục tiêu theo ứng dụng – Loại trừ Nhắm mục tiêu ứng dụng – Bao gồm |
Các cột này đã được cập nhật để sử dụng giá trị nhận dạng ứng dụng theo định dạng " Nền tảng ứng dụng được xác định bằng một giá trị chuỗi. Mã ứng dụng là mã do nền tảng liên quan cung cấp, chẳng hạn như mã gói từ Cửa hàng Play của Android hoặc mã ứng dụng từ App Store của Apple. |
|
Nhắm mục tiêu theo trình duyệt – Loại trừ Nhắm mục tiêu theo trình duyệt – Bao gồm |
Cột này đã được cập nhật để sử dụng các giá trị
Truy xuất tài nguyên |
|
Nhắm mục tiêu theo nhà mạng – Loại trừ Nhắm mục tiêu theo nhà mạng – Bao gồm |
Cột này đã được cập nhật để sử dụng các giá trị
Truy xuất tài nguyên |
|
Tiêu chí nhắm mục tiêu theo kênh – Loại trừ Tiêu chí nhắm mục tiêu theo kênh – Bao gồm |
Cột này đã được cập nhật để sử dụng giá trị
Truy xuất tài nguyên |
|
Nhắm mục tiêu theo thiết bị – Loại trừ Nhắm mục tiêu theo thiết bị – Bao gồm |
Cột này đã được cập nhật để sử dụng các giá trị
Truy xuất tài nguyên |
| Đo lường kênh DAR |
Cột này đã được cập nhật để sử dụng giá trị
Truy xuất tài nguyên |
Nhắm mục tiêu theo trang web – Loại trừ Nhắm mục tiêu theo trang web – Bao gồm |
Cột này đã được cập nhật để xác định các trang web thông qua chuỗi URL. |
Mục riêng
| Hướng dẫn di chuyển cột cho phiên bản 7 | |
|---|---|
|
Nhắm mục tiêu theo ứng dụng – Loại trừ Nhắm mục tiêu ứng dụng – Bao gồm |
Các cột này đã được cập nhật để sử dụng giá trị nhận dạng ứng dụng theo định dạng " Nền tảng ứng dụng được xác định bằng một giá trị chuỗi. Mã ứng dụng là mã do nền tảng liên quan cung cấp, chẳng hạn như mã gói từ Cửa hàng Play của Android hoặc mã ứng dụng từ App Store của Apple. |
| Hệ số giá thầu |
Cột này đã được cập nhật để sử dụng Mã tiêu chí mới cho các loại hàng ứng dụng và trang web. Loại hàng ứng dụng đã được cập nhật để sử dụng các giá trị chuỗi được nối của nền tảng ứng dụng và mã nền tảng ứng dụng, được phân tách bằng dấu hai chấm, cho mã tiêu chí. Nền tảng ứng dụng được xác định bằng một giá trị chuỗi. Mã ứng dụng là mã do nền tảng có liên quan cung cấp, chẳng hạn như mã gói từ Cửa hàng Play của Android hoặc mã ứng dụng từ App Store của Apple. Loại hàng trang web đã được cập nhật để sử dụng chuỗi URL làm Mã tiêu chí. |
|
Nhắm mục tiêu theo trình duyệt – Loại trừ Nhắm mục tiêu theo trình duyệt – Bao gồm |
Cột này đã được cập nhật để sử dụng các giá trị
Truy xuất tài nguyên |
|
Nhắm mục tiêu theo nhà mạng – Loại trừ Nhắm mục tiêu theo nhà mạng – Bao gồm |
Cột này đã được cập nhật để sử dụng các giá trị
Truy xuất tài nguyên |
|
Tiêu chí nhắm mục tiêu theo kênh – Loại trừ Tiêu chí nhắm mục tiêu theo kênh – Bao gồm |
Cột này đã được cập nhật để sử dụng giá trị
Truy xuất tài nguyên |
|
Nhắm mục tiêu theo thiết bị – Loại trừ Nhắm mục tiêu theo thiết bị – Bao gồm |
Cột này đã được cập nhật để sử dụng các giá trị
Truy xuất tài nguyên |
Nhắm mục tiêu theo trang web – Loại trừ Nhắm mục tiêu theo trang web – Bao gồm |
Cột này đã được cập nhật để xác định các trang web thông qua chuỗi URL. |
Sản phẩm đa phương tiện
| Hướng dẫn di chuyển cột cho phiên bản 7 | |
|---|---|
|
Tiêu chí nhắm mục tiêu theo kênh – Loại trừ Tiêu chí nhắm mục tiêu theo kênh – Bao gồm |
Cột này đã được cập nhật để sử dụng giá trị
Truy xuất tài nguyên |
| Nhắm mục tiêu theo thiết bị – Bao gồm |
Cột này đã được cập nhật để sử dụng các giá trị
Truy xuất tài nguyên |
Thêm tính năng tích hợp với các cột được thêm kể từ phiên bản 6
Nếu di chuyển từ phiên bản 6 sang phiên bản 7, bạn cần thêm các cột sau vào các tệp có liên quan:
| Loại tệp | Cột |
|---|---|
| Mục riêng | Số lượt hiển thị theo tần suất mục tiêu của chiến dịch TrueView |
| Mục riêng | Khoảng thời gian của tần suất mục tiêu TrueView |
| Nhóm quảng cáo trên YouTube | Nhắm mục tiêu được tối ưu hoá |
Nếu bạn đang di chuyển từ một phiên bản Tệp dữ liệu có cấu trúc trước đó, hãy tham khảo Ghi chú phát hành của Tệp dữ liệu có cấu trúc để biết thông tin về các cột bổ sung được thêm vào giữa phiên bản hiện tại và SDF phiên bản 6.
Các nội dung thay đổi khác
Trong phiên bản 7, chúng tôi cũng đã thực hiện một số thay đổi nhỏ để giúp bạn đơn giản hoá quá trình tích hợp và không sử dụng Tệp đọc thực thể không dùng nữa để tham khảo.
Thứ tự danh sách mới cho một tập hợp con các cột
SDF phiên bản 7 đảm bảo thứ tự ổn định của một số cột danh sách nhất định khi tạo tệp. Điều này giúp hành vi nhất quán hơn và dễ xem xét hơn. Thứ tự này không được thực thi khi tải tệp lên, nhưng được áp dụng sau đó khi tạo tệp đã cập nhật.
Xem ghi chú phát hành phiên bản 7 để biết danh sách đầy đủ các cột hiện được tạo theo thứ tự tăng dần theo số hoặc thứ tự bảng chữ cái.
Đề xuất mới về thông tin tham chiếu trên giấy tờ tuỳ thân
Chúng tôi đã cập nhật định nghĩa của một số cột để xoá nội dung tham chiếu đến Tệp đọc thực thể không dùng nữa và thay vào đó, đề xuất các phương thức tra cứu mã nhận dạng khác.
Các giá trị do các cột sau trả về không khác gì so với SDF phiên bản 6, nhưng bạn nên cập nhật chế độ tích hợp để truy xuất mã nhận dạng bằng phương thức đề xuất mới. Bạn có thể tìm thấy phương thức này trong phần mô tả cột phiên bản 7.
| Loại tệp và các cột của loại tệp | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chiến dịch |
|
|||||||||||||||||||||
| Đơn đặt hàng quảng cáo |
|
|||||||||||||||||||||
| Mục hàng |
|
|||||||||||||||||||||
| Sản phẩm đa phương tiện |
|
|||||||||||||||||||||
| Nhóm quảng cáo trên YouTube |
|
|||||||||||||||||||||