Di chuyển sang Tệp dữ liệu có cấu trúc phiên bản 8

Lần cập nhật gần đây nhất: 12/11/2024

Hướng dẫn này sẽ hướng dẫn bạn quy trình di chuyển từ việc sử dụng Tệp dữ liệu có cấu trúc phiên bản 7.1 sang phiên bản 8 và giải thích những thay đổi giữa hai phiên bản có thể ảnh hưởng đến quá trình tích hợp của bạn.

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 7.1 và phiên bản 8.

Di chuyển phiên bản Tệp dữ liệu có cấu trúc

Cách di chuyển sang Tệp dữ liệu có cấu trúc (SDF) phiên bản 8 từ phiên bản trước:

  1. Cập nhật tài nguyên và các hành động tạo SDF để sử dụng v8.
  2. Cập nhật logic tài nguyên quảng cáo để xác định loại khi tạo.
  3. Thêm logic mới để đọc, tạo và cập nhật tài nguyên Tạo nhu cầu.

Cập nhật phiên bản Tệp dữ liệu có cấu trúc

Để sử dụng phiên bản Tệp dữ liệu có cấu trúc mới, hãy cập nhật phiên bản được chỉ định trong tài nguyên Đối tác và Nhà quảng cáo gốc, đồng thời sử dụng phiên bản mới khi tạo các tác vụ tải xuống riêng lẻ trong Display & Video 360 API.

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

  1. Chuyển đến đối tác dự định.
  2. Mở rộng trình đơn Cài đặt đối tác trong bảng điều hướng bên trái rồi chuyển đến trang Thông tin cơ bản.
  3. 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 v8.

Ở cấp nhà quảng cáo

  1. Chuyển đến nhà quảng cáo dự định.
  2. Mở rộng trình đơn Cài đặt nhà quảng cáo trong bảng điều hướng bên trái rồi chuyển đến trang Thông tin cơ bản.
  3. 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 v8. 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 đối tác
Bạn không thể đặt phiên bản SDF mặc định ở cấp Đối tác trong API.
Ở cấp nhà quảng cáo
Tạo yêu cầu advertisers.patch để cập nhật dataAccessConfig.sdfConfig.sdfConfig.version thành SDF_VERSION_8 và nếu cần, dataAccessConfig.sdfConfig.overridePartnerSdfConfig thành True.

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 phần nội dung yêu cầu thành SDF_VERSION_8.

Chỉ định loại trong phần Tài nguyên quảng cáo

Phiên bản 8 thêm cột Ad Type vào tệp Quảng cáo. Cột này hiển thị loại Quảng cáo do mỗi hàng đại diện. Bạn bắt buộc phải sử dụng cột mới này và cột này sẽ được điền sẵn cho các tài nguyên hiện có khi tải tệp Quảng cáo v8 xuống.

Khi cập nhật Quảng cáo hiện có, bạn không được thay đổi giá trị của cột này.

Khi tạo Quảng cáo mới, bạn phải điền vào cột này một trong các giá trị được liệt kê trong phần mô tả cột.

Cập nhật logic cho tài nguyên Tạo nhu cầu

Phiên bản 8 hỗ trợ việc tạo, truy xuất và cập nhật chiến dịch Tạo nhu cầu bằng các tệp Mục hàng, Nhóm quảng cáo và Quảng cáo. Các tài nguyên Demand Gen sử dụng logic khác để xác minh dấu thời gian, yêu cầu điền sẵn các cột bổ sung và bị giới hạn bởi các quy định hạn chế mới đối với ba loại tệp.

Xác minh dấu thời gian

Đối với tất cả mục hàng không phải mục hàng Tạo nhu cầu, cột Timestamp của tệp Mục hàng sẽ được điền sẵn thời gian sửa đổi gần đây nhất của mục hàng khi tải xuống. Giá trị này được dùng khi cập nhật mục hàng bằng SDF để xác minh rằng mục hàng chưa được cập nhật kể từ khi tệp gốc được tải xuống. Nếu có, quá trình cập nhật sẽ không thành công.

Đối với mục hàng Tạo nhu cầu, cột Timestamp và quy trình xác minh đi kèm sẽ hoạt động theo cách khác. Đối với các mục hàng Tạo nhu cầu, cột này sẽ được điền sẵn thời gian hiện tại tại thời điểm tải xuống. Khi tải lên, Display & Video 360 sẽ kiểm tra xem đã hơn 24 giờ kể từ dấu thời gian đã cho hay chưa. Nếu đã hơn 24 giờ, mục nhập tệp gốc sẽ được coi là cũ và quá trình cập nhật sẽ không thành công. Nếu điều này xảy ra, hãy tải tệp xuống lại và cập nhật dựa trên phiên bản mới hơn. Phương thức xác minh mới này không ngăn bạn ghi đè các thay đổi đã thực hiện trong 24 giờ qua. Để tránh tình trạng ghi đè vô tình, chỉ đưa các mục hàng Tạo nhu cầu mà bạn muốn cập nhật vào tệp mà bạn tải lên.

Cột bắt buộc

Các loại tệp sau đây hiện có các cột bắt buộc đối với một số tài nguyên Demand Gen, ngoài các cột bắt buộc đối với tất cả thực thể của loại tệp đó.

Mục riêng
Các cột bắt buộc cho các giá trị cột Mặt hàng Type sau đây
Tạo nhu cầu
Pacing Amount
TrueView Bid Strategy Type
TrueView Bid Strategy Value
Các cột bắt buộc cho các giá trị cột Quảng cáo Ad Type sau đây
Băng chuyền tạo nhu cầu
Business Name
Call to Action
Demand Gen Cards
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Hình ảnh tạo nhu cầu
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Marketing Image Asset Id
Sản phẩm tạo nhu cầu
Business Name
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video tạo nhu cầu
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video Id

Các quy định hạn chế mới cập nhật

Ngoài các cột bắt buộc mới cho một số Mục hàng và Quảng cáo Tạo nhu cầu nhất định, nhiều cột trên các loại tệp Mục hàng, Nhóm quảng cáo và Quảng cáo có các quy định hạn chế mới về việc sử dụng áp dụng cho tài nguyên Tạo nhu cầu.

Có rất nhiều quy định hạn chế và mỗi cột lại có quy định riêng, vì vậy, hướng dẫn này không cung cấp danh sách đầy đủ các quy định hạn chế. Bạn nên đọc kỹ tài liệu tham khảo v8 về các loại tệp Mục hàng, Nhóm quảng cáo và Quảng cáo trước khi tạo hoặc cập nhật tài nguyên Tạo nhu cầu bằng cách tải tệp SDF lên.