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

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

keyword_view

طريقة عرض الكلمات الرئيسية.

الموارد المُحالة
accessible_bidding_strategy
ad_group
ad_group_criterion
bidding_strategy
الحملة
العميل

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

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

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

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

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

شرائح الجمهور
ad_network_type
conversion_action
conversion_action_category
conversion_action_name
التاريخ
day_of_week
الجهاز
شهر
ربع سنة
أسبوع
سنة

المقاييس
all_conversions
all_conversions_from_interactions_rate
all_conversions_from_interactions_value_per_interaction
all_conversions_value
average_cpc
average_cpm
average_quality_score
النقرات
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
الإحالات الناجحة
conversions_value
cost_micros
cost_per_all_conversions
cost_per_conversion
cross_device_conversions
cross_device_conversions_value
ctr
historical_quality_score
مرّة ظهور
الزيارات

keyword_view.resource_name
وصف الحقل	اسم المورد لعرض الكلمات الرئيسية. تكون أسماء موارد عرض الكلمات الرئيسية على النحو التالي: `customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}`
الفئة	`ATTRIBUTE`
نوع البيانات	`RESOURCE_NAME`
كتابة عنوان 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، مثلًا، 17-04-2018.
الفئة	`SEGMENT`
نوع البيانات	`DATE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.day_of_week
وصف الحقل	يوم من الأسبوع، على سبيل المثال، MONDAY.
الفئة	`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.month
وصف الحقل	الشهر كما هو موضح في تاريخ أول يوم من الشهر. التنسيق بالتنسيق yyyy-MM-dd
الفئة	`SEGMENT`
نوع البيانات	`DATE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.quarter
وصف الحقل	ربع كما يمثله تاريخ أول يوم من ربع السنة. تستخدم السنة التقويمية لربع السنة، على سبيل المثال، يبدأ الربع الثاني من عام 2018 في 2018-04-01. التنسيق بالتنسيق 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
وصف الحقل	إجمالي عدد التحويلات. يشمل ذلك كل الإحالات الناجحة بغض النظر عن قيمة add_in_conversions_metric.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

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

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

metrics.all_conversions_value
وصف الحقل	قيمة كل الإحالات الناجحة.
الفئة	`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.average_quality_score
وصف الحقل	تمثّل هذه السمة متوسط نقاط الجودة.
الفئة	`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"" عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

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

metrics.conversions
وصف الحقل	عدد الإحالات الناجحة. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة "include_in_conversions_metric"" عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
الفئة	`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.historical_quality_score
وصف الحقل	نقاط الجودة للفترات السابقة.
الفئة	`METRIC`
نوع البيانات	`INT64`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.impressions
وصف الحقل	يشير إلى عدد مرات ظهور إعلانك على إحدى صفحات نتائج البحث أو أحد المواقع الإلكترونية في شبكة Google.
الفئة	`METRIC`
نوع البيانات	`INT64`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.visits
وصف الحقل	النقرات التي سجّلتها "إعلانات شبكة البحث 360" وأعادت توجيهها إلى الصفحة المقصودة للمعلِن بنجاح
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

keyword_view

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

keyword_view.resource_name

segments.ad_network_type

segments.conversion_action

segments.conversion_action_category

segments.conversion_action_name

segments.date

segments.day_of_week

segments.device

segments.month

segments.quarter

segments.week

segments.year

metrics.all_conversions

metrics.all_conversions_from_interactions_rate

metrics.all_conversions_from_interactions_value_per_interaction

metrics.all_conversions_value

metrics.average_cpc

metrics.average_cpm

metrics.average_quality_score

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

metrics.conversions

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.historical_quality_score

metrics.impressions

metrics.visits