أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
يمكن اختيار الحقول من الموارد أعلاه مع هذا المورد في عبارتَي SELECT وWHERE. لن تؤدي هذه الحقول إلى تقسيم
المقاييس في عبارة SELECT.
الحقول/الشرائح/المقاييس
تعرض هذه الصفحة جميع المقاييس والشرائح التي يمكن وضعها في نفس عبارة SELECT مثل حقول conversion.
مع ذلك، عند تحديد conversion في العبارة FROM، لا يمكن استخدام بعض المقاييس والشرائح.
استخدِم الفلتر التالي لعرض الحقول التي يمكن استخدامها فقط عند تحديد conversion في عبارة FROM.
الرقم التعريفي للإعلان. تشير القيمة 0 إلى أنّه لم يتم تحديد مصدر الإعلان.
الفئة
ATTRIBUTE
نوع البيانات
INT64
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.advertiser_conversion_id
وصف الحقل
بالنسبة إلى الإحالات الناجحة بلا إنترنت، يمثّل هذا النوع المعرّف الذي يقدّمه المعلِنون. إذا لم يحدِّد المعلِن رقم تعريف من هذا النوع، تُنشئ "إعلانات شبكة البحث 360" رقمًا تعريفيًا. بالنسبة إلى الإحالات الناجحة على الإنترنت، تساوي هذه القيمة عمود "id" (رقم التعريف) أو عمود Floodlight_order_id استنادًا إلى تعليمات المعلِن على Floodlight.
سلسلة فريدة للزيارة التي تُنسب إليها الإحالة الناجحة، يتم تمريرها إلى الصفحة المقصودة باعتبارها مَعلمة عنوان URL لمعرّف النقرة.
الفئة
ATTRIBUTE
نوع البيانات
STRING
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.conversion_date_time
وصف الحقل
الطابع الزمني لحدث الإحالة الناجحة.
الفئة
ATTRIBUTE
نوع البيانات
DATE
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.conversion_last_modified_date_time
وصف الحقل
الطابع الزمني لآخر مرة تم فيها تعديل الإحالة الناجحة.
الفئة
ATTRIBUTE
نوع البيانات
DATE
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.conversion_quantity
وصف الحقل
كمية السلع التي سجّلتها الإحالة الناجحة، على النحو الذي تحدّده المَعلمة qty لعنوان URL. المعلِن مسؤول عن تعبئة المَعلمة ديناميكيًا (مثل عدد السلع المُباعة في الإحالة الناجحة)، وبخلاف ذلك، يتم ضبطها تلقائيًا على 1.
الفئة
ATTRIBUTE
نوع البيانات
INT64
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.conversion_revenue_micros
وصف الحقل
الأرباح المعدَّلة بوحدات المايكرو لحدث الإحالة الناجحة. وستكون دائمًا بعملة حساب عرض الإعلانات.
الفئة
ATTRIBUTE
نوع البيانات
INT64
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.conversion_visit_date_time
وصف الحقل
الطابع الزمني للزيارة التي تُنسب إليها الإحالة الناجحة.
الفئة
ATTRIBUTE
نوع البيانات
DATE
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.criterion_id
وصف الحقل
رقم تعريف معيار "إعلانات شبكة البحث 360". تشير القيمة 0 إلى أنّ المعيار غير مرتبط.
الفئة
ATTRIBUTE
نوع البيانات
INT64
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.floodlight_order_id
وصف الحقل
مُعرّف طلب Floodlight الذي قدّمه المعلِن للإحالة الناجحة.
الفئة
ATTRIBUTE
نوع البيانات
STRING
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.floodlight_original_revenue
وصف الحقل
الأرباح الأصلية التي لم تتغيّر والمرتبطة بحدث Floodlight (بعملة التقرير الحالي)، قبل تعديل تعليمات عملة Floodlight
الفئة
ATTRIBUTE
نوع البيانات
INT64
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.id
وصف الحقل
رقم تعريف الإحالة الناجحة
الفئة
ATTRIBUTE
نوع البيانات
INT64
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.merchant_id
وصف الحقل
رقم تعريف حساب المستودع في "إعلانات شبكة البحث 360" الذي يحتوي على المنتج الذي تم النقر عليه. تُنشئ "إعلانات شبكة البحث 360" هذا المعرّف عند ربط حساب مستودع في "إعلانات شبكة البحث 360".
الفئة
ATTRIBUTE
نوع البيانات
INT64
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.product_channel
وصف الحقل
قناة البيع الخاصة بالمنتج الذي تم النقر عليه: على الإنترنت أو محلي
البلد (بالتنسيق ISO-3166) المسجَّل في خلاصة المستودع التي تحتوي على المنتج الذي تم النقر عليه.
الفئة
ATTRIBUTE
نوع البيانات
STRING
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.product_id
وصف الحقل
رقم تعريف المنتج الذي تم النقر عليه.
الفئة
ATTRIBUTE
نوع البيانات
STRING
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.product_language_code
وصف الحقل
اللغة (ISO-639-1) التي تم ضبطها لخلاصة Merchant Center وتحتوي على بيانات حول المنتج.
الفئة
ATTRIBUTE
نوع البيانات
STRING
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.product_store_id
وصف الحقل
المتجر في إعلان المنتجات داخل المتجر الذي تم النقر عليه. ويجب أن تتطابق هذه القيمة مع أرقام تعريف المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلّية.
الفئة
ATTRIBUTE
نوع البيانات
STRING
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
conversion.resource_name
وصف الحقل
اسم مورد الإحالة الناجحة. تكون أسماء موارد الإحالات الناجحة على النحو التالي: customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}
الفئة
ATTRIBUTE
نوع البيانات
RESOURCE_NAME
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
خطأ
تكرار
خطأ
conversion.status
وصف الحقل
حالة الإحالة الناجحة، إما "مفعّلة" أو "تمّت إزالتها".
الشهر كما هو موضح بتاريخ أول يوم من الشهر. وقد تم التنسيق كـ yyyy-MM-dd.
الفئة
SEGMENT
نوع البيانات
DATE
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
segments.quarter
وصف الحقل
ربع السنة كما هو ممثّل بتاريخ أول يوم من ربع السنة. لاستخدام السنة التقويمية للأرباع، على سبيل المثال، يبدأ الربع الثاني من 2018 في 1-04-2018. وقد تم التنسيق كـ yyyy-MM-dd.
الفئة
SEGMENT
نوع البيانات
DATE
اكتب عنوان URL
N/A
قابلة للفلترة
صحيح
يمكن اختياره
صحيح
Sortable
صحيح
تكرار
خطأ
segments.week
وصف الحقل
الأسبوع كما هو محدّد من الاثنين إلى الأحد، ويُشار إليه بتاريخ الاثنين. وقد تم التنسيق كـ yyyy-MM-dd.
تاريخ التعديل الأخير: 2025-05-08 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-05-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The `conversion` resource stores data about conversions, including attribution details, timestamps, revenue, and product information."],["Conversions can be attributed to visits or keywords and ads, providing insights into campaign performance."],["The resource includes various fields for identifying the conversion, associated assets, and segments for analysis."],["Data can be segmented by attributes like ad network type, conversion action, date, device, and more."],["Each field has specific data types and properties that determine how it can be used in queries and reporting."]]],["The document details how to utilize the `conversion` resource for data retrieval. It outlines attributed resources (`ad_group`, `campaign`, etc.) for `SELECT` and `WHERE` clauses. The core content focuses on fields, like `ad_id`, `conversion_date_time`, and `conversion_revenue_micros`, that can be filtered, selected, and sorted. It also describes segment fields including `ad_network_type`, `conversion_action`, and time-based segments, as well as the data types and properties of these fields, enabling detailed conversion analysis.\n"]]
