در Google Ads API، هر گزارش معیار توسط یک منبع جداگانه نشان داده می شود. مگر اینکه در غیر این صورت لازم باشد، منابع *_view
فقط حاوی یک قسمت resource_name
است.
در صورت نیاز به واکشی دادههای خاص معیاری، مشتریان API Google Ads باید فیلدهای ad_group_criterion
یا campaign_criterion
مربوطه را مشخص کنند. این به مشتریان API Google Ads اجازه میدهد تا فیلدهای ad_group_criterion
یا campaign_criterion
و منبع *_view
را در همان درخواست به روش GoogleAdsService.SearchStream
درخواست کنند.
نمونه درخواست پرس و جو
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
برای بازیابی داده های عملکرد (متریک ها) برای یک نوع معیار خاص، منبع مشاهده متناظر آن را در عبارت FROM
مشخص کنید. به عنوان مثال، از keyword_view
در بند FROM
و برخی از فیلدهای metrics
در بند SELECT
برای بازیابی معیارهای کلمه کلیدی استفاده کنید.
میتوانید فیلدها را از منابع اصلی تا customer
از نمای معیار انتخاب کنید. برای مثال، هنگام انتخاب FROM
keyword_view
، میتوانید فیلدهایی را از همه منابع زیر درخواست کنید:
-
ad_group_criterion
-
ad_group
-
campaign
-
customer
شما می توانید منابعی را که می توان از این طریق برای یک منبع خاص درخواست کرد، با بررسی ردیف منابع ویژگی صفحه مرجع آن کشف کرد. برای مثال، برای keyword_view
، میتوانید منابع آن را در صفحه مرجع آن پیدا کنید.