أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طريقة عرض جمهور المجموعة الإعلانية. يتضمّن بيانات الأداء من الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على "الشبكة الإعلانية" و"شبكة YouTube"، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث (RLSA)، ويتم تجميعها على مستوى الجمهور.
عند اختيار الحقول من الموارد أعلاه مع هذا
المرجع في جُمل SELECT وWHERE، ستقسّم المقاييس.
الحقول/الشريحة/المقاييس
تعرض هذه الصفحة جميع المقاييس والشرائح التي يمكن وضعها في عبارة SELECT نفسها مثل حقول ad_group_audience_view.
ومع ذلك، عند تحديد ad_group_audience_view في عبارة FROM،
لا يمكن استخدام بعض المقاييس والشرائح.
استخدِم الفلتر التالي لعرض الحقول التي يمكن استخدامها فقط عند تحديد ad_group_audience_view في عبارة FROM.
هل تم تحديد ad_group_audience_view في عبارة FROM من طلب البحث؟
اسم المورد لعرض جمهور المجموعة الإعلانية. يكون شكل أسماء موارد عرض الجمهور على مستوى المجموعة الإعلانية على النحو التالي: customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}
الشهر كما هو موضح في تاريخ أول يوم من الشهر. بالتنسيق 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.
عدد الإحالات الناجحة لحساب العميل لا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة 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
وصف الحقل
إجمالي عدد الإحالات الناجحة بعد رؤية الإعلان فقط ويحدث ذلك عندما يشاهد أحد العملاء إعلانًا مصوّرًا أو إعلان وسائط متعددة تفاعلية، ثم يُكمل في وقت لاحق إحالة ناجحة على موقعك الإلكتروني دون التفاعل مع إعلان آخر (على سبيل المثال، النقر على).
الإحالات الناجحة التي تبدأ عندما ينقر العميل على إعلان على جهاز معيّن، ثم يُجري إحالة ناجحة على جهاز أو متصفّح آخر. تمّ تضمين الإحالات الناجحة باستخدام أكثر من جهاز واحد في all_conversions.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Ad Group Audience View provides performance data for Display, YouTube, and RLSA campaigns, focusing on audience insights from interests and remarketing lists.\u003c/p\u003e\n"],["\u003cp\u003eData is segmented by \u003ccode\u003ebidding_strategy\u003c/code\u003e and \u003ccode\u003euser_list\u003c/code\u003e, allowing for deeper performance analysis.\u003c/p\u003e\n"],["\u003cp\u003eAvailable metrics include conversions, cost, click-through rate (CTR), impressions, and more, with options for segmentation by device, date, and conversion action.\u003c/p\u003e\n"],["\u003cp\u003eMetrics can be filtered, sorted, and segmented for customized reporting and analysis.\u003c/p\u003e\n"],["\u003cp\u003eMonetary metrics are typically in the customer's currency but can be adjusted using the \u003ccode\u003emetrics_currency\u003c/code\u003e parameter.\u003c/p\u003e\n"]]],["The Ad Group Audience View aggregates performance data for ad audiences across Display, YouTube, and search. Key actions include filtering and selecting data using resource names, segments, and metrics. Metrics, such as `clicks`, `impressions`, and `conversions`, can be segmented by `date`, `device`, `ad_network_type` or other attributes. The view uses attributed resources (`ad_group`, `campaign`), and segmenting resources (`bidding_strategy`, `user_list`). Data includes conversion counts and values, click-through rate, and costs. It will show compatible fields when being queried.\n"],null,[]]
