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_viewdostarcza 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_constantnie jest zasobem przypisanym do zasobumanaged_placement_view. Zamiast tego wybierz polead_group_criterion.mobile_app_category.mobile_app_category_constant(np.mobileAppCategoryConstants/60503) lub wyślij zapytanie do zasobuad_group_criterion, gdy nie potrzebujesz danych. - Wyświetlane nazwy tylko kategorii podrzędnych: pola
ad_group_criterion.display_nameimobile_app_category_constant.namezwracają 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) i60503(/All Apps/Apple App Store/Education) zwracają wartość"Education"w polachnameidisplay_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_viewpokazuje, 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.placementlubdetail_placement_view.placementma 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 scenariuszugroup_placement_vieww dużej mierze odzwierciedlamanaged_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 przypadkugroup_placement_viewma 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_viewzawiera 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_viewocenia próg w zagregowanej domenie, aplikacji mobilnej lub kanale YouTube. - Zasób
detail_placement_viewocenia 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_namelubplacement. - 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_nameitarget_url. - Syntetyczne nazwy zasobów: sufiks
{base64_placement}w poluresource_namejest zakodowany w formacie Base64 z{type_id}_{placement}, gdzie{type_id}jest wewnętrznym identyfikatorem typu miejsca docelowego, a nie numerem typu wyliczeniowegoPlacementType. Gdy poleplacement_typema wartośćWEBSITE(identyfikator wewnętrzny14), a poleplacementnie jest ustawione, ciąg"14_"jest kodowany jakoMTRf(podobnieMOBILE_APPLICATIONkoduje"55_"jakoNTVf,YOUTUBE_VIDEOkoduje"89_"jakoODlf, aYOUTUBE_CHANNELkoduje"90_"jakoOTBf). 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_viewdostarcza 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_viewwedługsegments.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 wgroup_placement_view. - Użyj
performance_max_placement_view, aby sprawdzić wyświetlenia w miejscach docelowych w kampaniach Performance Max.