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:
VideoResponsiveAdInfokhả năng biến đổi: Kể từ phiên bản 24, cácVideoResponsiveAdInfođố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 đổiVideoResponsiveAdInfo, các trườngvideos,business_namevàlogo_imageslà 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_suitabilitycấ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ụngcustomer.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ệmYOUTUBE_CUSTOMbao 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đếnmetrics.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ớimetrics.unique_users_six_plusđếnmetrics.unique_users_nine_plushoà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êncampaign, 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 theosegments.ad_sub_format_type) hoặc theo mạng quảng cáo (segments.ad_network_type, có thể kèm theosegments.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_typehoặcsegments.ad_network_type) khi chọn phân khúc con của phân khúc đó. Segmentsegments.ad_sub_format_typephâ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ềUNSEGMENTEDcho các định dạng quảng cáo khác, trong khi segmentsegments.ad_sub_network_typephân tích các nền tảng của YouTube (YOUTUBE_INSTREAM,YOUTUBE_INFEEDvàYOUTUBE_SHORTS) chỉ cho chiến dịch Tạo nhu cầu và trả vềUNSEGMENTEDcho 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_rangevàsegments.adjusted_genderchỉ 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ườngmetrics.unique_users*_infohoặc phân khúc mạng quảng cáo.