در API گوگل ادز، هر گزارش معیار توسط یک منبع جداگانه نمایش داده میشود. مگر اینکه خلاف آن لازم باشد، *_view
resources فقط شامل یک فیلد resource_name
است.
در صورت نیاز به دریافت دادههای خاص، کلاینتهای API گوگل ادز باید فیلدهای ad_group_criterion
یا campaign_criterion
مربوطه را مشخص کنند. این به کلاینتهای API گوگل ادز اجازه میدهد تا فیلدهای 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
برای کشف منابعی که میتوان از این طریق برای یک منبع مشخص درخواست کرد، ردیف منابع ویژگی (Attribute Resources) را در صفحه مرجع آن بررسی کنید. به عنوان مثال، برای keyword_view
، میتوانید منابع آن را در صفحه مرجع آن پیدا کنید.