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.
Widok wybranych miejsc docelowych
- Co pokazuje: zasób
managed_placement_viewdostarcza dane o skuteczności zagregowane według miejsc docelowych, na które wyraźnie kierujesz reklamy (wybrane miejsca docelowe). Odzwierciedla skuteczność kryteriówPlacement. - Odpowiednik w interfejsie: Treść > Miejsca docelowe
- Kreator zapytań: Przeglądaj w kreatorze zapytań
Przykładowe zapytanie
Aby pobrać wskaźniki skuteczności wybranych miejsc docelowych z ostatnich 30 dni:
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.placement.url,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
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ń
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.
Opcje TargetingSetting
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”).
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 języku zapytań Google Ads, odfiltruj pole target_url lub display_name (np. WHERE
detail_placement_view.target_url IS NOT NULL), ponieważ pól placement i resource_name nie można filtrować.
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). - Kreator zapytań: Przeglądaj w kreatorze zapytań
Którego widoku użyć?
- 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.