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

campaign_audience_view (حملة_الجمهور)

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

المراجع المنسوبة
الحملة
campaign_criterion
العميل

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

الحقول/الأقسام/المقاييس

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

هل تم تحديد campaign_audience_view في عبارة FROM الخاصة بطلب البحث؟

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

الشرائح
ad_network_type
conversion_action
conversion_action_category
conversion_action_name
date
الجهاز
شهر
ربع
week
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
مرّات الظهور

campaign_audience_view.resource_name
وصف الحقل	اسم مورد "طريقة عرض جمهور الحملة". تتّخذ أسماء موارد "طريقة عرض الجمهور على مستوى الحملة" الشكل التالي: `customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}`
الفئة	`ATTRIBUTE`
نوع البيانات	`RESOURCE_NAME`
كتابة عنوان URL	`N/A`
قابل للفلترة	True
قابلة للاختيار	True
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`
قابل للفلترة	True
قابلة للاختيار	True
Sortable	True
متكرّر	خطأ

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

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 YOUTUBE_FOLLOW_ON_VIEWS`
كتابة عنوان URL	`google.ads.searchads360.v0.enums.ConversionActionCategoryEnum.ConversionActionCategory`
قابل للفلترة	True
قابلة للاختيار	True
Sortable	True
متكرّر	خطأ

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

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

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

segments.month
وصف الحقل	الشهر كما هو ممثّل بتاريخ اليوم الأول من الشهر يجب أن يكون التنسيق yyyy-MM-dd.
الفئة	`SEGMENT`
نوع البيانات	`DATE`
كتابة عنوان URL	`N/A`
قابل للفلترة	True
قابلة للاختيار	True
Sortable	True
متكرّر	خطأ

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

segments.week
وصف الحقل	الأسبوع هو الفترة من الاثنين إلى الأحد، ويتم تمثيله بتاريخ يوم الاثنين. يجب أن يكون التنسيق yyyy-MM-dd.
الفئة	`SEGMENT`
نوع البيانات	`DATE`
كتابة عنوان URL	`N/A`
قابل للفلترة	True
قابلة للاختيار	True
Sortable	True
متكرّر	خطأ

segments.year
وصف الحقل	السنة، بتنسيق yyyy
الفئة	`SEGMENT`
نوع البيانات	`INT32`
كتابة عنوان URL	`N/A`
قابل للفلترة	True
قابلة للاختيار	True
Sortable	True
متكرّر	خطأ

metrics.all_conversions
وصف الحقل	إجمالي عدد التحويلات. ويشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمة include_in_conversions_metric.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابل للفلترة	True
قابلة للاختيار	True
Sortable	True
متكرّر	خطأ

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`
قابل للفلترة	True
قابلة للاختيار	True
Sortable	True
متكرّر	خطأ

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

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

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

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

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

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

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

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

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

metrics.cross_device_conversions
وصف الحقل	الإحالات الناجحة التي تحدث عندما ينقر أحد العملاء على إعلان على جهاز معيّن، ثمّ يُجري إحالة ناجحة على جهاز أو متصفّح آخر. يتمّ تضمين الإحالات الناجحة على جميع الأجهزة في all_conversions تلقائيًا.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
كتابة عنوان URL	`N/A`
قابل للفلترة	True
قابلة للاختيار	True
Sortable	True
متكرّر	خطأ

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

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

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

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

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

campaign_audience_view (حملة_الجمهور) تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الحقول/الأقسام/المقاييس

campaign_audience_view.resource_name

segments.ad_network_type

segments.conversion_action

segments.conversion_action_category

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

campaign_audience_view (حملة_الجمهور)