أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

user_location_view

عرض الموقع الجغرافي للمستخدم تتضمّن بطاقة "الموقع الجغرافي للمستخدم" جميع المقاييس المجمّعة على مستوى البلد، في صف واحد لكل بلد. ويُبلغ عن المقاييس في الموقع الجغرافي الفعلي للمستخدم حسب الموقع الجغرافي المستهدَف أو غير المستهدَف. في حال استخدام حقول شرائح أخرى، قد تحصل على أكثر من صف واحد لكل بلد.

الموارد المُحالة
العميل

يمكن اختيار حقول من الموارد أعلاه مع هذا المرجع في جُمل SELECT وWHERE. لن تُقسّم هذه الحقول المقاييس في عبارة SELECT.

تقسيم الموارد
ad_group
الحملة

عند اختيار الحقول من الموارد أعلاه مع هذا المورد في عبارتَي SELECT وWHERE، سيتم تقسيم المقاييس.

الحقول/الشريحة/المقاييس

تعرض هذه الصفحة جميع المقاييس والشرائح التي يمكن وضعها في عبارة SELECT نفسها التي تحتوي على حقول user_location_view. ومع ذلك، عند تحديد user_location_view في عبارة FROM، لا يمكن استخدام بعض المقاييس والشرائح. استخدِم الفلتر التالي لعرض الحقول التي يمكن استخدامها فقط عند تحديد user_location_view في عبارة FROM.

هل تم تحديد user_location_view في عبارة FROM من استعلامك؟

حقول الموارد
country_criterion_id
resource_name
targeting_location

الشرائح
ad_network_type
conversion_action
conversion_action_category
conversion_action_name
date
day_of_week
الجهاز
geo_target_city
geo_target_metro
geo_target_region
شهر
ربع السنة
أسبوع
year

المقاييس
all_conversions
all_conversions_from_interactions_rate
all_conversions_value
average_cost
average_cpc
average_cpm
النقرات
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
الإحالات الناجحة
conversions_from_interactions_rate
conversions_value
cost_micros
cost_per_all_conversions
cost_per_conversion
cross_device_conversions
cross_device_conversions_value
ctr
مرّات الظهور
interaction_event_types
interaction_rate
التفاعلات
value_per_all_conversions
value_per_conversion

user_location_view.country_criterion_id
وصف الحقل	رقم تعريف المعيار للبلد.
الفئة	`ATTRIBUTE`
نوع البيانات	`INT64`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

user_location_view.resource_name
وصف الحقل	اسم المورد لعرض الموقع الجغرافي للمستخدم تكون أسماء موارد عرض UserLocation على النحو التالي: `customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}`
الفئة	`ATTRIBUTE`
نوع البيانات	`RESOURCE_NAME`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	خطأ
متكرّر	خطأ

user_location_view.targeting_location
وصف الحقل	يشير إلى ما إذا كان الموقع الجغرافي مستهدفًا أم لا.
الفئة	`ATTRIBUTE`
نوع البيانات	`BOOLEAN`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.ad_network_type
وصف الحقل	نوع شبكة المواقع الإعلانية
الفئة	`SEGMENT`
نوع البيانات	`ENUM CONTENT MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE_SEARCH YOUTUBE_WATCH`
كتابة عنوان URL	`google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.conversion_action
وصف الحقل	اسم مورد إجراء الإحالة الناجحة.
الفئة	`SEGMENT`
نوع البيانات	`RESOURCE_NAME`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.conversion_action_category
وصف الحقل	فئة إجراء الإحالة الناجحة
الفئة	`SEGMENT`
نوع البيانات	`ENUM ADD_TO_CART BEGIN_CHECKOUT BOOK_APPOINTMENT CONTACT CONVERTED_LEAD DEFAULT DOWNLOAD ENGAGEMENT GET_DIRECTIONS IMPORTED_LEAD LEAD OUTBOUND_CLICK PAGE_VIEW PHONE_CALL_LEAD PURCHASE QUALIFIED_LEAD REQUEST_QUOTE SIGNUP STORE_SALE STORE_VISIT SUBMIT_LEAD_FORM SUBSCRIBE_PAID UNKNOWN UNSPECIFIED`
كتابة عنوان URL	`google.ads.searchads360.v0.enums.ConversionActionCategoryEnum.ConversionActionCategory`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.conversion_action_name
وصف الحقل	اسم إجراء الإحالة الناجحة.
الفئة	`SEGMENT`
نوع البيانات	`STRING`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.date
وصف الحقل	التاريخ الذي تنطبق عليه المقاييس. التنسيق yyyy-MM-dd، على سبيل المثال، ‎2018-04-17.
الفئة	`SEGMENT`
نوع البيانات	`DATE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.day_of_week
وصف الحقل	يوم من الأسبوع، على سبيل المثال، الإثنين
الفئة	`SEGMENT`
نوع البيانات	`ENUM FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY`
كتابة عنوان URL	`google.ads.searchads360.v0.enums.DayOfWeekEnum.DayOfWeek`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.device
وصف الحقل	الجهاز الذي تنطبق عليه المقاييس
الفئة	`SEGMENT`
نوع البيانات	`ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED`
كتابة عنوان URL	`google.ads.searchads360.v0.enums.DeviceEnum.Device`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.geo_target_city
وصف الحقل	اسم المورد للثابت المستهدَف الجغرافي الذي يمثّل مدينة.
الفئة	`SEGMENT`
نوع البيانات	`RESOURCE_NAME`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.geo_target_metro
وصف الحقل	اسم المورد للثابت المستهدف الجغرافي الذي يمثّل منطقة مترو.
الفئة	`SEGMENT`
نوع البيانات	`RESOURCE_NAME`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.geo_target_region
وصف الحقل	اسم المورد الثابت المستهدف الجغرافي الذي يمثّل منطقة
الفئة	`SEGMENT`
نوع البيانات	`RESOURCE_NAME`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.month
وصف الحقل	الشهر كما يمثّله تاريخ اليوم الأول من الشهر بالتنسيق 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
وصف الحقل	كل الإحالات الناجحة الناتجة عن التفاعلات (بخلاف الإحالات الناجحة بعد رؤية الإعلان فقط) مقسومةً على عدد التفاعلات مع الإعلانات.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.all_conversions_value
وصف الحقل	قيمة كل الإحالات الناجحة.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.average_cost
وصف الحقل	متوسّط المبلغ الذي تدفعه لكلّ تفاعل. هذا المبلغ هو إجمالي تكلفة إعلاناتك مقسومًا على إجمالي عدد التفاعلات.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.average_cpc
وصف الحقل	إجمالي تكلفة جميع النقرات مقسومًا على إجمالي عدد النقرات التي تم تلقّيها. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.average_cpm
وصف الحقل	متوسط التكلفة لكل ألف ظهور (CPM). هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.clicks
وصف الحقل	عدد النقرات.
الفئة	`METRIC`
نوع البيانات	`INT64`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.client_account_conversions
وصف الحقل	عدد الإحالات الناجحة في حساب العميل ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة "include_in_client_account_conversions_metric"" عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.client_account_conversions_value
وصف الحقل	قيمة الإحالات الناجحة لحساب العميل. لا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة include_in_client_account_conversions_metric عليها على true. إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.client_account_view_through_conversions
وصف الحقل	إجمالي عدد الإحالات الناجحة بعد رؤية الإعلان فقط تحدث هذه الإحالات الناجحة عندما يرى عميل صورة أو إعلانًا بالوسائط الغنية، ثم يُكمل لاحقًا إحالة ناجحة على موقعك الإلكتروني بدون التفاعل مع إعلان آخر (مثلاً، النقر عليه).
الفئة	`METRIC`
نوع البيانات	`INT64`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.conversions
وصف الحقل	عدد الإحالات الناجحة. لا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة include_in_conversions_metric عليها على true. إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.conversions_from_interactions_rate
وصف الحقل	متوسّط الإحالات الناجحة التي يمكن تقديم عروض أسعار لها (من التفاعل) لكلّ تفاعل مؤهّل للإحالة الناجحة. تعرِض هذه السمة متوسّط عدد المرّات التي يؤدّي فيها أحد التفاعلات مع الإعلان إلى إحالة ناجحة يمكن تقديم عروض أسعار لها.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.conversions_value
وصف الحقل	مجموع قيم الإحالات الناجحة للإحالات الناجحة المضمّنة في حقل "الإحالات الناجحة". يُعدّ هذا المقياس مفيدًا فقط إذا أدخلت قيمة لإجراءات الإحالات الناجحة.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.cost_micros
وصف الحقل	مجموع تكلفة النقرة (CPC) والتكلفة لكل ألف ظهور (CPM) خلال هذه الفترة. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
الفئة	`METRIC`
نوع البيانات	`INT64`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.cost_per_all_conversions
وصف الحقل	تكلفة التفاعلات مع الإعلانات مقسومة على جميع الإحالات الناجحة.
الفئة	`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.interaction_event_types
وصف الحقل	أنواع التفاعلات المدفوعة والمجانية
الفئة	`METRIC`
نوع البيانات	`ENUM`
كتابة عنوان URL	`google.ads.searchads360.v0.enums.InteractionEventTypeEnum.InteractionEventType`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	خطأ
متكرر	صحيح

metrics.interaction_rate
وصف الحقل	عدد مرات تفاعل المستخدِمين مع إعلانك بعد ظهوره لهم. يشير إلى عدد التفاعلات مقسومًا على عدد مرات عرض إعلانك.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.interactions
وصف الحقل	عدد التفاعلات التفاعل هو الإجراء الأساسي الذي يتّخذه المستخدِم والمرتبط بأحد أشكال الإعلانات، مثل النقرات على الإعلانات النصية وإعلانات Shopping، ومرّات مشاهدة إعلانات الفيديو، وما إلى ذلك.
الفئة	`METRIC`
نوع البيانات	`INT64`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.value_per_all_conversions
وصف الحقل	قيمة كل الإحالات الناجحة مقسومة على عدد كل الإحالات الناجحة.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.value_per_conversion
وصف الحقل	قيمة الإحالة الناجحة التي يمكن تقديم عروض أسعار لها مقسومةً على عدد الإحالات الناجحة التي يمكن تقديم عروض أسعار لها. يعرِض هذا المقياس متوسط قيمة كل إحالة من الإحالات الناجحة التي يمكن تقديم عروض أسعار لها.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

user_location_view

الحقول/الشريحة/المقاييس

user_location_view.country_criterion_id

user_location_view.resource_name

user_location_view.targeting_location

segments.ad_network_type

segments.conversion_action

segments.conversion_action_category

segments.conversion_action_name

segments.date

segments.day_of_week

segments.device

segments.geo_target_city

segments.geo_target_metro

segments.geo_target_region

segments.month

segments.quarter

segments.week

segments.year

metrics.all_conversions

metrics.all_conversions_from_interactions_rate

metrics.all_conversions_value

metrics.average_cost

metrics.average_cpc

metrics.average_cpm

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

metrics.conversions

metrics.conversions_from_interactions_rate

metrics.conversions_value

metrics.cost_micros

metrics.cost_per_all_conversions

metrics.cost_per_conversion

metrics.cross_device_conversions

metrics.cross_device_conversions_value

metrics.ctr

metrics.impressions

metrics.interaction_event_types

metrics.interaction_rate

metrics.interactions

metrics.value_per_all_conversions

metrics.value_per_conversion