W interfejsie Google Ads API każdy raport o kryteriach jest reprezentowany przez osobny zasób.
Jeśli nie jest to konieczne, zasoby *_view zawierają tylko pole resource_name.
Jeśli trzeba pobrać dane dotyczące konkretnych kryteriów, klienci interfejsu Google Ads API muszą określić odpowiednie pola ad_group_criterion lub campaign_criterion.
Dzięki temu klienci interfejsu Google Ads API mogą w tym samym żądaniu do
GoogleAdsService.SearchStream
metody poprosić o pola ad_group_criterion lub campaign_criterion
oraz zasób *_view.
Przykładowe żądanie zapytania
SELECT
ad_group_criterion.keyword.text,
ad_group.name,
campaign.name,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS
Aby pobrać dane o skuteczności (dane) dotyczące konkretnego typu kryteriów, w klauzuli FROM określ odpowiedni zasób widoku. Aby na przykład pobrać dane słów kluczowych, użyj keyword_view w klauzuli FROM i niektórych pól metrics w klauzuli SELECT.
W widoku kryteriów możesz wybrać pola z zasobów nadrzędnych aż do zasobu customer. Na przykład, gdy wybierzesz FROM w keyword_view, możesz poprosić o pola ze wszystkich tych zasobów:
ad_group_criterionad_groupcampaigncustomer
Aby dowiedzieć się, o jakie zasoby można poprosić w ten sposób w przypadku danego zasobu, sprawdź wiersz Zasoby atrybutów na jego stronie referencyjnej. Na
przykład w przypadku keyword_view, zasoby można znaleźć na stronie referencyjnej.
Mapowanie na interfejs
Każdy raport o kryteriach odpowiada konkretnemu widokowi w interfejsie Google Ads. Mapowanie tych widoków może pomóc w uzgodnieniu danych z interfejsu API z tym, co widzisz w interfejsie. Większą listę mapowań znajdziesz w artykule Raporty w interfejsie.
Oto kilka typowych raportów opartych na kryteriach i ich typowe lokalizacje w interfejsie:
- Kampanie > Odbiorcy, słowa kluczowe i treść > Słowa kluczowe w sieci wyszukiwania: zwraca
dane odpowiadające
keyword_view. - Kampanie > Odbiorcy, słowa kluczowe i treść > Odbiorcy > Dane demograficzne:
zwraca dane odpowiadające
age_range_viewigender_view. - Kampanie > Lokalizacje: zwraca dane odpowiadające
location_view.