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

في 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". يمكن أن يساعدك ربط هذه العناصر في التوفيق بين بيانات واجهة برمجة التطبيقات والبيانات التي تظهر لك في الواجهة. للحصول على قائمة أكبر بعمليات الربط، اطّلِع على التقارير في واجهة المستخدم.

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

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