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

في 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 في الصفحة المرجعية.