Kampanie wideo

Kampanie wideo umożliwiają wyświetlanie reklam wideo w YouTube oraz w witrynach i aplikacjach należących do sieci partnerów wideo Google.

Ograniczenia interfejsu API

Interfejs Google Ads API obsługuje przede wszystkim pobieranie i raportowanie istniejących kampanii wideo, grup reklam, reklam i kryteriów. Kampanii wideo nie można tworzyć ani modyfikować za pomocą interfejsu Google Ads API, z wyjątkiem tych przypadków i zachowań zależnych od wersji:

• Zmienność VideoResponsiveAdInfo: od wersji v24 obiekty VideoResponsiveAdInfo są zmienne (we wcześniejszych wersjach są niezmienne). Podczas tworzenia lub modyfikowania obiektu VideoResponsiveAdInfo pola videos, business_name i logo_images są wymagane.
• Bezpieczeństwo marki i dopasowanie do marki: od v24 campaign.video_brand_safety_suitability na poziomie kampanii zostanie usunięte. Sprawdzaj bezpieczeństwo i przydatność marki na poziomie konta za pomocą customer.video_brand_safety_suitability.
• Eksperymenty z kampaniami wideo: od v24 experiment.video_experiment jest dostępny do konfigurowania eksperymentów YOUTUBE_CUSTOM obejmujących kampanie wideo.

Alternatywne sposoby zarządzania kampaniami

Jeśli chcesz tworzyć kampanie wideo lub nimi zarządzać w sposób zautomatyzowany, rozważ te opcje:

• Skrypty Google Ads: kampaniami wideo możesz zarządzać za pomocą skryptów Google Ads. Umożliwia to automatyczne zarządzanie w interfejsie Google Ads.
• Kampanie generujące popyt: jeśli Twoim celem jest wyświetlanie reklam wideo w usługach Google, w tym w YouTube, interfejs Google Ads API w pełni obsługuje tworzenie kampanii generujących popyt i zarządzanie nimi.

Uzyskiwanie danych o skuteczności

Dane o skuteczności kampanii wideo, grup reklam i kryteriów możesz pobierać za pomocą GoogleAdsService.SearchStream, filtrując według campaign.advertising_channel_type = 'VIDEO'.

Uwaga: w przypadku danych o obejrzeniach reklam TrueView używaj wymiarów metrics.video_trueview_views, metrics.video_trueview_view_rate i metrics.trueview_average_cpv. Od v25 możesz też wybrać segments.ad_sub_format_type (obok segments.ad_format_type), aby podzielić reklamy In-Stream niemożliwe do pominięcia według czasu trwania, a także wskaźniki zaangażowania społecznościowego w filmach (metrics.youtube_comments, metrics.youtube_likes i metrics.youtube_shares).

Skuteczność grupy reklam

To zapytanie pobiera z zasobu ad_group dane kampanii wideo i grup reklam, m.in. obejrzenia filmów TrueView i współczynniki pełnych obejrzeń w poszczególnych kwartylach:

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'

Raporty dotyczące miejsc docelowych i kryteriów wideo

ad_group_criterion nie obsługuje bezpośrednio danych ani segmentów, dlatego do pobierania wskaźników skuteczności kierowanych filmów na YouTube, kanałów w YouTube lub innych wybranych miejsc docelowych używaj zasobów widoku kryteriów, takich jak managed_placement_view:

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

Raporty o zasięgu i częstotliwości kampanii

W przypadku kampanii wideo możesz wysyłać zapytania o dane wskaźnika zasięgu Unique Reach w zasobie campaign, aby mierzyć liczbę unikalnych użytkowników, którym wyświetliły się Twoje reklamy z określoną częstotliwością.

Te dane o unikalnych użytkownikach mierzą zasięg wśród odbiorców w ramach przedziałów częstotliwości:

• metrics.unique_users: liczba unikalnych osób, które zobaczyły Twoją reklamę co najmniej raz w wybranym zakresie dat (do 92 dni). Nie można ich agregować w wierszach.
• metrics.unique_users_two_plus do metrics.unique_users_ten_plus: liczba unikalnych osób, które zobaczyły Twoją reklamę co najmniej 2–10 razy, w zakresach dat do 31 dni (przy czym metrics.unique_users_six_plus do metrics.unique_users_nine_plus uzupełniają zestaw 2+ do 10+ w wersji 26 i nowszych).
• metrics.average_impression_frequency_per_user: średnia liczba wyświetleń reklamy unikalnemu użytkownikowi w wybranym okresie (do 92 dni). Nie można go agregować w wierszach i nie ma on pola towarzyszącego _info.

W wersji 26 i nowszych każdy wskaźnik zasięgu ma powiązane pole metadanych typu ReachMetricInfo: metrics.unique_users_info i metrics.unique_users_two_plus_info do metrics.unique_users_ten_plus_info.

W języku Google Ads Query Language (GAQL) pola zasięgu towarzyszącego to dane MESSAGE wybrane bezpośrednio w klauzuli SELECT (np. metrics.unique_users_info). Nie dodawaj .reach_metric_states w klauzuli SELECT, ponieważ wybranie zagnieżdżonych pól wiadomości w GAQL spowoduje błąd UNRECOGNIZED_FIELD. Zamiast tego wybranie metrics.unique_users_info zwraca komunikat ReachMetricInfo zawierający powtarzające się pole typu wyliczeniowego reach_metric_states typu ReachMetricState, które opisuje, czy dane zostały pominięte czy są kompletne.

Gdy wskaźnik zasięgu jest pomijany lub znajduje się poza oknem przechowywania (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION lub DATE_RANGE_BEYOND_RETENTION), jego pole optional int64 w Metrics jest nieustawione (co daje wartość 0, jeśli nie sprawdzono obecności pola), podczas gdy LOW_QUALITY nadal wypełnia wskaźnik liczbowy.

Wartości enum ReachMetricState wskazują stan danych o zasięgu:

• COMPLETE: Wskaźnik zasięgu jest kompletny i nie został pominięty ze względu na prywatność, jakość ani inne ograniczenia.
• PRIVACY_SUPPRESSION: dane o zasięgu zostały ukryte, aby chronić prywatność użytkowników (np. gdy wielkość grupy odbiorców nie spełnia progów k-anonimowości).
• QUALITY_SUPPRESSION: dane dotyczące zasięgu zostały pominięte ze względu na wymagania dotyczące jakości danych.
• LOW_QUALITY: wskaźnik zasięgu został obliczony, ale został oznaczony jako niskiej jakości.
• DATE_RANGE_BEYOND_RETENTION: Wskaźniki zasięgu są niedostępne, ponieważ wybrany zakres dat wykracza poza 3-letni okres przechowywania danych dotyczących zasięgu.

To zapytanie pobiera wskaźniki zasięgu i ich stany pominięcia w przypadku kampanii wideo:

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'

Uwaga: danych o zasięgu i częstotliwości nie można agregować w wierszach. Chociaż metrics.unique_users i metrics.average_impression_frequency_per_user obsługują zakresy dat do 92 dni i mogą być segmentowane według wymiarów segments.date, segments.device, segments.adjusted_age_range i segments.adjusted_gender, dane z grup częstotliwości unique_users_*_plus (do 31 dni) i wszystkie pola towarzyszące metrics.unique_users*_info obsługują tylko wymiary segments.date i segments.device. Dodatkowo pola towarzyszące metrics.unique_users*_info to dane MESSAGE z filterable: false i sortable: false, więc nie można ich używać w klauzulach WHERE ani ORDER BY. Więcej informacji o postępowaniu z pominiętymi wskaźnikami zasięgu w raportach znajdziesz w artykule Pomijanie wskaźników zasięgu i wartości zerowe.