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 đủ về sự 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 từ phiên bản trước sang Tệp dữ liệu có cấu trúc phiên bản 7, 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 nhóm nhỏ các cột hiện có và tích hợp thêm 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 bạn chỉ định cho tài nguyên Đối tác và Nhà quảng cáo mẹ 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 của đố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

Tìm đến đối tác bạn muốn. Chuyển đến trang Chi tiết 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 v7.

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

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

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

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

Tạo một yêu cầu advertisers.patch để cập nhật dataAccessConfig.sdfConfig.sdfConfig.version thành SDF_VERSION_7 và nếu cần, hãy cập nhật 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 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, các 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 các Tệp dữ liệu có cấu trúc khỏi sản phẩm Entity Read Files không còn được dùng nữa, đồng thời điều chỉnh thêm với các công cụ được hỗ trợ như Display & Video 360 API.

Cảnh báo: Các mã đã 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 đặt giá thầu tuỳ chỉnh để biết thông tin mới nhất về các mã nhận dạng cần sử 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 mã 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

v7 Hướng dẫn di chuyển cho cột
Nhắm mục tiêu ứng dụng – Loại trừ Nhắm mục tiêu theo ứ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" Các nền tảng ứng dụng được xác định bằng một giá trị chuỗi. Mã ứng dụng là các mã nhận dạng do nền tảng có liên quan cung cấp, chẳng hạn như mã nhận dạng gói trong 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 các tài nguyên TargetingOption riêng lẻ hoặc trong các 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 các tài nguyên TargetingOption riêng lẻ hoặc trong các 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 API Display & Video 360. 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 API Display & Video 360 trong các loại tiêu chí nhắm mục tiêu sau: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Truy xuất các tài nguyên TargetingOption riêng lẻ hoặc trong các danh sách được phân trang bằng dịch vụ targetingTypes.targetingOptions.
Đo lường kênh DAR	Cột này đã được cập nhật để sử dụng giá trị channelId của tài nguyên Channel API Display & Video 360. 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

v7 Hướng dẫn di chuyển cho cột
Nhắm mục tiêu ứng dụng – Loại trừ Nhắm mục tiêu theo ứ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" Các nền tảng ứng dụng được xác định bằng một giá trị chuỗi. Mã ứng dụng là các mã nhận dạng do nền tảng có liên quan cung cấp, chẳng hạn như mã nhận dạng gói trong 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 app và site. Loại hàng app (ứng dụng) đã được cập nhật để sử dụng các giá trị chuỗi nối của mã 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í. Các nền tảng ứng dụng được xác định bằng một giá trị chuỗi. Mã ứng dụng là các mã do nền tảng có liên quan cung cấp, chẳng hạn như mã nhận dạng gói trong Cửa hàng Play của Android hoặc mã ứng dụng trong Cửa hàng ứng dụng của Apple. Chúng tôi đã cập nhật loại hàng trang web để 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ị 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 các tài nguyên TargetingOption riêng lẻ hoặc trong các 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 các tài nguyên TargetingOption riêng lẻ hoặc trong các 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 API Display & Video 360. 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 API Display & Video 360 trong các loại tiêu chí nhắm mục tiêu sau: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Truy xuất các tài nguyên TargetingOption riêng lẻ hoặc trong các 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

v7 Hướng dẫn di chuyển cho 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 API Display & Video 360. 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 API Display & Video 360 trong các loại tiêu chí nhắm mục tiêu sau: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Truy xuất các tài nguyên TargetingOption riêng lẻ hoặc trong các danh sách được phân trang bằng dịch vụ targetingTypes.targetingOptions.

Thêm mục tích hợp với các cột đã 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 liên quan:

Loại tệp	Cột
Mục riêng	Số 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 đ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 khác được thêm 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 hời hợt giúp bạn đơn giản hoá quá trình tích hợp và tránh sử dụng Entity Read Files không dùng nữa để tham khảo.

Thứ tự danh sách mới cho một số cột

SDF v7 đảm bảo thứ tự ổn định của một số cột danh sách khi tạo tệp. Điều này giúp xây dựng hành vi nhất quán hơn và giúp bạn 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 ghi chú phát hành phiên bản 7 để biết danh sách đầy đủ các cột hiện đang được tạo theo thứ tự số tăng dần hoặc thứ tự bảng chữ cái.

Đề xuất mới về tệp đối chiếu mã

Chúng tôi đã cập nhật định nghĩa của một số cột để xoá thông tin tham chiếu đến Entity Read Files (Tệp đọc thực thể) không dùng nữa và đề 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 trong SDF phiên bản 6, nhưng bạn nên cập nhật quá trình tích hợp để truy xuất mã nhận dạng bằng cách sử dụng phương thức mới được đề xuất. Bạn có thể tìm thấy phương thức mới này trong phần mô tả cột phiên bản 7.

Loại tệp và cột của loại 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 và đối tượng đang cân nhắc mua hàng – Loại trừ Nhắm mục tiêu theo đối tượng chung sở thích và đối tượng đang cân nhắc mua hà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 tùy 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 theo 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 và đối tượng đang cân nhắc mua hàng – Loại trừ Nhắm mục tiêu theo đối tượng chung sở thích và đối tượng đang cân nhắc mua hà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 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 tùy 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 theo 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 và đối tượng đang cân nhắc mua hàng – Loại trừ Nhắm mục tiêu theo đối tượng chung sở thích và đối tượng đang cân nhắc mua hà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 tùy chỉnh