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

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

الربط بواجهة المستخدِم

يتوافق كل تقرير معايير مع عرض معيّن في واجهة مستخدِم Google Ads. يمكن أن يساعدك ربط هذه التقارير في مطابقة بيانات واجهة برمجة التطبيقات مع ما يظهر لك في الواجهة. للاطّلاع على قائمة أكبر بعمليات الربط، يُرجى الاطّلاع على التقارير في واجهة المستخدِم.

في ما يلي بعض التقارير الشائعة المستندة إلى المعايير ومواقعها النموذجية في واجهة المستخدِم:

• الحملات > شرائح الجمهور والكلمات الرئيسية والمحتوى > كلمات البحث الرئيسية: تعرض بيانات مكافئة لـ keyword_view.
• الحملات > شرائح الجمهور والكلمات الرئيسية والمحتوى > شرائح الجمهور > التركيبة السكانية: تعرض بيانات مكافئة لـ age_range_view و gender_view.
• الحملات والمواقع الجغرافية: تعرض بيانات مكافئة لـ location_view.