Kampanye Video

Kampanye Video memungkinkan Anda menampilkan iklan video di YouTube serta di seluruh situs dan aplikasi yang berjalan di partner video Google.

Batasan API

Google Ads API terutama mendukung pengambilan dan pelaporan kampanye, grup iklan, iklan, dan kriteria Video yang ada. Kampanye Video tidak dapat dibuat atau diubah menggunakan Google Ads API, dengan pengecualian dan perilaku khusus versi berikut:

• VideoResponsiveAdInfo mutabilitas: Mulai v24, objek VideoResponsiveAdInfo dapat diubah (dalam versi sebelumnya, objek tidak dapat diubah). Saat membuat atau mengubah VideoResponsiveAdInfo, kolom videos, business_name, dan logo_images wajib diisi.
• Kesesuaian keamanan merek: Mulai v24, campaign.video_brand_safety_suitability tingkat kampanye akan dihapus. Buat kueri kesesuaian keamanan merek di tingkat akun menggunakan customer.video_brand_safety_suitability.
• Eksperimen kampanye Video: Mulai v24, experiment.video_experiment tersedia untuk mengonfigurasi eksperimen YOUTUBE_CUSTOM yang terdiri dari kampanye Video.

Alternatif untuk pengelolaan kampanye

Jika Anda perlu membuat atau mengelola kampanye Video secara terprogram, pertimbangkan opsi berikut:

• Skrip Google Ads: Anda dapat mengelola kampanye Video menggunakan skrip Google Ads. Hal ini memungkinkan pengelolaan otomatis dalam antarmuka Google Ads.
• Kampanye Peningkat Permintaan: Jika sasaran Anda adalah menayangkan iklan video di seluruh properti Google, termasuk YouTube, kampanye Peningkat Permintaan didukung sepenuhnya di Google Ads API untuk pembuatan dan pengelolaan.

Mendapatkan data performa

Anda dapat mengambil data performa untuk kampanye Video, grup iklan, dan kriteria menggunakan GoogleAdsService.SearchStream dengan memfilter campaign.advertising_channel_type = 'VIDEO'.

Catatan: Gunakan metrics.video_trueview_views, metrics.video_trueview_view_rate, dan metrics.trueview_average_cpv untuk metrik penayangan TrueView. Mulai v25, Anda juga dapat memilih segments.ad_sub_format_type (bersama segments.ad_format_type) untuk mengelompokkan iklan dalam stream yang tidak dapat dilewati berdasarkan durasi, serta metrik engagement sosial video (metrics.youtube_comments, metrics.youtube_likes, dan metrics.youtube_shares).

Performa grup iklan

Kueri berikut mengambil metrik kampanye Video dan grup iklan, termasuk penayangan video TrueView dan rasio penyelesaian kuartil, dari resource 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'

Pelaporan kriteria dan penempatan video

Karena ad_group_criterion tidak mendukung metrik atau segmen secara langsung, gunakan resource tampilan kriteria seperti managed_placement_view untuk mengambil metrik performa video YouTube, channel YouTube, atau penempatan terkelola lainnya yang ditargetkan:

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

Pelaporan jangkauan dan frekuensi kampanye

Untuk kampanye Video, Anda dapat mengkueri metrik Jangkauan Unik di resource campaign untuk mengukur jumlah individu unik yang melihat iklan Anda pada frekuensi tayangan iklan tertentu.

Metrik pengguna unik berikut mengukur jangkauan audiens di seluruh bucket frekuensi:

• metrics.unique_users: Jumlah orang unik yang melihat iklan Anda setidaknya sekali dalam rentang tanggal yang dipilih (hingga 92 hari). Metrik ini tidak dapat digabungkan di seluruh baris.
• metrics.unique_users_two_plus hingga metrics.unique_users_ten_plus: Jumlah orang unik yang melihat iklan Anda masing-masing setidaknya 2 hingga 10 kali, untuk rentang tanggal hingga 31 hari (dengan metrics.unique_users_six_plus hingga metrics.unique_users_nine_plus melengkapi set 2+ hingga 10+ di v26 dan yang lebih baru).
• metrics.average_impression_frequency_per_user: Frekuensi rata-rata pengguna unik melihat iklan Anda selama periode yang diminta (hingga 92 hari). Kolom ini tidak dapat digabungkan di seluruh baris dan tidak memiliki kolom _info pendamping.

Di v26 dan yang lebih baru, setiap metrik jangkauan memiliki kolom metadata pendamping dari jenis ReachMetricInfo: metrics.unique_users_info dan metrics.unique_users_two_plus_info hingga metrics.unique_users_ten_plus_info.

Di Bahasa Kueri Google Ads (GAQL), kolom jangkauan pengiring adalah metrik MESSAGE yang dipilih langsung dalam klausa SELECT (misalnya, metrics.unique_users_info). Jangan tambahkan .reach_metric_states dalam klausa SELECT, karena memilih kolom pesan bertingkat di GAQL akan gagal dengan UNRECOGNIZED_FIELD. Sebagai gantinya, memilih metrics.unique_users_info akan menampilkan pesan ReachMetricInfo yang berisi kolom enum berulang reach_metric_states dari jenis ReachMetricState, yang menjelaskan apakah metrik disembunyikan atau sudah lengkap.

Setiap kali metrik jangkauan disembunyikan atau berada di luar periode retensi (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION, atau DATE_RANGE_BEYOND_RETENTION), kolom optional int64-nya di Metrics tidak ditetapkan (yang dievaluasi ke 0 jika keberadaan kolom tidak diperiksa), sedangkan LOW_QUALITY masih mengisi metrik numerik.

Nilai enum ReachMetricState menunjukkan status data jangkauan:

• COMPLETE: Metrik jangkauan sudah lengkap tanpa penyembunyian karena batasan privasi, kualitas, atau batasan lainnya.
• PRIVACY_SUPPRESSION: Data jangkauan disembunyikan untuk melindungi privasi pengguna (misalnya, saat volume audiens tidak memenuhi nilai minimum k-anonimitas).
• QUALITY_SUPPRESSION: Data jangkauan disembunyikan karena persyaratan kualitas data.
• LOW_QUALITY: Metrik jangkauan dihitung, tetapi ditandai sebagai berkualitas rendah.
• DATE_RANGE_BEYOND_RETENTION: Metrik jangkauan tidak tersedia karena rentang tanggal yang dipilih melebihi periode retensi data selama 3 tahun untuk data jangkauan.

Kueri berikut mengambil metrik jangkauan dan status penonaktifannya untuk kampanye 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'

Catatan: Metrik jangkauan dan frekuensi tidak dapat digabungkan di seluruh baris. Meskipun metrics.unique_users dan metrics.average_impression_frequency_per_user mendukung rentang tanggal hingga 92 hari dan dapat disegmentasikan menurut segments.date, segments.device, segments.adjusted_age_range, dan segments.adjusted_gender, metrik bucket frekuensi unique_users_*_plus (hingga 31 hari) dan semua kolom metrics.unique_users*_info pengiring hanya mendukung segments.date dan segments.device. Selain itu, kolom metrics.unique_users*_info pengiring adalah metrik MESSAGE dengan filterable: false dan sortable: false, sehingga tidak dapat digunakan dalam klausa WHERE atau ORDER BY. Lihat Penghapusan metrik jangkauan dan nilai nol untuk mengetahui detail selengkapnya tentang cara menangani metrik jangkauan yang dihapus dalam laporan.