مقاييس المعايير

في Google Ads API، يتم تمثيل كل تقرير معايير بمورد منفصل. ما لم يكن ذلك ضروريًا، لا تحتوي موارد *_view إلا على حقل resource_name.

على عملاء Google Ads API تحديد الحقلَين ad_group_criterion أو 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 في صفحة المراجع الخاصة بها.