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 określonych kryteriów. Dzięki temu klienci interfejsu Google Ads API mogą w tym samym żądaniu wysyłanym do metody GoogleAdsService.SearchStream żądać pól ad_group_criterion lub campaign_criterion oraz zasobu *_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. Na przykład użyj keyword_view w klauzuli FROM i niektórych pól metrics w klauzuli SELECT, aby pobrać dane słów kluczowych.

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

  • 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 atrybutów na stronie referencyjnej. Na przykład w przypadku keyword_view zasoby znajdziesz na 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 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 miejsc, w których zwykle znajdują się 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 wartościom age_range_viewgender_view.
  • Kampanie > Lokalizacje: zwraca dane równoważne location_view.