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 wersji i zachowań:

• Zmienność VideoResponsiveAdInfo: od wersji 24 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: od wersji 24 usunięto campaign.video_brand_safety_suitability na poziomie kampanii. Sprawdzanie bezpieczeństwa i przydatności marki na poziomie konta za pomocą customer.video_brand_safety_suitability.
• Eksperymenty z kampaniami wideo: od wersji 24 do konfigurowania eksperymentów YOUTUBE_CUSTOM obejmujących kampanie wideo można używać experiment.video_experiment.

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, m.in. na 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'.

Skuteczność grupy reklam

To zapytanie pobiera z zasobu ad_group dane kampanii wideo i grup reklam, m.in. wyświetlenia 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 reklam 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 na 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

W przypadku kampanii wideo możesz wysyłać zapytania o wskaźniki zasięgu Unique Reach do zasobów campaign i customer (od wersji 26), aby mierzyć liczbę unikalnych użytkowników, którym wyświetlono Twoje reklamy z określoną częstotliwością wyświetleń.

Poniższe dane dotyczące unikalnych użytkowników 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). Te dane są dostępne tylko w zasobie campaign, nie można ich agregować w wierszach i nie mają powiązanego pola _info.

W wersji 26 i nowszych każdy wskaźnik zasięgu wśród unikalnych użytkowników ma powiązane pole metadanych typu ReachMetricInfo: metrics.unique_users_info oraz od metrics.unique_users_two_plus_info do metrics.unique_users_ten_plus_info.

W języku Google Ads Query Language (GAQL) pola towarzyszące metrics.unique_users*_info to MESSAGE dane z filterable: false i sortable: false, więc nie można ich używać w klauzulach WHERE ani ORDER BY. Wybierz te pola bezpośrednio w klauzuli SELECT (np. metrics.unique_users_info). Nie dodawaj .reach_metric_states w klauzuli SELECT, ponieważ wybór zagnieżdżonych pól wiadomości w GAQL kończy się błędem UNRECOGNIZED_FIELD. Zamiast tego wybranie metrics.unique_users_info zwraca wiadomość ReachMetricInfo zawierającą powtarzające się pole typu wyliczeniowego reach_metric_states typu ReachMetricState, które opisuje, czy wskaźnik został pominięty czy jest kompletny.

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 30-dniowe wskaźniki zasięgu po deduplikacji i ich stany pominięcia w przypadku kampanii wideo, podzielone według urządzenia i formatu reklamy. Pomiń segment segments.date w klauzuli SELECT, aby dane o zasięgu i częstotliwości były deduplikowane w całym zakresie dat, a nie w poszczególnych dniach:N+

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

Obsługiwane zasoby, przedziały dat i segmenty

Zapytania dotyczące zasięgu i częstotliwości wymagają skończonego filtra segments.date w ramach maksymalnego okna daty danych. Zapytania bez filtra daty lub przekraczające okno zwracają nieustawione pola zasięgu:

Podczas segmentowania zapytań o zasięg stosuj te ograniczenia dotyczące segmentów łączonych:

• Segmenty formatu reklamy a segmenty sieci reklamowej: możesz segmentować według formatu reklamy (segments.ad_format_type, opcjonalnie z segments.ad_sub_format_type) lub sieci reklamowej (segments.ad_network_type, opcjonalnie z segments.ad_sub_network_type), ale nie możesz łączyć segmentów formatu reklamy i sieci reklamowej w tym samym zapytaniu. Podczas wybierania podsegmentu zawsze wybieraj segment nadrzędny (segments.ad_format_type lub segments.ad_network_type). Segment segments.ad_sub_format_type dzieli reklamy In-Stream niemożliwe do pominięcia według czasu trwania i zwraca wartość UNSEGMENTED w przypadku innych formatów reklam, a segment segments.ad_sub_network_type dzieli platformy YouTube (YOUTUBE_INSTREAM, YOUTUBE_INFEED i YOUTUBE_SHORTS) tylko w przypadku kampanii generujących popyt i zwraca wartość UNSEGMENTED w przypadku kampanii wideo.
• Dostosowane segmenty demograficzne: segmenty segments.adjusted_age_range i segments.adjusted_gender są dostępne tylko na kontach z listy dozwolonych, muszą być wybrane razem i nie można ich łączyć z danymi metrics.unique_users_*_plus, polami metrics.unique_users*_info ani segmentami sieci reklamowej.