Chiến dịch video

Chiến dịch video cho phép bạn hiển thị quảng cáo dạng video trên YouTube, cũng như trên các trang web và ứng dụng chạy trên các đối tác video của Google.

Giới hạn của API

Google Ads API chủ yếu hỗ trợ việc tìm nạp và báo cáo về các chiến dịch Video, nhóm quảng cáo, quảng cáo và tiêu chí hiện có. Bạn không thể tạo hoặc thay đổi chiến dịch Video bằng Google Ads API, ngoại trừ một số trường hợp và hành vi cụ thể theo phiên bản sau đây:

• Khả năng biến đổi của VideoResponsiveAdInfo: Kể từ v24, các đối tượng VideoResponsiveAdInfo có thể biến đổi (trong các phiên bản trước, các đối tượng này không thể biến đổi). Khi tạo hoặc thay đổi VideoResponsiveAdInfo, bạn bắt buộc phải điền vào các trường videos, business_name và logo_images.
• Mức độ phù hợp về sự an toàn cho thương hiệu: Kể từ v24, campaign.video_brand_safety_suitability ở cấp chiến dịch sẽ bị xoá. Truy vấn mức độ phù hợp về sự an toàn cho thương hiệu ở cấp tài khoản bằng cách sử dụng customer.video_brand_safety_suitability.
• Thử nghiệm chiến dịch Video: Kể từ phiên bản v24, bạn có thể sử dụng experiment.video_experiment để định cấu hình cho các thử nghiệm YOUTUBE_CUSTOM bao gồm chiến dịch Video.

Các giải pháp thay thế cho việc quản lý chiến dịch

Nếu bạn cần tạo hoặc quản lý chiến dịch Video theo phương thức lập trình, hãy cân nhắc các lựa chọn sau:

• Tập lệnh Google Ads: Bạn có thể quản lý chiến dịch Video bằng tập lệnh Google Ads. Nhờ đó, bạn có thể quản lý tự động trong giao diện Google Ads.
• Chiến dịch Tạo nhu cầu: Nếu mục tiêu của bạn là phân phát quảng cáo dạng video trên các sản phẩm của Google (bao gồm cả YouTube), thì Google Ads API hỗ trợ đầy đủ chiến dịch Tạo nhu cầu cho cả việc tạo và quản lý.

Xem dữ liệu hiệu suất

Bạn có thể truy xuất dữ liệu hiệu suất cho chiến dịch Video, nhóm quảng cáo và tiêu chí bằng cách sử dụng GoogleAdsService.SearchStream bằng cách lọc theo campaign.advertising_channel_type = 'VIDEO'.

Lưu ý: Sử dụng metrics.video_trueview_views, metrics.video_trueview_view_rate và metrics.trueview_average_cpv cho các chỉ số về lượt xem theo TrueView. Kể từ ngày v25, bạn cũng có thể chọn segments.ad_sub_format_type (bên cạnh segments.ad_format_type) để phân tích quảng cáo trong luồng phát không thể bỏ qua theo thời lượng, cũng như các chỉ số tương tác trên mạng xã hội của video (metrics.youtube_comments, metrics.youtube_likes và metrics.youtube_shares).

Hiệu suất nhóm quảng cáo

Truy vấn sau đây truy xuất các chỉ số của chiến dịch Video và nhóm quảng cáo, bao gồm cả số lượt xem video TrueView và tỷ lệ hoàn thành theo phần tư, từ tài nguyên ad_group:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  ad_group.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.video_trueview_views,
  metrics.video_quartile_p100_rate
FROM ad_group
WHERE campaign.advertising_channel_type = 'VIDEO'

Báo cáo về tiêu chí và vị trí đặt video

Vì ad_group_criterion không hỗ trợ trực tiếp các chỉ số hoặc phân đoạn, nên hãy sử dụng các tài nguyên chế độ xem tiêu chí như managed_placement_view để truy xuất các chỉ số hiệu suất cho video trên YouTube, kênh YouTube hoặc các vị trí được quản lý khác:

SELECT
  campaign.id,
  ad_group.id,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.youtube_channel.channel_id,
  metrics.impressions,
  metrics.video_trueview_views
FROM managed_placement_view
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND ad_group_criterion.type IN ('YOUTUBE_VIDEO', 'YOUTUBE_CHANNEL')
  AND segments.date DURING LAST_30_DAYS

Báo cáo phạm vi tiếp cận và tần suất của chiến dịch

Đối với chiến dịch Video, bạn có thể truy vấn các chỉ số Phạm vi tiếp cận riêng biệt trên tài nguyên campaign để đo lường số người dùng riêng biệt đã nhìn thấy quảng cáo của bạn ở các tần suất hiển thị cụ thể.

Các chỉ số sau đây về người dùng riêng biệt đo lường phạm vi tiếp cận đối tượng theo các nhóm tần suất:

• metrics.unique_users: Số người dùng riêng biệt đã xem quảng cáo của bạn ít nhất một lần trong phạm vi ngày đã chọn (tối đa 92 ngày). Bạn không thể tổng hợp dữ liệu này trên các hàng.
• metrics.unique_users_two_plus đến metrics.unique_users_ten_plus: Số người dùng riêng biệt đã xem quảng cáo của bạn ít nhất từ 2 đến 10 lần, tương ứng, trong phạm vi ngày tối đa là 31 ngày (với metrics.unique_users_six_plus đến metrics.unique_users_nine_plus hoàn thành tập hợp từ 2+ đến 10+ trong phiên bản 26 trở lên).
• metrics.average_impression_frequency_per_user: Số lần trung bình mà một người dùng riêng biệt nhìn thấy quảng cáo của bạn trong khoảng thời gian được yêu cầu (tối đa 92 ngày). Bạn không thể tổng hợp chỉ số này trên các hàng và chỉ số này không có trường _info đi kèm.

Trong phiên bản 26 trở lên, mỗi chỉ số phạm vi tiếp cận đều có một trường siêu dữ liệu đồng hành thuộc loại ReachMetricInfo: metrics.unique_users_info và metrics.unique_users_two_plus_info đến metrics.unique_users_ten_plus_info.

Trong Ngôn ngữ truy vấn của Google Ads (GAQL), các trường phạm vi tiếp cận đồng hành là MESSAGE chỉ số được chọn trực tiếp trong mệnh đề SELECT (ví dụ: metrics.unique_users_info). Đừng thêm .reach_metric_states vào mệnh đề SELECT, vì việc chọn các trường thông báo lồng nhau trong GAQL sẽ không thành công với UNRECOGNIZED_FIELD. Thay vào đó, việc chọn metrics.unique_users_info sẽ trả về một thông báo ReachMetricInfo chứa trường enum lặp lại reach_metric_states thuộc loại ReachMetricState, mô tả liệu chỉ số đã bị chặn hay đã hoàn tất.

Bất cứ khi nào một chỉ số phạm vi tiếp cận bị chặn hoặc nằm ngoài khoảng thời gian lưu giữ (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION hoặc DATE_RANGE_BEYOND_RETENTION), trường optional int64 của chỉ số đó trên Metrics sẽ không được đặt (đánh giá thành 0 nếu không kiểm tra sự hiện diện của trường), trong khi LOW_QUALITY vẫn điền chỉ số dạng số.

Giá trị enum ReachMetricState cho biết trạng thái của dữ liệu phạm vi tiếp cận:

• COMPLETE: Chỉ số về phạm vi tiếp cận đã hoàn tất và không bị chặn do quyền riêng tư, chất lượng hoặc các giới hạn khác.
• PRIVACY_SUPPRESSION: Dữ liệu về phạm vi tiếp cận đã bị loại bỏ để bảo vệ quyền riêng tư của người dùng (ví dụ: khi số lượng đối tượng không đáp ứng ngưỡng k-anonymity).
• QUALITY_SUPPRESSION: Dữ liệu về phạm vi tiếp cận đã bị ẩn do các yêu cầu về chất lượng dữ liệu.
• LOW_QUALITY: Chỉ số phạm vi tiếp cận đã được tính nhưng bị gắn cờ là có chất lượng thấp.
• DATE_RANGE_BEYOND_RETENTION: Không có chỉ số về phạm vi tiếp cận vì phạm vi ngày đã chọn vượt quá khoảng thời gian lưu giữ dữ liệu là 3 năm đối với dữ liệu về phạm vi tiếp cận.

Truy vấn sau đây truy xuất các chỉ số phạm vi tiếp cận và trạng thái chặn của các chỉ số đó cho một chiến dịch Video:

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  segments.device,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.average_impression_frequency_per_user,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_three_plus,
  metrics.unique_users_three_plus_info,
  metrics.unique_users_four_plus,
  metrics.unique_users_four_plus_info,
  metrics.unique_users_five_plus,
  metrics.unique_users_five_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_seven_plus,
  metrics.unique_users_seven_plus_info,
  metrics.unique_users_eight_plus,
  metrics.unique_users_eight_plus_info,
  metrics.unique_users_nine_plus,
  metrics.unique_users_nine_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date BETWEEN '2026-01-01' AND '2026-01-31'

Lưu ý: Bạn không thể tổng hợp các chỉ số về phạm vi tiếp cận và tần suất trên các hàng. Mặc dù metrics.unique_users và metrics.average_impression_frequency_per_user hỗ trợ phạm vi ngày lên đến 92 ngày và có thể được phân đoạn theo segments.date, segments.device, segments.adjusted_age_range và segments.adjusted_gender, nhưng các chỉ số nhóm tần suất unique_users_*_plus (tối đa 31 ngày) và tất cả các trường metrics.unique_users*_info đồng hành chỉ hỗ trợ segments.date và segments.device. Ngoài ra, các trường metrics.unique_users*_info đồng hành là các chỉ số MESSAGE có filterable: false và sortable: false, vì vậy, bạn không thể sử dụng các trường này trong mệnh đề WHERE hoặc ORDER BY. Hãy xem bài viết Ẩn chỉ số phạm vi tiếp cận và giá trị bằng 0 để biết thêm thông tin chi tiết về cách xử lý chỉ số phạm vi tiếp cận bị ẩn trong báo cáo.