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 odpowiada jego poziomowi kierowania (np. keyword_view łączy się z ad_group_criterion, a location_view łączy się 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 o 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 (rodzaje danych) dotyczące określonego typu kryteriów, podaj odpowiedni zasób widoku w klauzuli FROM. Aby pobrać dane słów kluczowych, użyj na przykład keyword_view w klauzuli FROM i pól metrics w klauzuli SELECT.

W widoku kryteriów możesz wybrać pola z zasobów nadrzędnych aż do customer. Gdy na przykład wybierzesz FROM keyword_view, możesz wysłać żądanie dotyczące pól ze wszystkich tych zasobów:

• ad_group_criterion
• ad_group
• campaign
• customer

Aby dowiedzieć się, o jakie zasoby można poprosić w ten sposób w przypadku danego zasobu, sprawdź wiersz Przypisane zasoby na stronie referencyjnej. Na przykład zasoby dotyczące keyword_view znajdziesz na stronie referencyjnej.

Mapowanie na interfejs użytkownika

Każdy raport kryteriów odpowiada konkretnemu widokowi w interfejsie Google Ads. Mapowanie tych danych może pomóc w uzgadnianiu danych z interfejsu API z danymi widocznymi 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_view i gender_view.
• Kampanie > Lokalizacje: zwraca dane odpowiadające location_view.