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, nhóm quảng cáo, quảng cáo và tiêu chí Video 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ừ các trường hợp và hành vi cụ thể theo phiên bản sau đây:

  • VideoResponsiveAdInfo khả năng biến đổi: Kể từ phiên bản 24, các VideoResponsiveAdInfo đối tượng 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, các trường videos, business_name và logo_images là bắt buộc.
  • Mức độ phù hợp với sự an toàn cho thương hiệu: Kể từ phiên bản 24, 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 24, 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'.

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ề vị trí đặt video và tiêu chí

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

Đố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 và customer (bắt đầu từ phiên bản 26) để đo lường số lượng người dùng riêng biệt đã nhìn thấy quảng cáo của bạn ở 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 chỉ số 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). Chỉ số này chỉ có trên tài nguyên campaign, không thể tổng hợp trên các hàng và 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 người dùng riêng biệt đề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 metrics.unique_users*_info đồng hành là MESSAGE chỉ số 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. Chọn các trường này 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à trả về lỗ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ị loại bỏ 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ị chặn để 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ố phạm vi tiếp cận vì phạm vi ngày đã chọn vượt quá khoảng thời gian giữ lại dữ liệu là 3 năm đối với dữ liệu 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 đã loại bỏ trùng lặp trong 30 ngày và trạng thái chặn của các chỉ số đó cho chiến dịch Video, được phân đoạn theo thiết bị và định dạng quảng cáo. Bỏ qua phân đoạn segments.date khỏi mệnh đề SELECT để các chỉ số về phạm vi tiếp cận và tần suất N+ được loại bỏ trùng lặp trên toàn bộ khoảng thời gian thay vì theo ngày:

SELECT
  campaign.id,
  campaign.name,
  segments.device,
  segments.ad_format_type,
  segments.ad_sub_format_type,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS

Các tài nguyên, khoảng thời gian và phân khúc được hỗ trợ

Các truy vấn về phạm vi tiếp cận và tần suất yêu cầu bộ lọc segments.date hữu hạn trong phạm vi ngày tối đa của chỉ số. Các truy vấn không có bộ lọc ngày hoặc vượt quá khoảng thời gian sẽ trả về các trường phạm vi tiếp cận chưa được đặt:

Chỉ số Tài nguyên Phạm vi ngày tối đa Phân khúc tương thích
metrics.unique_users campaign, customer (phiên bản 26 trở lên) 92 ngày segments.date, segments.device, phân khúc định dạng quảng cáo (phiên bản 26 trở lên), phân khúc mạng quảng cáo (phiên bản 26 trở lên) và phân khúc nhân khẩu học đã điều chỉnh
metrics.average_impression_frequency_per_user campaign 92 ngày segments.date, segments.device và các phân khúc nhân khẩu học đã điều chỉnh
metrics.unique_users_two_plus đến metrics.unique_users_ten_plus campaign, customer (phiên bản 26 trở lên) 31 ngày segments.date, segments.device, phân khúc định dạng quảng cáo (phiên bản 26 trở lên) và phân khúc mạng quảng cáo (phiên bản 26 trở lên)
metrics.unique_users*_info (phiên bản 26 trở lên) campaign, customer Chỉ số cơ bản về trận đấu segments.date, segments.device, phân đoạn định dạng quảng cáo và phân đoạn mạng quảng cáo

Khi phân đoạn truy vấn phạm vi tiếp cận, hãy áp dụng các quy tắc ràng buộc phân đoạn chung sau:

  • Phân đoạn định dạng quảng cáo so với phân đoạn mạng quảng cáo: Bạn có thể phân đoạn theo định dạng quảng cáo (segments.ad_format_type, có thể kèm theo segments.ad_sub_format_type) hoặc theo mạng quảng cáo (segments.ad_network_type, có thể kèm theo segments.ad_sub_network_type), nhưng bạn không thể kết hợp phân đoạn định dạng quảng cáo và phân đoạn mạng quảng cáo trong cùng một truy vấn. Luôn chọn phân khúc mẹ (segments.ad_format_type hoặc segments.ad_network_type) khi chọn phân khúc con của phân khúc đó. Segment segments.ad_sub_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 và trả về UNSEGMENTED cho các định dạng quảng cáo khác, trong khi segment segments.ad_sub_network_type phân tích các nền tảng của YouTube (YOUTUBE_INSTREAM, YOUTUBE_INFEED và YOUTUBE_SHORTS) chỉ cho chiến dịch Tạo nhu cầu và trả về UNSEGMENTED cho chiến dịch Video.
  • Phân khúc nhân khẩu học đã điều chỉnh: Các phân khúc segments.adjusted_age_range và segments.adjusted_gender chỉ dành cho những tài khoản trong danh sách cho phép, phải được chọn cùng nhau và không thể kết hợp với các chỉ số metrics.unique_users_*_plus, trường metrics.unique_users*_info hoặc phân khúc mạng quảng cáo.