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:
VideoResponsiveAdInfomutabilitas: Mulai v24, objekVideoResponsiveAdInfodapat diubah (dalam versi sebelumnya, objek tersebut tidak dapat diubah). Saat membuat atau mengubahVideoResponsiveAdInfo, kolomvideos,business_name, danlogo_imageswajib diisi.- Kesesuaian keamanan merek: Mulai v24,
campaign.video_brand_safety_suitabilitytingkat kampanye dihapus. Buat kueri kesesuaian keamanan merek di tingkat akun menggunakancustomer.video_brand_safety_suitability. - Eksperimen kampanye Video: Mulai v24,
experiment.video_experimenttersedia untuk mengonfigurasi eksperimenYOUTUBE_CUSTOMyang 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_plushinggametrics.unique_users_ten_plus: Jumlah orang unik yang melihat iklan Anda masing-masing setidaknya 2 hingga 10 kali, untuk rentang tanggal hingga 31 hari (denganmetrics.unique_users_six_plushinggametrics.unique_users_nine_plusmelengkapi 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 resourcecampaign, tidak dapat digabungkan di seluruh baris, dan tidak memiliki kolom_infopendamping.
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 dengansegments.ad_sub_format_type) atau berdasarkan jaringan iklan (segments.ad_network_type, secara opsional dengansegments.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_typeatausegments.ad_network_type) saat memilih sub-segmennya. Segmensegments.ad_sub_format_typemengelompokkan iklan dalam stream yang tidak dapat dilewati berdasarkan durasi dan menampilkanUNSEGMENTEDuntuk format iklan lainnya, sedangkan segmensegments.ad_sub_network_typemengelompokkan platform YouTube (YOUTUBE_INSTREAM,YOUTUBE_INFEED, danYOUTUBE_SHORTS) hanya untuk kampanye Peningkat Permintaan dan menampilkanUNSEGMENTEDuntuk kampanye Video. - Segmen demografis yang disesuaikan: Segmen
segments.adjusted_age_rangedansegments.adjusted_genderhanya tersedia untuk akun yang diizinkan, harus dipilih bersama, dan tidak dapat digabungkan dengan metrikmetrics.unique_users_*_plus, kolommetrics.unique_users*_info, atau segmen jaringan iklan.