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

Lần cập nhật gần đây nhất: 18/10/2023

Hướng dẫn này sẽ chỉ cho 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ừ phiên bản trước và các thay đổi (cả bắt buộc và đề xuất) mà bạn có thể thực hiện để tối ưu hoá quá trình tích hợp hiệu quả hơ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 6 và phiên bản 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ừ phiên bản trước, bạn phải chỉ định phiên bản mới, cập nhật không gian mã nhận dạng cho một số ít cột hiện có và 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 mới cho Tệp dữ liệu có cấu trúc, bạn cần cập nhật phiên bản mà bạn chỉ định cho tài nguyên chính của Đối tác và Nhà quảng cáo 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 gốc

Phiên bản Tệp dữ liệu có cấu trúc mặc định được thiết lập ở cấp đối tác và cấp tài nguyên của 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 bạn muốn. 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 bạn muốn nhắm đến. Chuyển đến trang Chi tiết cơ bản trong trình đơn Cài đặt nhà quảng cáo ở đ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. Nếu phiên bản mặc định được đặt ở cấp Đối tác, thì chế độ cài đặt này có thể không chỉnh sửa được.

Được thiết lập trong API

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

Gửi yêu cầu advertisers.patch để cập nhật dataAccessConfig.sdfConfig.sdfConfig.version thành SDF_VERSION_7 và nếu cần, dataAccessConfig.sdfConfig.overridePartnerSdfConfig thành True.

Cập nhật sdfdownloadtasks.create yêu cầu 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ã trong các cột bắt buộc

Trong phiên bản 7, không gian mã nhận dạng mà một nhóm nhỏ cột sử dụng đã được cập nhật để phân tách Tệp dữ liệu có cấu trúc khỏi sản phẩm Entity Read Files (Tệp đọc thực thể) không dùng nữa và điều chỉnh thêm với các công cụ được hỗ trợ, chẳng hạn như Display & Video 360 API.

Cảnh báo: Mã nhận dạng đã cập nhật có thể không tương thích với tập lệnh đặt giá thầu tuỳ chỉnh. Bạn nên xem tài liệu tham khảo về tín hiệu của tập lệnh đặt giá thầu tuỳ chỉnh để biết thông tin mới nhất về các mã nhận dạng nên được dùng trước khi di chuyển.

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 phiên bản 7 cho các cột
Nhắm mục tiêu ứ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 "App Platform:App ID". Ví dụ: "APP:com.google.android.gm", "APP:422689480", "ANDROID_TV_APP:com.google.android.youtube.tvunplugged" 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 trên Cửa hàng Play của Android hoặc mã ứng dụng trên 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ị targetingOptionId của tài nguyên TargetingOption API Display & Video 360 trong loại tiêu chí nhắm mục tiêu TARGETING_TYPE_BROWSER. Truy xuất từng tài nguyên TargetingOption hoặc trong danh sách được phân trang bằng dịch vụ targetingTypes.targetingOptions.
Nhắm mục tiêu theo mạng di động - Loại trừ Nhắm mục tiêu theo mạng di động - Bao gồm	Cột này đã được cập nhật để sử dụng các giá trị targetingOptionId của tài nguyên TargetingOption API Display & Video 360 trong loại tiêu chí nhắm mục tiêu TARGETING_TYPE_CARRIER_AND_ISP. Truy xuất từng tài nguyên TargetingOption hoặc trong danh sách được phân trang bằng dịch vụ targetingTypes.targetingOptions.
Nhắm mục tiêu theo kênh - Loại trừ 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ị channelId của tài nguyên Channel Display & Video 360 API. Truy xuất từng tài nguyên Channel hoặc trong danh sách được phân trang bằng các dịch vụ advertisers.channels và partners.channels.
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ị targetingOptionId của tài nguyên TargetingOption Display & Video 360 API trong các loại nhắm mục tiêu sau: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Truy xuất từng tài nguyên TargetingOption hoặc trong danh sách được phân trang bằng dịch vụ targetingTypes.targetingOptions.
Đo lường Kênh Đại lý được ủy quyền của nhà phân phối (DAR)	Cột này đã được cập nhật để sử dụng giá trị channelId của tài nguyên Channel Display & Video 360 API. Truy xuất từng tài nguyên Channel hoặc trong danh sách được phân trang bằng các dịch vụ advertisers.channels và partners.channels.
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 phiên bản 7 cho các cột
Nhắm mục tiêu ứ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 "App Platform:App ID". Ví dụ: "APP:com.google.android.gm", "APP:422689480", "ANDROID_TV_APP:com.google.android.youtube.tvunplugged" 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 trên Cửa hàng Play của Android hoặc mã ứng dụng trên 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 app (ứng dụng) đã được cập nhật để sử dụng các giá trị chuỗi nối tiếp nhau của nền tảng ứng dụng và mã nền tảng ứng dụng, 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 liên quan cung cấp, chẳng hạn như mã gói trên Cửa hàng Play của Android hoặc mã ứng dụng trên App Store của Apple. Loại hàng site đã được cập nhật để sử dụng các 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ị targetingOptionId của tài nguyên TargetingOption API Display & Video 360 trong loại tiêu chí nhắm mục tiêu TARGETING_TYPE_BROWSER. Truy xuất từng tài nguyên TargetingOption hoặc trong danh sách được phân trang bằng dịch vụ targetingTypes.targetingOptions.
Nhắm mục tiêu theo mạng di động - Loại trừ Nhắm mục tiêu theo mạng di động - Bao gồm	Cột này đã được cập nhật để sử dụng các giá trị targetingOptionId của tài nguyên TargetingOption API Display & Video 360 trong loại tiêu chí nhắm mục tiêu TARGETING_TYPE_CARRIER_AND_ISP. Truy xuất từng tài nguyên TargetingOption hoặc trong danh sách được phân trang bằng dịch vụ targetingTypes.targetingOptions.
Nhắm mục tiêu theo kênh - Loại trừ 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ị channelId của tài nguyên Channel Display & Video 360 API. Truy xuất từng tài nguyên Channel hoặc trong danh sách được phân trang bằng các dịch vụ advertisers.channels và partners.channels.
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ị targetingOptionId của tài nguyên TargetingOption Display & Video 360 API trong các loại nhắm mục tiêu sau: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Truy xuất từng tài nguyên TargetingOption hoặc trong danh sách được phân trang bằng dịch vụ targetingTypes.targetingOptions.
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 truyền thông

Hướng dẫn di chuyển phiên bản 7 cho các cột
Nhắm mục tiêu theo kênh - Loại trừ 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ị channelId của tài nguyên Channel Display & Video 360 API. Truy xuất từng tài nguyên Channel hoặc trong danh sách được phân trang bằng các dịch vụ advertisers.channels và partners.channels.
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ị targetingOptionId của tài nguyên TargetingOption Display & Video 360 API trong các loại nhắm mục tiêu sau: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Truy xuất từng tài nguyên TargetingOption hoặc trong danh sách được phân trang bằng dịch vụ targetingTypes.targetingOptions.

Thêm liên kết tích hợp với các cột được thêm kể từ phiên bản 6

Nếu 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 liên quan:

Loại tệp	Cột
Mục riêng	Số lượng tần suất mục tiêu TrueView
Mục riêng	Khoảng thời gian tần suất mục tiêu TrueView
Nhóm quảng cáo trên YouTube	Tính năng nhắm mục tiêu được tối ưu hoá

Nếu bạn di chuyển từ phiên bản Tệp dữ liệu có cấu trúc 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 bề ngoài để giúp bạn đơn giản hoá quá trình tích hợp của mình và ngừng sử dụng các 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 v7 đả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. Nhờ đó, bạn sẽ hoạt động nhất quán hơn và xem xét dễ dàng hơn. Thứ tự này không được thực thi khi tải tệp lên, nhưng sẽ được áp dụng sau đó khi bạn tạo tệp đã cập nhật.

Xem lại 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ự số hoặc bảng chữ cái tăng dần.

Đề xuất mới để tham chiếu về mã nhận dạng

Chúng tôi đã cập nhật định nghĩa của một số cột để xoá tham chiếu đến tệp đọc thực thể không dùng nữa, đồng thời đề xuất các phương thức tra cứu mã nhận dạng khác.

Giá trị mà các cột sau trả về không khác với giá trị trong SDF phiên bản 6, nhưng bạn nên cập nhật chức năng tích hợp để truy xuất mã nhận dạng bằng phương thức mới được đề xuất. Bạn có thể xem phương thức này trong phần mô tả cột phiên bản 7 của chúng.

Loại tệp và cột của tệp
Chiến dịch	Nhắm mục tiêu theo địa lý - Loại trừ Nhắm mục tiêu theo địa lý - Bao gồm Nhắm mục tiêu nguồn khoảng không quảng cáo - Loại trừ Nhắm mục tiêu nguồn khoảng không quảng cáo - Bao gồm Nhắm mục tiêu theo ngôn ngữ - Loại trừ Nhắm mục tiêu theo ngôn ngữ - Bao gồm
Đơn đặt hàng quảng cáo	Nhắm mục tiêu theo đối tượng chung sở thích & trong thị trường - Loại trừ Nhắm mục tiêu theo đối tượng chung sở thích và trong thị trường – Bao gồm Nhắm mục tiêu bộ sưu tập ứng dụng - Loại trừ Nhắm mục tiêu bộ sưu tập ứng dụng - Bao gồm Nhắm mục tiêu theo đối tượng – Loại trừ Nhắm mục tiêu theo đối tượng – Bao gồm Nhắm mục tiêu theo danh mục – Loại trừ Nhắm mục tiêu theo danh mục - Bao gồm Nhắm mục tiêu theo thể loại nội dung - Loại trừ Nhắm mục tiêu theo thể loại nội dung - Bao gồm Nhắm mục tiêu theo danh sách tuỳ chỉnh Nhắm mục tiêu theo địa lý - Loại trừ Nhắm mục tiêu theo địa lý - Bao gồm Nhắm mục tiêu nguồn khoảng không quảng cáo - Loại trừ Nhắm mục tiêu nguồn khoảng không quảng cáo - Bao gồm Nhắm mục tiêu danh sách từ khóa - Loại trừ Nhắm mục tiêu theo ngôn ngữ - Loại trừ Nhắm mục tiêu theo ngôn ngữ - Bao gồm
Mục hàng	Nhắm mục tiêu theo đối tượng chung sở thích & trong thị trường - Loại trừ Nhắm mục tiêu theo đối tượng chung sở thích và trong thị trường – Bao gồm Nhắm mục tiêu bộ sưu tập ứng dụng - Loại trừ Nhắm mục tiêu bộ sưu tập ứng dụng - Bao gồm Nhắm mục tiêu theo đối tượng – Loại trừ Nhắm mục tiêu theo đối tượng – Bao gồm Nhắm mục tiêu theo danh mục – Loại trừ Nhắm mục tiêu theo danh mục - Bao gồm Nhắm mục tiêu theo Đối tượng được kết hợp Nhắm mục tiêu theo thể loại nội dung - Loại trừ Nhắm mục tiêu theo thể loại nội dung - Bao gồm Mã hoạt động Floodlight của lượt chuyển đổi Chỉ định mẫu quảng cáo Nhắm mục tiêu theo danh sách tuỳ chỉnh Nhắm mục tiêu theo địa lý - Loại trừ Nhắm mục tiêu theo địa lý - Bao gồm Nhắm mục tiêu nguồn khoảng không quảng cáo - Loại trừ Nhắm mục tiêu nguồn khoảng không quảng cáo - Bao gồm Nhắm mục tiêu danh sách từ khóa - Loại trừ Nhắm mục tiêu theo ngôn ngữ - Loại trừ Nhắm mục tiêu theo ngôn ngữ - Bao gồm
Sản phẩm truyền thông	Nhắm mục tiêu theo đối tượng – Loại trừ Nhắm mục tiêu theo đối tượng – Bao gồm Nhắm mục tiêu theo danh mục – Loại trừ Nhắm mục tiêu theo danh mục - Bao gồm Nhắm mục tiêu theo địa lý - Bao gồm Nhắm mục tiêu theo ngôn ngữ - Loại trừ Nhắm mục tiêu theo ngôn ngữ - Bao gồm
Nhóm quảng cáo trên YouTube	Nhắm mục tiêu theo đối tượng chung sở thích & trong thị trường - Loại trừ Nhắm mục tiêu theo đối tượng chung sở thích và trong thị trường – Bao gồm Nhắm mục tiêu theo đối tượng – Loại trừ Nhắm mục tiêu theo đối tượng – Bao gồm Nhắm mục tiêu theo danh mục – Loại trừ Nhắm mục tiêu theo danh mục - Bao gồm Nhắm mục tiêu theo danh sách tuỳ chỉnh