Bạn có thể truy xuất các mục hàng YouTube và đối tác, nhóm quảng cáo và tài nguyên quảng cáo của các mục hàng đó, cũng như tiêu chí nhắm mục tiêu phù hợp với hoạt động phân phát quảng cáo YouTube và đối tác bằng API Display & Video 360. Bạn chỉ có thể tạo tài nguyên và tiêu chí nhắm mục tiêu YouTube và đối tác hoặc cập nhật thông qua giao diện người dùng.
Trang này mô tả cách sử dụng API Display & Video 360 để xác định tài nguyên YouTube & Đối tác và truy xuất tiêu chí nhắm mục tiêu có liên quan, cũng như cách tạo và cập nhật hàng loạt tài nguyên YouTube & Đối tác bằng cách sử dụng Tệp dữ liệu có cấu trúc (SDF) trong giao diện người dùng.
Xác định tài nguyên của YouTube và Đối tác
Tài nguyên YouTube và đối tác bao gồm một số loại mục hàng, Nhóm quảng cáo và Quảng cáo.
Mục hàng
Các mục hàng có giá trị LineItemType
sau đây là mục hàng YouTube và đối tác và không thể tạo hoặc cập nhật:
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
Bạn có thể truy xuất chế độ cài đặt dành riêng cho mục hàng YouTube và đối tác từ trường youtubeAndPartnersSettings
của tài nguyên LineItem
.
Nhóm quảng cáo và quảng cáo trên YouTube
Nhóm quảng cáo và quảng cáo trên YouTube là các tài nguyên con trong mục hàng YouTube và đối tác, cho phép bạn cung cấp thêm thông tin chi tiết.
Một mục hàng YouTube và đối tác có thể có nhiều tài nguyên AdGroup
, mỗi tài nguyên có tiêu chí nhắm mục tiêu bổ sung và chiến lược đặt giá thầu riêng. Trong mỗi tài nguyên AdGroup
có thể có nhiều tài nguyên AdGroupAd
thuộc cùng một định dạng quảng cáo, mỗi tài nguyên có thông tin mẫu quảng cáo và danh sách URL theo dõi bổ sung riêng.
Truy xuất tiêu chí nhắm mục tiêu
Tiêu chí nhắm mục tiêu dùng để phân phát quảng cáo trên YouTube và đối tác được chỉ định ở cấp nhà quảng cáo, cấp mục hàng và cấp Nhóm quảng cáo.
Mục tiêu YouTube và đối tác được kế thừa từ tài nguyên mẹ không được phản ánh trong chế độ cài đặt mục tiêu của tài nguyên con, như tiêu chuẩn đối với các tài nguyên không phải YouTube và đối tác.
Để truy xuất tất cả tiêu chí nhắm mục tiêu liên quan đến việc phân phát quảng cáo của YouTube và Đối tác, bạn phải:
- truy xuất tiêu chí nhắm mục tiêu được chỉ định cho nhà quảng cáo gốc bằng cách sử dụng
advertisers.listAssignedTargetingOptions
, - truy xuất tiêu chí nhắm mục tiêu được chỉ định cho mục hàng mẹ bằng cách sử dụng
advertisers.lineItems.bulkListAssignedTargetingOptions
, - và truy xuất tiêu chí nhắm mục tiêu được chỉ định cho nhóm quảng cáo gốc bằng cách sử dụng
advertisers.adGroups.bulkListAssignedTargetingOptions
.
Cố gắng sửa đổi tiêu chí nhắm mục tiêu trên YouTube
Cũng như đối với các tài nguyên YouTube và Đối tác, bạn không thể sửa đổi tiêu chí nhắm mục tiêu YouTube và Đối tác bằng API Display & Video 360. Mọi nỗ lực sửa đổi tiêu chí nhắm mục tiêu sau đây sẽ trả về lỗi:
- Tiêu chí nhắm mục tiêu được chỉ định ở bất kỳ cấp nào của các loại tiêu chí nhắm mục tiêu sau:
TARGETING_TYPE_SESSION_POSITION
,TARGETING_TYPE_YOUTUBE_CHANNEL
vàTARGETING_TYPE_YOUTUBE_VIDEO
. - Tiêu chí nhắm mục tiêu được chỉ định cho tài nguyên mục hàng YouTube và đối tác.
- Nhắm mục tiêu được chỉ định cho tài nguyên
AdGroup
.
Tạo và cập nhật bằng tính năng tải lên giao diện người dùng SDF
Mặc dù không thể tạo hoặc cập nhật tài nguyên YouTube & Đối tác bằng API Display & Video 360, nhưng bạn có thể tạo hoặc cập nhật hàng loạt mục hàng, nhóm quảng cáo và quảng cáo YouTube & Đối tác bằng cách tải Tệp dữ liệu có cấu trúc (SDF) lên thông qua giao diện người dùng Display & Video 360.
Các tài nguyên này được biểu thị trong SDF thông qua các định dạng tệp Mục hàng, Nhóm quảng cáo trên YouTube và Quảng cáo trên YouTube.
Bạn có thể tạo và tải Tệp dữ liệu có cấu trúc xuống bằng API Display & Video 360. Chỉnh sửa các hàng hiện có để thay đổi tài nguyên hiện có hoặc thêm các hàng mới để tạo tài nguyên mới, đồng thời tải các tệp đã cập nhật lên thông qua giao diện người dùng Display & Video 360.