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

في 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، يمكنك العثور على موارده في الصفحة المرجعية.