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

في 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.
السابق
حالة الاستخدام
التالي
تتبُّع موضع الإعلان وأدائه