أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
يمكن اختيار حقول من الموارد أعلاه مع هذا
المرجع في جُمل SELECT وWHERE. لن تُقسّم
هذه الحقول المقاييس في عبارة SELECT.
الحقول/الشريحة/المقاييس
تعرض هذه الصفحة جميع المقاييس والشرائح التي يمكن وضعها في عبارة SELECT نفسها التي تحتوي على حقول product_group_view.
ومع ذلك، عند تحديد product_group_view في عبارة FROM،
لا يمكن استخدام بعض المقاييس والشرائح.
استخدِم الفلتر التالي لعرض الحقول التي يمكن استخدامها فقط عند تحديد product_group_view في عبارة FROM.
هل تم تحديد product_group_view في عبارة FROM من استعلامك؟
اسم المورد لعرض مجموعة المنتجات. تكون أسماء موارد عرض مجموعة المنتجات على النحو التالي: customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}
الشهر كما هو موضح في تاريخ أول يوم من الشهر. بالتنسيق yyyy-MM-dd
الفئة
SEGMENT
نوع البيانات
DATE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
segments.quarter
وصف الحقل
ربع كما يمثله تاريخ أول يوم من ربع السنة. يستخدم السنة التقويمية للربعات، على سبيل المثال، يبدأ الربع الثاني من عام 2018 في 01-04-2018. بالتنسيق yyyy-MM-dd
الفئة
SEGMENT
نوع البيانات
DATE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
segments.week
وصف الحقل
الأسبوع على أنّه من الاثنين إلى الأحد، ويمثّله تاريخ الاثنين بالتنسيق yyyy-MM-dd
الفئة
SEGMENT
نوع البيانات
DATE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
segments.year
وصف الحقل
السنة بالتنسيق yyyy
الفئة
SEGMENT
نوع البيانات
INT32
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.all_conversions
وصف الحقل
إجمالي عدد التحويلات. ويشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمة include_in_conversions_metric.
الفئة
METRIC
نوع البيانات
DOUBLE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.all_conversions_from_interactions_rate
وصف الحقل
كل الإحالات الناجحة الناتجة عن التفاعلات (بخلاف الإحالات الناجحة بعد رؤية الإعلان فقط) مقسومةً على عدد التفاعلات مع الإعلانات.
عدد الإحالات الناجحة لحساب العميل لا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة include_in_client_account_conversions_metric عليها على true. إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة.
الفئة
METRIC
نوع البيانات
DOUBLE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.client_account_conversions_value
وصف الحقل
قيمة الإحالات الناجحة لحساب العميل. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة "include_in_client_account_conversions_metric"" عليها على "صحيح". إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة.
الفئة
METRIC
نوع البيانات
DOUBLE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.client_account_view_through_conversions
وصف الحقل
إجمالي عدد الإحالات الناجحة بعد رؤية الإعلان فقط تحدث هذه الإحالات الناجحة عندما يرى عميل صورة أو إعلانًا بالوسائط الغنية، ثم يُكمل لاحقًا إحالة ناجحة على موقعك الإلكتروني بدون التفاعل مع إعلان آخر (مثلاً، النقر عليه).
الفئة
METRIC
نوع البيانات
INT64
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.conversions_from_interactions_rate
وصف الحقل
متوسّط الإحالات الناجحة التي يمكن تقديم عروض أسعار لها (من التفاعل) لكلّ تفاعل مؤهّل للإحالة الناجحة. تعرِض هذه السمة متوسّط عدد المرّات التي يؤدّي فيها أحد التفاعلات مع الإعلان إلى إحالة ناجحة يمكن تقديم عروض أسعار لها.
تكلفة التفاعلات مع الإعلانات مقسومة على جميع الإحالات الناجحة.
الفئة
METRIC
نوع البيانات
DOUBLE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.cost_per_conversion
وصف الحقل
متوسّط التكلفة المؤهّلة للإحالة الناجحة لكلّ إحالة ناجحة يمكن ضبط عرض سعر لها.
الفئة
METRIC
نوع البيانات
DOUBLE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.cross_device_conversions
وصف الحقل
الإحالات الناجحة التي تبدأ عندما ينقر العميل على إعلان على جهاز معيّن، ثم يُجري إحالة ناجحة على جهاز أو متصفّح آخر. تمّ تضمين الإحالات الناجحة باستخدام أكثر من جهاز واحد في all_conversions.
الفئة
METRIC
نوع البيانات
DOUBLE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.cross_device_conversions_value
وصف الحقل
مجموع قيمة الإحالات الناجحة باستخدام أكثر من جهاز واحد
الفئة
METRIC
نوع البيانات
DOUBLE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.ctr
وصف الحقل
عدد النقرات التي يتلقّاها إعلانك (النقرات) مقسومًا على عدد مرّات ظهور إعلانك (مرّات الظهور).
الفئة
METRIC
نوع البيانات
DOUBLE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.impressions
وصف الحقل
يشير إلى عدد مرات ظهور إعلانك على إحدى صفحات نتائج البحث أو أحد المواقع الإلكترونية في شبكة Google.
الفئة
METRIC
نوع البيانات
INT64
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.search_absolute_top_impression_share
وصف الحقل
النسبة المئوية لمرات ظهور الإعلان على شبكة البحث أو Shopping للعميل التي تظهر في أبرز مواضع Shopping. يمكنك الانتقال إلى https://support.google.com/sa360/answer/9566729 لمعرفة التفاصيل. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.
الفئة
METRIC
نوع البيانات
DOUBLE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.search_click_share
وصف الحقل
يشير هذا المقياس إلى عدد النقرات التي تلقّيتها على شبكة البحث مقسومًا على العدد المقدَّر لعدد النقرات التي كنت مؤهلاً لتلقّيها. ملاحظة: يتم تسجيل نسبة النقر على الإعلان على شبكة البحث في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.
الفئة
METRIC
نوع البيانات
DOUBLE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.search_impression_share
وصف الحقل
عدد مرات الظهور التي تلقاها إعلانك في شبكة البحث مقسومًا على العدد المقدَّر لمرات الظهور التي كنت مؤهَّلاً للحصول عليها. ملاحظة: يتم تسجيل نسبة ظهور الإعلان على شبكة البحث في النطاق من 0.1 إلى 1. أي قيمة أقل من 0.1 يتم تسجيلها كـ 0.0999.
الفئة
METRIC
نوع البيانات
DOUBLE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.value_per_all_conversions
وصف الحقل
قيمة كل الإحالات الناجحة مقسومة على عدد كل الإحالات الناجحة.
الفئة
METRIC
نوع البيانات
DOUBLE
اكتب عنوان URL.
N/A
قابل للفلترة
صحيح
يمكن اختيارها
صحيح
Sortable
صحيح
متكرّر
خطأ
metrics.value_per_conversion
وصف الحقل
قيمة الإحالة الناجحة التي يمكن تقديم عروض أسعار لها مقسومةً على عدد الإحالات الناجحة التي يمكن تقديم عروض أسعار لها. يعرِض هذا المقياس متوسط قيمة كل إحالة من الإحالات الناجحة التي يمكن تقديم عروض أسعار لها.
تاريخ التعديل الأخير: 2024-11-07 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-11-07 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The `product_group_view` provides insights into the performance of product groups within advertising campaigns, like those in Google Search Ads 360."],["It allows analysis using various metrics such as cost, conversions, click-through rates, and impression share, alongside segments like device, date, and conversion action."],["Data can be queried and filtered using associated resources like `ad_group`, `ad_group_criterion`, `campaign`, and `customer`."],["The view includes specific metrics focusing on Shopping and Search ad performance, including impression share and click share in those contexts."],["Detailed descriptions of each field, segment, and metric are available, specifying their data type, category, and usability for filtering, selecting, and sorting data."]]],["The Product Group View displays product group data, allowing field selection from related resources like `ad_group` and `customer`. It details the `resource_name` with its format. Segments like `ad_network_type`, `date`, and `device` are filterable, selectable, and sortable. Metrics include conversion counts and rates (`all_conversions`, `conversions_from_interactions_rate`), cost metrics (`average_cpc`, `cost_per_conversion`), and engagement metrics (`clicks`, `impressions`, `ctr`). Some considerations: Metrics and segments have currency and filtering limitations. They are filterable, selectable, and sortable.\n"]]