Śledzenie miejsca docelowego i skuteczności reklamy

Interfejs Google Ads API udostępnia kilka widoków, które umożliwiają analizowanie, gdzie wyświetlały się Twoje reklamy i jaką miały skuteczność: managed_placement_view, group_placement_view, detail_placement_view i  performance_max_placement_view. Każdy widok zapewnia inne spojrzenie na dane dotyczące miejsc docelowych. Gotowe do użycia zapytania w języku Google Ads Query Language (GAQL) i curl, które odtwarzają ekrany miejsc docelowych w interfejsie Google Ads, znajdziesz w zbiorze zapytań.

Widok wybranych miejsc docelowych

  • Co pokazuje: zasób managed_placement_view dostarcza dane o skuteczności zagregowane według kryteriów pozytywnych miejsc docelowych, na które kierujesz reklamy w grupach reklam. Ten widok obejmuje wszystkie 5 typów kryteriów zarządzanych w interfejsie Google Ads w sekcji Treść > Miejsca docelowe: witryny, kanały w YouTube, filmy na YouTube, aplikacje mobilne i kategorie aplikacji mobilnych.
  • Odpowiednik w interfejsie: Treść > Miejsca docelowe
  • Kreator zapytań: Przeglądaj w kreatorze zapytań

Typy kryteriów wybranych miejsc docelowych

Każdy wiersz w zasobie managed_placement_view wypełnia pole AdGroupCriterion, które odpowiada wartości ad_group_criterion.type, i pozostawia inne pola miejsca docelowego nieustawione:

Typ miejsca docelowego w interfejsie Wartość ad_group_criterion.type Pola szczegółów kryterium Uwagi
Strony internetowe PLACEMENT ad_group_criterion.placement.url Adres URL docelowej witryny lub domeny.
Kanały w YouTube YOUTUBE_CHANNEL ad_group_criterion.youtube_channel.channel_id Identyfikator kanału na YouTube. Pole ad_group_criterion.display_name zwraca nazwę kanału.
Filmy w YouTube (tylko w języku angielskim) YOUTUBE_VIDEO ad_group_criterion.youtube_video.video_id Identyfikator filmu na YouTube. Pole ad_group_criterion.display_name zwraca tytuł filmu.
Aplikacje MOBILE_APPLICATION ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name Identyfikator aplikacji w formacie {platform}-{platform_native_id} (1- w przypadku iOS, 2- w przypadku Androida) i nazwa aplikacji.
Kategorie aplikacji MOBILE_APP_CATEGORY ad_group_criterion.mobile_app_category.mobile_app_category_constant Nazwa zasobu w formacie mobileAppCategoryConstants/{mobile_app_category_id}. Zobacz Nazwy i hierarchia kategorii aplikacji mobilnych.

Przykładowe zapytanie

Aby pobrać wskaźniki skuteczności wszystkich typów wybranych miejsc docelowych z ostatnich 30 dni, wybierz pole ad_group_criterion.type obok pól dotyczących konkretnych typów:

SELECT
  campaign.id,
  ad_group.id,
  managed_placement_view.resource_name,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.display_name,
  ad_group_criterion.placement.url,
  ad_group_criterion.youtube_channel.channel_id,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.mobile_application.app_id,
  ad_group_criterion.mobile_application.name,
  ad_group_criterion.mobile_app_category.mobile_app_category_constant,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS

Nazwy i hierarchia kategorii aplikacji mobilnych

W interfejsie Google Ads kategorie aplikacji mobilnych, na które kierujesz reklamy, wyświetlają pełną ścieżkę sklepu z aplikacjami, np. Kategorie aplikacji > Apple App Store > Edukacja. Podczas wysyłania zapytań do interfejsu Google Ads API pamiętaj o tych kwestiach:

  • Stałe kategorii aplikacji mobilnych, do których przypisano atrybuty: zasób mobile_app_category_constant nie jest zasobem przypisanym do zasobu managed_placement_view. Zamiast tego wybierz pole ad_group_criterion.mobile_app_category.mobile_app_category_constant (np. mobileAppCategoryConstants/60503) lub wyślij zapytanie do zasobu ad_group_criterion, gdy nie potrzebujesz danych.
  • Wyświetlane nazwy tylko kategorii podrzędnych: pola ad_group_criterion.display_name i mobile_app_category_constant.name zwracają tylko nazwę kategorii podrzędnej, np. "Education" lub "Games". Żadne z tych pól nie zawiera ścieżki nadrzędnego sklepu z aplikacjami.
  • Rozpoznawanie ścieżki sklepu z aplikacjami: Google Play i Apple App Store udostępniają nazwy kategorii liści w ramach różnych identyfikatorów kryteriów. Na przykład identyfikatory kryteriów 60005 (/All Apps/Google Play/Education), 60060 (/All Apps/Google Play/Family/Education) i 60503 (/All Apps/Apple App Store/Education) zwracają wartość "Education" w polach name i display_name. Wyodrębnij sufiks {mobile_app_category_id} z nazwy zasobu i wyszukaj jego pełną ścieżkę hierarchii w tabeli lub pliku CSV Kategorie aplikacji mobilnych.

Widok miejsca docelowego grupy

  • Co pokazuje: zasób group_placement_view pokazuje, gdzie Twoje reklamy faktycznie się wyświetlały w sieci reklamowej i w YouTube, niezależnie od tego, czy miejsca docelowe były bezpośrednio objęte kierowaniem, czy też zostały automatycznie wykryte przez system Google. Mogą to być witryny, kanały lub filmy w YouTube oraz aplikacje.
  • UI Equivalent: Content > Where ads showed
  • Kreator zapytań: Przeglądaj w kreatorze zapytań

Przykładowe zapytanie

To zapytanie pobiera wskaźniki skuteczności dotyczące domen, aplikacji mobilnych i kanałów w YouTube, w których wyświetlały się reklamy w ciągu ostatnich 30 dni:

SELECT
  campaign.id,
  ad_group.id,
  group_placement_view.display_name,
  group_placement_view.target_url,
  group_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS

Wiersz „Łącznie: inne”

Aby przyspieszyć generowanie raportów, zasoby group_placement_view i detail_placement_view wykluczają poszczególne miejsca docelowe, które nie osiągają minimalnego progu aktywności pod względem wyświetleń lub interakcji.

  • W interfejsie Google Ads: interfejs agreguje miejsca docelowe, które nie osiągają tego progu aktywności, w wierszu podsumowania o nazwie Łącznie: inne.
  • W interfejsie Google Ads API: interfejs API pomija w wynikach raportu miejsca docelowe, które nie osiągają progu aktywności, i nie zwraca wiersza podsumowania, w którym pole group_placement_view.placement lub detail_placement_view.placement ma wartość "Other".

W efekcie suma poszczególnych wierszy miejsc docelowych w zasobach group_placement_view i detail_placement_view może być niższa niż łączne dane dla grupy reklam lub kampanii. Więcej informacji znajdziesz w artykule Raport „Gdzie wyświetlają się reklamy”. Szczegółowe informacje o tym, jak progi i brakujące metadane wpływają na porównania między widokami, znajdziesz w sekcjach Różnice w danych między widokami miejsc docelowych i Wiersze z niedostępnymi informacjami o miejscach docelowych.

Ustawienia kierowania na miejsca docelowe

Na działanie i użyteczność group_placement_view wpływa TargetingSetting dla wymiaru PLACEMENT na poziomie grupy reklam. To ustawienie zawiera listę obiektów target_restrictions, z których każdy ma pole logiczne bid_only określające, czy reklamy mają się wyświetlać tylko w wybranych miejscach docelowych, czy też w innych miejscach docelowych. Więcej informacji znajdziesz w artykule Ustawienia „Kierowanie” i „Obserwacja”.

  • bid_only = false: ta wartość odpowiada opcji Kierowanie w interfejsie Google Ads w przypadku miejsc docelowych. Jeśli w grupie reklam masz wybrane ustawienie „Kierowanie”, reklamy będą się wyświetlać tylko w miejscach docelowych, które zostały wyraźnie dodane jako kryteria. Możesz zastosować do tych miejsc docelowych dostosowania stawek. W tym scenariuszu group_placement_view w dużej mierze odzwierciedla managed_placement_view, ale nadal podlega minimalnym progom aktywności.
  • bid_only = true: ta wartość odpowiada opcji Obserwacja w interfejsie Google Ads w przypadku miejsc docelowych. Jeśli grupa reklam ma ustawienie „Obserwacja”, Twoje reklamy mogą się wyświetlać w dowolnym odpowiednim miejscu docelowym w sieci reklamowej i w YouTube. Możesz też zastosować dostosowania stawek do dowolnych miejsc docelowych, na które kierujesz reklamy. W takim przypadku group_placement_view ma kluczowe znaczenie dla odkrywania nowych miejsc docelowych, w których wyświetlają się Twoje reklamy. Możesz je potem dodać jako wybrane miejsca docelowe lub wykluczenia.

Widok szczegółów miejsca docelowego

  • Co pokazuje: zasób detail_placement_view zawiera bardziej szczegółowe zestawienie miejsc docelowych, które wykracza poza poziom domeny lub kanału. Może on na przykład wyświetlać konkretne adresy URL lub identyfikatory filmów na YouTube, w których pojawiły się Twoje reklamy.
  • Odpowiednik w interfejsie: odpowiada wybraniu wierszy w sekcji Treść > Gdzie wyświetlają się reklamy, a następnie kliknięciu Wyświetl szczegóły.
  • Kreator zapytań: Przeglądaj w kreatorze zapytań
  • Ważne kwestie: podobnie jak zasób group_placement_view, ten widok pomija miejsca docelowe o niskiej aktywności, które nie osiągają minimalnych progów aktywności (patrz sekcja Wiersz „Łącznie: inne”).

Przykładowe zapytanie

Aby ograniczyć liczbę wyników, to zapytanie pobiera dane o miejscach docelowych na poziomie adresu URL i filmu w okresie 7 dni. W przypadku dużych kont możesz dodatkowo filtrować według pola campaign.id lub ad_group.id:

SELECT
  campaign.id,
  ad_group.id,
  detail_placement_view.display_name,
  detail_placement_view.target_url,
  detail_placement_view.group_placement_target_url,
  detail_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS

Aby wykluczyć wiersze, w których metadane miejsca docelowego są niedostępne, dodaj AND detail_placement_view.target_url IS NOT NULL (patrz Wiersze z niedostępnymi informacjami o miejscu docelowym). Jeśli nie potrzebujesz zwracanych pól resource_name, dołącz klauzulę PARAMETERS omit_unselected_resource_names = true.

Różnice w danych między widokami miejsc docelowych

Minimalny próg aktywności jest oceniany niezależnie na każdym poziomie szczegółowości:

  • Zasób group_placement_view ocenia próg w zagregowanej domenie, aplikacji mobilnej lub kanale YouTube.
  • Zasób detail_placement_view ocenia próg osobno dla każdego adresu URL strony lub filmu na YouTube.

Zasób detail_placement_view pomija adresy URL poszczególnych stron lub filmy na YouTube, które nie spełniają wymagań. W efekcie suma wierszy detail_placement_view dla domeny lub kanału w YouTube (przefiltrowanych według pola detail_placement_view.group_placement_target_url) może zawierać mniej wyświetleń niż odpowiadający im wiersz group_placement_view.

Wiersze z niedostępnymi informacjami o miejscu

Zapytanie dotyczące zasobu group_placement_view lub detail_placement_view może zwrócić wiele wierszy w tej samej grupie reklam z nieustawionymi polami placement, display_name i target_url oraz identyczną wartością resource_name (np. kończącą się na ~MTRf).

Dzieje się tak z tych powodów:

  • Grupowanie według wewnętrznych miejsc docelowych: oba widoki grupują dane o skuteczności według unikalnego identyfikatora wewnętrznego miejsca docelowego, a nie według pól tekstowych resource_name lub placement.
  • Niedostępne metadane miejsc docelowych: w interfejsie Google Ads miejsca docelowe bez metadanych w tabelach przeglądowych backendu są wyświetlane jako Nieznane, Kanał jest już niedostępny lub Film jest już niedostępny. W interfejsie API każdy odrębny identyfikator miejsca docelowego nadal zwraca wiersz danych z nieustawionymi polami placement, display_name i target_url.
  • Syntetyczne nazwy zasobów: sufiks {base64_placement} w polu resource_name jest zakodowany w formacie Base64 z {type_id}_{placement}, gdzie {type_id} jest wewnętrznym identyfikatorem typu miejsca docelowego, a nie numerem typu wyliczeniowego PlacementType. Gdy pole placement_type ma wartość WEBSITE (identyfikator wewnętrzny 14), a pole placement nie jest ustawione, ciąg "14_" jest kodowany jako MTRf (podobnie MOBILE_APPLICATION koduje "55_" jako NTVf, YOUTUBE_VIDEO koduje "89_" jako ODlf, a YOUTUBE_CHANNEL koduje "90_" jako OTBf). Wiele miejsc docelowych tego samego typu z niedostępnymi metadanymi w tej samej grupie reklam ma więc tę samą wartość resource_name, ale raportuje osobne wiersze danych.

Podczas przetwarzania wyników group_placement_view lub detail_placement_view w kodzie klienta nie usuwaj duplikatów wierszy wyłącznie na podstawie pola resource_name, ponieważ może to spowodować zastąpienie danych w różnych miejscach docelowych niedostępnymi metadanymi. Aby wykluczyć wiersze z niedostępnymi metadanymi w GAQL, filtruj według pola target_url lub display_name, ponieważ pól placement i resource_name nie można filtrować. Na przykład użyj WHERE group_placement_view.target_url IS NOT NULL lub WHERE detail_placement_view.target_url IS NOT NULL.

Widok miejsc docelowych w kampanii Performance Max

  • Co pokazuje: zasób performance_max_placement_view dostarcza dane o wyświetleniach (metrics.impressions) w miejscach docelowych, w których wyświetlały się reklamy z kampanii Performance Max. W wersji 24 i nowszych możesz segmentować performance_max_placement_view według segments.ad_network_type (nieobsługiwane w wersji 23).
  • Odpowiednik w interfejsie: Statystyki i raporty > Edytor raportów > Miejsce docelowe kampanii Performance Max
  • Kreator zapytań: Przeglądaj w kreatorze zapytań

Przykładowe zapytanie

To zapytanie pobiera wyświetlenia miejsc docelowych z kampanii Performance Max z ostatnich 30 dni podzielone na segmenty według typu sieci reklamowej:

SELECT
  campaign.id,
  performance_max_placement_view.display_name,
  performance_max_placement_view.target_url,
  performance_max_placement_view.placement_type,
  segments.ad_network_type,
  metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS

Wybieranie widoku miejsc docelowych

  • Używaj managed_placement_view, aby oceniać skuteczność miejsc docelowych, na które aktywnie kierujesz reklamy i ustalasz stawki.
  • Używaj group_placement_view, aby poznać pełny zakres miejsc, w których wyświetlają się Twoje reklamy, zwłaszcza gdy korzystasz z ustawienia „Obserwacja”, aby odkrywać nowe możliwości kierowania lub wykluczenia.
  • Użyj detail_placement_view, aby uzyskać najbardziej szczegółowe informacje o konkretnych adresach URL lub filmach, w których wyświetlały się Twoje reklamy. Często używa się tego po zidentyfikowaniu domeny lub kanału w group_placement_view.
  • Użyj performance_max_placement_view, aby sprawdzić wyświetlenia w miejscach docelowych w kampaniach Performance Max.