سنجه‌های معیار

در Google Ads API، هر گزارش معیار با منبع جداگانه‌ای نشان داده می‌شود. مگر در موارد ضروری، منابع *_view فقط حاوی فیلد resource_name هستند.

اگر لازم باشد داده‌های خاص معیار واکشی شود، کارخواه‌های Google Ads API باید فیلدهای ad_group_criterion یا campaign_criterion مربوطه را مشخص کنند. هر نما به منبع معیاری می‌پیوندد که با سطح هدف‌یابی آن مطابقت دارد (برای مثال، keyword_view به ad_group_criterion می‌پیوندد، درحالی‌که location_view به campaign_criterion می‌پیوندد). این امر به کارخواهان Google Ads 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

برای کشف منابعی که می‌توانند به این روش برای یک منبع خاص درخواست شوند، ردیف منابع منسوب صفحه مرجع آن را بررسی کنید. برای مثال، برای keyword_view، می‌توانید منابع آن را در صفحه مرجع آن پیدا کنید.

تخصیص به میانای کاربر

هر گزارش معیار با نمای خاصی در میانای کاربری Google Ads مطابقت دارد. نگاشت این‌ها می‌تواند به شما کمک کند داده‌های میانای برنامه‌سازی کاربردی را با آنچه در میانجی می‌بینید تطبیق دهید. برای فهرست بزرگ‌تری از نگاشت‌ها، گزارش‌ها در واسط کاربر را ببینید.

در زیر چند گزارش رایج مبتنی بر معیار و مکان‌های معمول آن‌ها در واسط کاربر آمده است:

• پویش‌ها > مخاطبان، کلیدواژه‌ها، و محتوا > کلیدواژه‌های جستجو: داده‌های معادل keyword_view را برمی‌گرداند.
• پویش‌ها > مخاطبان، کلیدواژه‌ها، و محتوا > مخاطبان > جمعیت‌شناسی: داده‌های معادل age_range_view و gender_view را برمی‌گرداند.
• پویش‌ها > مکان‌ها: داده‌های معادل location_view را برمی‌گرداند.