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

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

على عملاء Google Ads API تحديد الحقلَين ad_group_criterion أو campaign_criterion المناسبَين إذا كانت هناك أي بيانات خاصة بمعايير معيّنة يجب استرجاعها. يرتبط كل عرض بمورد المعايير الذي يتطابق مع مستوى الاستهداف (على سبيل المثال، يرتبط keyword_view بـ ad_group_criterion، بينما يرتبط location_view بـ 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.