Kampanye Video

Kampanye Video memungkinkan Anda menampilkan iklan video di YouTube serta di berbagai 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 tersebut 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 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'.

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

Untuk kampanye Video, Anda dapat mengkueri metrik Jangkauan Unik di resource campaign dan customer (mulai v26) 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 kumpulan 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). Metrik ini hanya tersedia di resource campaign, tidak dapat digabungkan di seluruh baris, dan tidak memiliki kolom _info pendamping.

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

Di Google Ads Query Language (GAQL), kolom metrics.unique_users*_info pengiring adalah metrik MESSAGE dengan filterable: false dan sortable: false, sehingga Anda tidak dapat menggunakannya dalam klausa WHERE atau ORDER BY. Pilih kolom ini langsung di klausa SELECT (misalnya, metrics.unique_users_info). Jangan tambahkan .reach_metric_states di 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 dicentang), sedangkan LOW_QUALITY masih mengisi metrik numerik.

Nilai enum ReachMetricState menunjukkan status data jangkauan:

  • COMPLETE: Metrik jangkauan 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 yang dideduplikasi selama 30 hari dan status penindakannya untuk kampanye Video, yang disegmentasikan menurut perangkat dan format iklan. Hilangkan segmen segments.date dari klausa SELECT agar metrik jangkauan dan N+ frekuensi dihapus duplikatnya di seluruh periode tanggal penuh, bukan per hari:

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

Resource, periode tanggal, dan segmen yang didukung

Kueri jangkauan dan frekuensi memerlukan filter segments.date terbatas dalam periode tanggal maksimum metrik. Kueri tanpa filter tanggal atau yang melebihi periode akan menampilkan kolom jangkauan yang tidak ditetapkan:

Metrik Resource Rentang tanggal maks. Segmen yang kompatibel
metrics.unique_users campaign, customer (v26 dan yang lebih baru) 92 hari segments.date, segments.device, segmen format iklan (v26 dan yang lebih baru), segmen jaringan iklan (v26 dan yang lebih baru), dan segmen demografis yang disesuaikan
metrics.average_impression_frequency_per_user campaign 92 hari segments.date, segments.device, dan segmen demografis yang disesuaikan
metrics.unique_users_two_plus hingga metrics.unique_users_ten_plus campaign, customer (v26 dan yang lebih baru) 31 hari segments.date, segments.device, segmen format iklan (v26 dan yang lebih baru), dan segmen jaringan iklan (v26 dan yang lebih baru)
metrics.unique_users*_info (v26 dan yang lebih baru) campaign, customer Cocok dengan metrik dasar segments.date, segments.device, segmen format iklan, dan segmen jaringan iklan

Saat menyegmentasikan kueri jangkauan, terapkan batasan segmen gabungan berikut:

  • Segmen format iklan versus jaringan iklan: Anda dapat mengelompokkan berdasarkan format iklan (segments.ad_format_type, secara opsional dengan segments.ad_sub_format_type) atau berdasarkan jaringan iklan (segments.ad_network_type, secara opsional dengan segments.ad_sub_network_type), tetapi Anda tidak dapat menggabungkan segmen format iklan dan jaringan iklan dalam kueri yang sama. Selalu pilih segmen induk (segments.ad_format_type atau segments.ad_network_type) saat memilih sub-segmennya. Segmen segments.ad_sub_format_type mengelompokkan iklan dalam stream yang tidak dapat dilewati berdasarkan durasi dan menampilkan UNSEGMENTED untuk format iklan lainnya, sedangkan segmen segments.ad_sub_network_type mengelompokkan platform YouTube (YOUTUBE_INSTREAM, YOUTUBE_INFEED, dan YOUTUBE_SHORTS) hanya untuk kampanye Peningkat Permintaan dan menampilkan UNSEGMENTED untuk kampanye Video.
  • Segmen demografis yang disesuaikan: Segmen segments.adjusted_age_range dan segments.adjusted_gender hanya tersedia untuk akun yang diizinkan, harus dipilih bersama, dan tidak dapat digabungkan dengan metrik metrics.unique_users_*_plus, kolom metrics.unique_users*_info, atau segmen jaringan iklan.