Dane kryteriów

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_criterion
  • ad_group
  • campaign
  • customer

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_view i gender_view.
  • Kampanie > Lokalizacje: zwraca dane odpowiadające location_view.