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

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

ad_group_audience_view

طريقة عرض جمهور المجموعة الإعلانية. يتضمّن بيانات الأداء من الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على "الشبكة الإعلانية" و"شبكة YouTube"، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث (RLSA)، ويتم تجميعها على مستوى الجمهور.

الموارد التي تمّ تحديد مصدرها
ad_group
ad_group_criterion
الحملة
العميل

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

تقسيم الموارد
bidding_strategy
user_list

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

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

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

هل تم تحديد ad_group_audience_view في عبارة FROM من طلب البحث؟

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

الشرائح
ad_network_type
conversion_action_name
date
device
شهر
ربع السنة
أسبوع
year

المقاييس
all_conversions
all_conversions_by_conversion_date
all_conversions_value
all_conversions_value_by_conversion_date
average_cpc
average_cpm
النقرات
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
cost_micros
cross_device_conversions
cross_device_conversions_by_conversion_date
cross_device_conversions_value
cross_device_conversions_value_by_conversion_date
ctr
مرّات الظهور

ad_group_audience_view.resource_name
وصف الحقل	اسم المورد لعرض جمهور المجموعة الإعلانية. يكون شكل أسماء موارد عرض الجمهور على مستوى المجموعة الإعلانية على النحو التالي: `customers/{customer_id}/adGroupAudienceViews/{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_name
وصف الحقل	اسم إجراء الإحالة الناجحة.
الفئة	`SEGMENT`
نوع البيانات	`STRING`
كتابة عنوان URL	`N/A`
قابل للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

segments.date
وصف الحقل	التاريخ الذي تنطبق عليه المقاييس. التنسيق yyyy-MM-dd، على سبيل المثال، ‎2018-04-17.
الفئة	`SEGMENT`
نوع البيانات	`DATE`
كتابة عنوان URL	`N/A`
قابل للفلترة	صحيح
يمكن الاختيار	صحيح
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 في 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_by_conversion_date
وصف الحقل	إجمالي عدد التحويلات. ويشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمة include_in_conversions_metric. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود التاريخ إلى تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابل للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

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

metrics.all_conversions_value_by_conversion_date
وصف الحقل	قيمة كل الإحالات الناجحة. عند اختيار هذا العمود مع التاريخ، تعني القيم في عمود "التاريخ" تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.
الفئة	`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 عليها على true. إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة.
الفئة	`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.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.cross_device_conversions
وصف الحقل	الإحالات الناجحة التي تبدأ عندما ينقر العميل على إعلان على جهاز معيّن، ثم يُجري إحالة ناجحة على جهاز أو متصفّح آخر. تمّ تضمين الإحالات الناجحة باستخدام أكثر من جهاز واحد في all_conversions.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابل للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

metrics.cross_device_conversions_by_conversion_date
وصف الحقل	عدد الإحالات الناجحة باستخدام أكثر من جهاز واحد حسب تاريخ الإحالة الناجحة تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابل للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

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

metrics.cross_device_conversions_value_by_conversion_date
وصف الحقل	مجموع قيمة الإحالات الناجحة باستخدام أكثر من جهاز واحد حسب تاريخ الإحالة الناجحة تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابل للفلترة	صحيح
يمكن الاختيار	صحيح
Sortable	صحيح
متكرر	خطأ

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

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

ad_group_audience_view

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

ad_group_audience_view.resource_name

segments.ad_network_type

segments.conversion_action_name

segments.date

segments.device

segments.month

segments.quarter

segments.week

segments.year

metrics.all_conversions

metrics.all_conversions_by_conversion_date

metrics.all_conversions_value

metrics.all_conversions_value_by_conversion_date

metrics.average_cpc

metrics.average_cpm

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

metrics.cost_micros

metrics.cross_device_conversions

metrics.cross_device_conversions_by_conversion_date

metrics.cross_device_conversions_value

metrics.cross_device_conversions_value_by_conversion_date

metrics.ctr

metrics.impressions