Dane kryteriów

W interfejsie Google Ads API każdy raport o kryteriach jest reprezentowany przez osobny zasób. O ile nie jest to konieczne, zasoby *_view zawierają tylko pole resource_name.

Klienci interfejsu Google Ads API muszą określić odpowiednie pola ad_group_criterion lub campaign_criterion, jeśli trzeba pobrać dane dotyczące kryteriów. Każdy widok łączy się z zasobem kryterium, który pasuje do jego poziomu kierowania (np. keyword_view łączy się z ad_group_criterion, a location_view z campaign_criterion). Dzięki temu klienci interfejsu Google Ads API mogą w tym samym żądaniu do metody GoogleAdsService.SearchStream prosić 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) dla określonego typu kryteriów, w klauzuli FROM podaj odpowiedni zasób widoku. Aby na przykład pobrać dane o słowach kluczowych, użyj klauzuli keyword_view w polach FROM i metrics w klauzuli SELECT.

W widoku kryteriów możesz wybrać pola z zasobów nadrzędnych aż do poziomu customer. Gdy na przykład wybierzesz FROM keyword_view, możesz poprosić o pola z tych zasobów:

• ad_group_criterion
• ad_group
• campaign
• customer

Aby dowiedzieć się, jakie zasoby można w ten sposób uzyskać w przypadku danego zasobu, sprawdź wiersz Zasoby z atrybutami na stronie referencyjnej. Na przykład w przypadku keyword_view zasoby znajdziesz na jego stronie referencyjnej.

Mapowanie na interfejs

Każdy raport o kryteriach odpowiada konkretnemu widokowi w interfejsie Google Ads. Mapowanie tych elementó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 równoważne keyword_view.
• Kampanie > Odbiorcy, słowa kluczowe i treść > Odbiorcy > Dane demograficzne: zwraca dane równoważne age_range_view i gender_view.
• Kampanie > Lokalizacje: zwraca dane równoważne location_view.