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

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

عميل_مادة العرض

تمثّل هذه السمة رابطًا بين عميل ومادة عرض.

المراجع المنسوبة
مادة عرض
عميل

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

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

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

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

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

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

حقول الموارد
مادة عرض
resource_name
الحالة

الشرائح
asset_interaction_target.asset
asset_interaction_target.interaction_on_this_asset
conversion_action_name
التاريخ
الشهر
ربع السنة
أسبوع
سنة

المقاييس
all_conversions
all_conversions_value
average_cpc
average_cpm
النقرات
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
cost_micros
cross_device_conversions
cross_device_conversions_value
نسبة النقر إلى الظهور
مرّات الظهور

customer_asset.asset
وصف الحقل	مطلوبة. غير قابل للتغيير. مادة العرض المرتبطة بالعميل.
الفئة	`ATTRIBUTE`
نوع البيانات	`RESOURCE_NAME`
اكتب عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن اختيارها	صحيح
Sortable	خطأ
متكرر	خطأ

customer_asset.resource_name
وصف الحقل	اسم المورد لمادة عرض العميل تكون أسماء موارد CustomerAsset بالصيغة: `customers/{customer_id}/customerAssets/{asset_id}~{field_type}`
الفئة	`ATTRIBUTE`
نوع البيانات	`RESOURCE_NAME`
اكتب عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن اختيارها	صحيح
Sortable	خطأ
متكرر	خطأ

customer_asset.status
وصف الحقل	حالة مادة عرض العميل
الفئة	`ATTRIBUTE`
نوع البيانات	`ENUM ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED`
اكتب عنوان URL	`google.ads.searchads360.v0.enums.AssetLinkStatusEnum.AssetLinkStatus`
قابلة للفلترة	صحيح
يمكن اختيارها	صحيح
Sortable	صحيح
متكرر	خطأ

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

segments.asset_interaction_target.interaction_on_this_asset
وصف الحقل	تُستخدَم فقط مع مقاييس CustomerAsset وCampaignAsset وMoodAsset. يشير إلى ما إذا كانت مقاييس التفاعل حدثت في مادة العرض نفسها أو في مادة عرض أو وحدة إعلانية مختلفة.
الفئة	`SEGMENT`
نوع البيانات	`BOOLEAN`
اكتب عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن اختيارها	صحيح
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.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_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.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.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_value
وصف الحقل	مجموع قيمة الإحالات الناجحة باستخدام أكثر من جهاز واحد.
الفئة	`METRIC`
نوع البيانات	`DOUBLE`
اكتب عنوان URL	`N/A`
قابلة للفلترة	صحيح
يمكن اختيارها	صحيح
Sortable	صحيح
متكرر	خطأ

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

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

عميل_مادة العرض

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

customer_asset.asset

customer_asset.resource_name

customer_asset.status

segments.asset_interaction_target.asset

segments.asset_interaction_target.interaction_on_this_asset

segments.conversion_action_name

segments.date

segments.month

segments.quarter

segments.week

segments.year

metrics.all_conversions

metrics.all_conversions_value

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_value

metrics.ctr

metrics.impressions