در 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 ، میتوانید منابع آن را در صفحه مرجع آن پیدا کنید.
نگاشت به رابط کاربری
هر گزارش معیار مربوط به یک نمای خاص در رابط کاربری گوگل ادز است. نگاشت این موارد میتواند به شما کمک کند تا دادههای API را با آنچه در رابط کاربری میبینید، تطبیق دهید. برای فهرست کاملتری از نگاشتها، به بخش گزارشها در رابط کاربری مراجعه کنید.
در زیر برخی از گزارشهای رایج مبتنی بر معیار و مکانهای معمول رابط کاربری آنها آمده است:
- کمپینها > مخاطبان، کلمات کلیدی و محتوا > جستجوی کلمات کلیدی : دادههایی معادل
keyword_viewرا برمیگرداند. - کمپینها > مخاطبان، کلمات کلیدی و محتوا > مخاطبان > دادههای جمعیتی : دادههای معادل
age_range_viewوgender_viewرا برمیگرداند. - کمپینها > مکانها : دادههایی معادل
location_viewرا برمیگرداند.