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

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

Package google.ads.searchads360.v0.common

الفهرس

AdScheduleInfo (رسالة)
AdTextAsset (رسالة)
AgeRangeInfo (رسالة)
AssetInteractionTarget (رسالة)
AssetUsage (رسالة)
AudienceInfo (رسالة)
BusinessProfileLocation (رسالة)
CallToActionAsset (رسالة)
CustomParameter (رسالة)
DeviceInfo (رسالة)
EnhancedCpc (رسالة)
FinalAppUrl (رسالة)
FrequencyCapEntry (رسالة)
GenderInfo (رسالة)
ImageAsset (رسالة)
ImageDimension (رسالة)
Keyword (رسالة)
KeywordInfo (رسالة)
LanguageInfo (رسالة)
ListingGroupInfo (رسالة)
LocationGroupInfo (رسالة)
LocationInfo (رسالة)
ManualCpa (رسالة)
ManualCpc (رسالة)
ManualCpm (رسالة)
MaximizeConversionValue (رسالة)
MaximizeConversions (رسالة)
Metrics (رسالة)
MobileAppAsset (رسالة)
PercentCpc (رسالة)
RealTimeBiddingSetting (رسالة)
SearchAds360ExpandedDynamicSearchAdInfo (رسالة)
SearchAds360ExpandedTextAdInfo (رسالة)
SearchAds360ProductAdInfo (رسالة)
SearchAds360ResponsiveSearchAdInfo (رسالة)
SearchAds360TextAdInfo (رسالة)
Segments (رسالة)
SyntheticContentAttestation (رسالة)
SyntheticContentInfo (رسالة)
TargetCpa (رسالة)
TargetCpm (رسالة)
TargetImpressionShare (رسالة)
TargetOutrankShare (رسالة)
TargetRestriction (رسالة)
TargetRoas (رسالة)
TargetSpend (رسالة)
TargetingSetting (رسالة)
TextAsset (رسالة)
TextLabel (رسالة)
UnifiedCallAsset (رسالة)
UnifiedCalloutAsset (رسالة)
UnifiedLocationAsset (رسالة)
UnifiedPageFeedAsset (رسالة)
UnifiedSitelinkAsset (رسالة)
UserListInfo (رسالة)
Value (رسالة)
WebpageConditionInfo (رسالة)
WebpageInfo (رسالة)
YoutubeVideoAsset (رسالة)

AdScheduleInfo

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

يتم تحديد AdSchedule على أنّه يوم من الأسبوع وفاصل زمني سيتم عرض الإعلانات خلاله.

لا يمكن إضافة أكثر من ستة جداول إعلانية لليوم نفسه.

الحقول
`start_minute`	`MinuteOfHour` الدقائق بعد ساعة البدء التي يبدأ فيها هذا الجدول الزمني. هذا الحقل مطلوب لعمليات CREATE ومحظور في عمليات UPDATE.
`end_minute`	`MinuteOfHour` عدد الدقائق بعد ساعة الانتهاء التي ينتهي فيها هذا الجدول الزمني لا يشمل الجدول الزمني الدقيقة الأخيرة. هذا الحقل مطلوب لعمليات CREATE ومحظور في عمليات UPDATE.
`day_of_week`	`DayOfWeek` تمثّل هذه السمة يوم الأسبوع الذي ينطبق عليه الجدول الزمني. هذا الحقل مطلوب لعمليات CREATE ومحظور في عمليات UPDATE.
`start_hour`	`int32` ساعة البدء بتنسيق 24 ساعة يجب أن تتراوح القيمة في هذا الحقل بين 0 و23، بما في ذلك الرقمان. هذا الحقل مطلوب لعمليات CREATE ومحظور في عمليات UPDATE.
`end_hour`	`int32` ساعة الانتهاء بتنسيق 24 ساعة، حيث يشير الرقم 24 إلى نهاية اليوم يجب أن تتراوح القيمة في هذا الحقل بين 0 و24، بما في ذلك الرقمان. هذا الحقل مطلوب لعمليات CREATE ومحظور في عمليات UPDATE.

AdTextAsset

مادة عرض نصية مستخدَمة داخل إعلان

الحقول

الحقول
`text`	`string` نص مادة العرض

text

string

نص مادة العرض

AgeRangeInfo

معيار الفئة العمرية

الحقول

الحقول
`type`	`AgeRangeType` نوع الفئة العمرية.

type

AgeRangeType

نوع الفئة العمرية.

AssetInteractionTarget

تمثّل هذه السمة شريحة AssetInteractionTarget.

الحقول

الحقول
`asset`	`string` اسم مورد مادة العرض
`interaction_on_this_asset`	`bool` يتم استخدامها فقط مع مقاييس CustomerAsset وCampaignAsset وAdGroupAsset. تشير هذه السمة إلى ما إذا كانت مقاييس التفاعل قد حدثت على مادة العرض نفسها أو على مادة عرض أو وحدة إعلانية مختلفة.

asset

string

اسم مورد مادة العرض

interaction_on_this_asset

bool

يتم استخدامها فقط مع مقاييس CustomerAsset وCampaignAsset وAdGroupAsset. تشير هذه السمة إلى ما إذا كانت مقاييس التفاعل قد حدثت على مادة العرض نفسها أو على مادة عرض أو وحدة إعلانية مختلفة.

AssetUsage

تحتوي على معلومات استخدام مادة العرض.

الحقول

الحقول
`asset`	`string` اسم مصدر مادة العرض.
`served_asset_field_type`	`ServedAssetFieldType` نوع الحقل المعروض لمادة العرض.

asset

string

اسم مصدر مادة العرض.

served_asset_field_type

ServedAssetFieldType

نوع الحقل المعروض لمادة العرض.

AudienceInfo

معيار جمهور

الحقول

الحقول
`audience`	`string` اسم مورد الجمهور

audience

string

اسم مورد الجمهور

BusinessProfileLocation

تتم مزامنة بيانات الموقع الجغرافي للملف التجاري من حساب "الملف التجاري" المرتبط بحسابك.

الحقول

الحقول
`labels[]`	`string` تصنيف يحدّده المعلِن للموقع الجغرافي في حساب "الملف التجاري". تتم مزامنة هذه المعلومات من حساب "الملف التجاري".
`store_code`	`string` رمز المتجر في "الملف التجاري" لهذا الموقع الجغرافي تتم مزامنة هذه المعلومات من حساب "الملف التجاري".
`listing_id`	`int64` معرّف بطاقة بيانات هذا الموقع الجغرافي للملف التجاري تتم مزامنة هذه المعلومات من حساب "الملف التجاري" المرتبط بحسابك.

labels[]

string

تصنيف يحدّده المعلِن للموقع الجغرافي في حساب "الملف التجاري". تتم مزامنة هذه المعلومات من حساب "الملف التجاري".

store_code

string

رمز المتجر في "الملف التجاري" لهذا الموقع الجغرافي تتم مزامنة هذه المعلومات من حساب "الملف التجاري".

listing_id

int64

معرّف بطاقة بيانات هذا الموقع الجغرافي للملف التجاري تتم مزامنة هذه المعلومات من حساب "الملف التجاري" المرتبط بحسابك.

CallToActionAsset

مادة عرض عبارة تحث المستخدم على اتخاذ إجراء

الحقول

الحقول
`call_to_action`	`CallToActionType` عبارة تحث المستخدم على اتخاذ إجراء

call_to_action

CallToActionType

عبارة تحث المستخدم على اتخاذ إجراء

CustomParameter

عملية ربط يمكن استخدامها من خلال علامات المَعلمات المخصّصة في tracking_url_template أو final_urls أو mobile_final_urls

الحقول

الحقول
`key`	`string` المفتاح المطابق لاسم علامة المَعلمة
`value`	`string` القيمة المطلوب استبدالها.

key

string

المفتاح المطابق لاسم علامة المَعلمة

value

string

القيمة المطلوب استبدالها.

DeviceInfo

معيار جهاز

الحقول

الحقول
`type`	`Device` نوع الجهاز

type

Device

نوع الجهاز

EnhancedCpc

لا يتضمّن هذا النوع أي حقول.

استراتيجية عروض أسعار مُبرمَجة ترفع عروض الأسعار للنقرات التي يبدو أنّها أكثر عرضةً للإحالة الناجحة وتخفّضها للنقرات التي يبدو أنّها أقل عرضةً للإحالة الناجحة.

تم إيقاف استراتيجية عروض الأسعار هذه نهائيًا ولم يعُد من الممكن إنشاؤها. استخدِم ManualCpc مع ضبط enhanced_cpc_enabled على "صحيح" للحصول على وظائف مكافئة.

FinalAppUrl

عنوان URL للربط بصفحة معيّنة في تطبيق لنظام التشغيل المحدّد

الحقول

الحقول
`os_type`	`AppUrlOperatingSystemType` نظام التشغيل المستهدَف من خلال عنوان URL هذا. الحقل مطلوب.
`url`	`string` عنوان URL للرابط لصفحة في التطبيق تحدّد الروابط لصفحات في التطبيق موقعًا في التطبيق يتوافق مع المحتوى الذي تريد عرضه، ويجب أن تكون بالشكل {scheme}://{host_path} ويحدّد المخطط التطبيق الذي سيتم فتحه. بالنسبة إلى تطبيقك، يمكنك استخدام مخطط مخصّص يبدأ باسم التطبيق. يحدّد المضيف والمسار الموقع الجغرافي الفريد في التطبيق الذي يتوفّر فيه المحتوى. مثال: "exampleapp://productid_1234". الحقل مطلوب.

os_type

AppUrlOperatingSystemType

نظام التشغيل المستهدَف من خلال عنوان URL هذا. الحقل مطلوب.

url

string

عنوان URL للرابط لصفحة في التطبيق تحدّد الروابط لصفحات في التطبيق موقعًا في التطبيق يتوافق مع المحتوى الذي تريد عرضه، ويجب أن تكون بالشكل {scheme}://{host_path} ويحدّد المخطط التطبيق الذي سيتم فتحه. بالنسبة إلى تطبيقك، يمكنك استخدام مخطط مخصّص يبدأ باسم التطبيق. يحدّد المضيف والمسار الموقع الجغرافي الفريد في التطبيق الذي يتوفّر فيه المحتوى. مثال: "exampleapp://productid_1234". الحقل مطلوب.

FrequencyCapEntry

لا يتضمّن هذا النوع أي حقول.

قاعدة تحدّد الحدّ الأقصى لعدد المرات التي يمكن فيها عرض إعلان (أو مجموعة من الإعلانات) لمستخدم خلال فترة زمنية معيّنة.

GenderInfo

معيار الجنس

الحقول

الحقول
`type`	`GenderType` نوع الجنس

type

GenderType

نوع الجنس

ImageAsset

مادة عرض صورة

الحقول

الحقول
`mime_type`	`MimeType` نوع MIME لمادة عرض الصورة.
`full_size`	`ImageDimension` البيانات الوصفية لهذه الصورة بحجمها الأصلي
`file_size`	`int64` حجم ملف مادة عرض الصورة بالبايت.

mime_type

MimeType

نوع MIME لمادة عرض الصورة.

full_size

ImageDimension

البيانات الوصفية لهذه الصورة بحجمها الأصلي

file_size

int64

حجم ملف مادة عرض الصورة بالبايت.

ImageDimension

البيانات الوصفية لصورة بحجم معيّن، سواء كانت أصلية أو تم تغيير حجمها

الحقول

الحقول
`height_pixels`	`int64` ارتفاع الصورة
`width_pixels`	`int64` عرض الصورة
`url`	`string` عنوان URL يعرض الصورة بهذا الارتفاع والعرض

height_pixels

int64

ارتفاع الصورة

width_pixels

int64

عرض الصورة

url

string

عنوان URL يعرض الصورة بهذا الارتفاع والعرض

الكلمة الرئيسية

تمثّل هذه السمة جزءًا من معيار الكلمة الرئيسية.

الحقول

الحقول
`info`	`KeywordInfo` معلومات الكلمات الرئيسية
`ad_group_criterion`	`string` اسم مصدر AdGroupCriterion.

info

KeywordInfo

معلومات الكلمات الرئيسية

ad_group_criterion

string

اسم مصدر AdGroupCriterion.

KeywordInfo

معيار كلمة رئيسية

الحقول

الحقول
`match_type`	`KeywordMatchType` نوع مطابقة الكلمة الرئيسية.
`text`	`string` نص الكلمة الرئيسية (80 حرفًا و10 كلمات كحدّ أقصى)

match_type

KeywordMatchType

نوع مطابقة الكلمة الرئيسية.

text

string

نص الكلمة الرئيسية (80 حرفًا و10 كلمات كحدّ أقصى)

LanguageInfo

معيار اللغة

الحقول

الحقول
`language_constant`	`string` اسم مورد ثابت اللغة.

language_constant

string

اسم مورد ثابت اللغة.

ListingGroupInfo

معيار مجموعة بطاقات بيانات المتجر

الحقول

الحقول
`type`	`ListingGroupType` نوع مجموعة البيانات

type

ListingGroupType

نوع مجموعة البيانات

LocationGroupInfo

نطاق جغرافي حول قائمة بالمواقع الجغرافية المحدّدة من خلال خلاصة

الحقول
`geo_target_constants[]`	`string` ثوابت الاستهداف الجغرافي التي تقيّد نطاق المنطقة الجغرافية ضِمن الخلاصة. يُسمح حاليًا بثابت استهداف جغرافي واحد فقط.
`radius_units`	`LocationGroupRadiusUnits` تمثّل هذه السمة وحدة النطاق الجغرافي. يمكن استخدام الأميال والأمتار لثوابت الاستهداف الجغرافي. يمكن استخدام وحدتَي المتر والميل في مجموعات عناصر الخلاصة. هذا الحقل مطلوب ويجب ضبطه في عمليات CREATE.
`feed_item_sets[]`	`string` مجموعات عناصر الخلاصة التي تستهدف عناصر الخلاصة في حال تحديد أرقام تعريف متعدّدة، سيتم استهداف جميع العناصر التي تظهر في مجموعة واحدة على الأقل. لا يمكن استخدام هذا الحقل مع geo_target_constants. هذا الحقل اختياري ولا يمكن ضبطه إلا في عمليات CREATE.
`radius`	`int64` المسافة بالوحدات التي تحدّد النطاق الجغرافي حول المواقع الجغرافية المستهدَفة هذا الحقل مطلوب ويجب ضبطه في عمليات CREATE.

LocationInfo

تمثّل هذه السمة معيارًا للموقع الجغرافي.

الحقول

الحقول
`geo_target_constant`	`string` اسم مصدر ثابت الاستهداف الجغرافي

geo_target_constant

string

اسم مصدر ثابت الاستهداف الجغرافي

ManualCpa

لا يتضمّن هذا النوع أي حقول.

استراتيجية عروض أسعار يدوية تسمح للمعلِن بتحديد عرض السعر لكل إجراء يحدّده المعلِن.

ManualCpc

عروض الأسعار المستندة إلى النقرات يدويًا، حيث يدفع المستخدم مقابل كل نقرة

الحقول

الحقول
`enhanced_cpc_enabled`	`bool` تحديد ما إذا كان سيتم تحسين عروض الأسعار استنادًا إلى بيانات "مُحسِّن الإحالات الناجحة".

enhanced_cpc_enabled

bool

تحديد ما إذا كان سيتم تحسين عروض الأسعار استنادًا إلى بيانات "مُحسِّن الإحالات الناجحة".

ManualCpm

لا يتضمّن هذا النوع أي حقول.

عروض الأسعار اليدوية المستندة إلى مرات الظهور، حيث يدفع المستخدم مقابل كل ألف مرّة ظهور.

MaximizeConversionValue

استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أقصى قيمة للإحالات الناجحة في حملاتك في حدود ميزانيتك

الحقول

الحقول
`cpc_bid_ceiling_micros`	`int64` الحدّ الأقصى لعرض السعر الذي يمكن أن تحدّده استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يمكن تعديلها لاستراتيجيات المحفظة لعروض الأسعار فقط.
`cpc_bid_floor_micros`	`int64` الحدّ الأدنى لعرض السعر الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يمكن تعديلها لاستراتيجيات المحفظة لعروض الأسعار فقط.
`target_roas`	`double` خيار "عائد الإنفاق الإعلاني المستهدَف" في حال ضبطها، ستعمل استراتيجية عروض الأسعار على زيادة الأرباح إلى أقصى حدّ مع بلوغ متوسط عائد الإنفاق الإعلاني المستهدَف. إذا كان عائد الإنفاق الإعلاني المستهدَف مرتفعًا، قد لا تتمكّن استراتيجية عروض الأسعار من إنفاق الميزانية بالكامل. في حال عدم ضبط عائد الإنفاق الإعلاني المستهدَف، ستسعى استراتيجية عروض الأسعار إلى تحقيق أعلى عائد إنفاق إعلاني ممكن للميزانية.

cpc_bid_ceiling_micros

int64

الحدّ الأقصى لعرض السعر الذي يمكن أن تحدّده استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يمكن تعديلها لاستراتيجيات المحفظة لعروض الأسعار فقط.

cpc_bid_floor_micros

int64

الحدّ الأدنى لعرض السعر الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يمكن تعديلها لاستراتيجيات المحفظة لعروض الأسعار فقط.

target_roas

double

خيار "عائد الإنفاق الإعلاني المستهدَف" في حال ضبطها، ستعمل استراتيجية عروض الأسعار على زيادة الأرباح إلى أقصى حدّ مع بلوغ متوسط عائد الإنفاق الإعلاني المستهدَف. إذا كان عائد الإنفاق الإعلاني المستهدَف مرتفعًا، قد لا تتمكّن استراتيجية عروض الأسعار من إنفاق الميزانية بالكامل. في حال عدم ضبط عائد الإنفاق الإعلاني المستهدَف، ستسعى استراتيجية عروض الأسعار إلى تحقيق أعلى عائد إنفاق إعلاني ممكن للميزانية.

MaximizeConversions

استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد من الإحالات الناجحة لحملاتك في حدود ميزانيتك.

الحقول

الحقول
`cpc_bid_ceiling_micros`	`int64` الحدّ الأقصى لعرض السعر الذي يمكن أن تحدّده استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يمكن تعديلها لاستراتيجيات المحفظة لعروض الأسعار فقط.
`cpc_bid_floor_micros`	`int64` الحدّ الأدنى لعرض السعر الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يمكن تعديلها لاستراتيجيات المحفظة لعروض الأسعار فقط.
`target_cpa_micros`	`int64` خيار "سقف التكلفة المحدّد لكل إجراء" هذا هو متوسط المبلغ الذي تريد إنفاقه لكل إجراء إحالة ناجحة محدّد بوحدات صغيرة من عملة استراتيجية عروض الأسعار. في حال ضبطها، ستحصل استراتيجية عروض الأسعار على أكبر عدد ممكن من الإحالات الناجحة بسقف التكلفة المحدد لكل إجراء أو بتكلفة أقل منه. في حال عدم ضبط سقف التكلفة المحدّد لكل إجراء، ستسعى استراتيجية عروض الأسعار إلى تحقيق أدنى تكلفة ممكنة لكل إجراء في ضوء الميزانية.

cpc_bid_ceiling_micros

int64

cpc_bid_floor_micros

int64

target_cpa_micros

int64

خيار "سقف التكلفة المحدّد لكل إجراء" هذا هو متوسط المبلغ الذي تريد إنفاقه لكل إجراء إحالة ناجحة محدّد بوحدات صغيرة من عملة استراتيجية عروض الأسعار. في حال ضبطها، ستحصل استراتيجية عروض الأسعار على أكبر عدد ممكن من الإحالات الناجحة بسقف التكلفة المحدد لكل إجراء أو بتكلفة أقل منه. في حال عدم ضبط سقف التكلفة المحدّد لكل إجراء، ستسعى استراتيجية عروض الأسعار إلى تحقيق أدنى تكلفة ممكنة لكل إجراء في ضوء الميزانية.

المقاييس

بيانات المقاييس

الحقول
`all_conversions_value_by_conversion_date`	`double` تمثّل هذه السمة قيمة جميع الإحالات الناجحة. عند اختيار هذا العمود مع التاريخ، تعني القيم في عمود التاريخ تاريخ الإحالة الناجحة. تتوفّر تفاصيل عن أعمدة `by_conversion_date` في لمحة عن عمود "كلّ الإحالات الناجحة".
`all_conversions_by_conversion_date`	`double` إجمالي عدد التحويلات. ويشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمة include_in_conversions_metric. عند اختيار هذا العمود مع التاريخ، تعني القيم في عمود التاريخ تاريخ الإحالة الناجحة. تتوفّر تفاصيل عن أعمدة `by_conversion_date` في لمحة عن عمود "كلّ الإحالات الناجحة".
`conversion_custom_metrics[]`	`Value` مقاييس الإحالات الناجحة المخصّصة
`conversions_value_by_conversion_date`	`double` مجموع قيمة الإحالات الناجحة القابلة لتقديم عروض الأسعار حسب تاريخ الإحالة الناجحة. عند اختيار هذا العمود مع التاريخ، تعني القيم في عمود التاريخ تاريخ الإحالة الناجحة.
`conversions_by_conversion_date`	`double` مجموع الإحالات الناجحة حسب تاريخ الإحالة الناجحة لأنواع الإحالات الناجحة القابلة للمزايدة يمكن أن يكون كسريًا بسبب إعداد نماذج تحديد المصدر. عند اختيار هذا العمود مع التاريخ، تعني القيم في عمود التاريخ تاريخ الإحالة الناجحة.
`historical_creative_quality_score`	`QualityScoreBucket` تمثّل هذه السمة نقاط الجودة السابقة لتصميم الإعلان.
`historical_landing_page_quality_score`	`QualityScoreBucket` جودة تجربة الصفحة المقصودة للفترات السابقة
`historical_search_predicted_ctr`	`QualityScoreBucket` نسبة النقر إلى الظهور المتوقّعة في "بحث Google" للفترات السابقة
`interaction_event_types[]`	`InteractionEventType` أنواع التفاعلات المدفوعة والمجانية
`raw_event_conversion_metrics[]`	`Value` مقاييس الإحالات الناجحة للأحداث الأولية
`absolute_top_impression_percentage`	`double` "نسبة ظهور الإعلان في صدارة الصفحة على شبكة البحث" هي النسبة المئوية لمرات ظهور إعلانك في أبرز موضع على "شبكة البحث".
`all_conversions_from_interactions_rate`	`double` جميع الإحالات الناجحة الناتجة من التفاعلات (على عكس الإحالات الناجحة بعد رؤية الإعلان فقط) مقسومة على عدد التفاعلات مع الإعلانات
`all_conversions_value`	`double` تمثّل هذه السمة قيمة جميع الإحالات الناجحة.
`all_conversions`	`double` إجمالي عدد التحويلات. ويشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمة include_in_conversions_metric.
`all_conversions_value_per_cost`	`double` قيمة جميع الإحالات الناجحة مقسومة على التكلفة الإجمالية للتفاعلات مع الإعلانات (مثل النقرات على الإعلانات النصية أو مرات مشاهدة إعلانات الفيديو).
`all_conversions_from_click_to_call`	`double` عدد المرّات التي نقر فيها الأشخاص على زر "الاتصال" للاتصال بنشاط تجاري أثناء النقر على إعلان أو بعده ولا يشمل هذا العدد ما إذا كانت المكالمات قد تم تلقّيها أم لا، أو مدة أيٍّ منها. ينطبق هذا المقياس على عناصر الخلاصة فقط.
`all_conversions_from_directions`	`double` عدد المرّات التي نقر فيها المستخدمون على زر "الحصول على الاتجاهات" للانتقال إلى نشاط تجاري بعد النقر على إعلان. ينطبق هذا المقياس على عناصر الخلاصة فقط.
`all_conversions_from_interactions_value_per_interaction`	`double` قيمة جميع الإحالات الناجحة من التفاعلات مقسومة على إجمالي عدد التفاعلات
`all_conversions_from_menu`	`double` عدد المرّات التي نقر فيها الأشخاص على رابط لعرض قائمة مؤسسة بعد النقر على إعلان. ينطبق هذا المقياس على عناصر الخلاصة فقط.
`all_conversions_from_order`	`double` عدد المرّات التي قدَّم فيها الأشخاص طلبًا في مؤسسة بعد النقر على إعلان ينطبق هذا المقياس على عناصر الخلاصة فقط.
`all_conversions_from_other_engagement`	`double` عدد الإحالات الناجحة الأخرى (مثل، نشر مراجعة أو حفظ موقع جغرافي لمؤسسة) التي حدثت بعد نقر المستخدمين على إعلان. ينطبق هذا المقياس على عناصر الخلاصة فقط.
`all_conversions_from_store_visit`	`double` العدد المقدّر لمرّات زيارة المستخدمين لنشاط تجاري بعد النقر على إعلان ينطبق هذا المقياس على عناصر الخلاصة فقط.
`visits`	`double` النقرات التي سجّلتها "إعلانات شبكة البحث 360" بنجاح وأعادت توجيهها إلى الصفحة المقصودة للمعلِن
`all_conversions_from_store_website`	`double` عدد المرّات التي تمّ فيها توجيه الأشخاص إلى عنوان URL لنشاط تجاري بعد النقر على إعلان. ينطبق هذا المقياس على عناصر الخلاصة فقط.
`average_cost`	`double` متوسط المبلغ الذي تدفعه مقابل كل تفاعل. هذا المبلغ هو إجمالي تكلفة إعلاناتك مقسومًا على إجمالي عدد التفاعلات.
`average_cpc`	`double` التكلفة الإجمالية لجميع النقرات مقسومة على إجمالي عدد النقرات التي تم تلقّيها هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`average_cpm`	`double` متوسط التكلفة لكل ألف ظهور هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`clicks`	`int64` عدد النقرات
`content_budget_lost_impression_share`	`double` النسبة المئوية المقدَّرة لعدد المرّات التي كان فيها إعلانك مؤهَّلاً للظهور على "الشبكة الإعلانية" ولكنّه لم يظهر بسبب انخفاض ميزانيتك. ملاحظة: يتم تسجيل نسبة عدم ظهور الإعلان المفقودة بسبب ميزانية المحتوى في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.
`content_impression_share`	`double` يشير هذا المقياس إلى عدد مرّات الظهور التي سجَّلها إعلانك على "الشبكة الإعلانية" مقسومًا على العدد المقدَّر لمرّات الظهور التي كنت مؤهَّلاً للحصول عليها. ملاحظة: يتم عرض نسبة ظهور الإعلان في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.
`content_rank_lost_impression_share`	`double` النسبة المئوية المقدَّرة لمرّات الظهور على "الشبكة الإعلانية" التي لم تتلقّها إعلاناتك بسبب انخفاض ترتيب الإعلان. ملاحظة: يتم تسجيل نسبة عدم ظهور الإعلان المفقودة بسبب ترتيب المحتوى في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.
`conversions_from_interactions_rate`	`double` متوسّط الإحالات الناجحة القابلة للمزايدة (من التفاعل) لكل تفاعل مؤهَّل للإحالة الناجحة توضّح هذه السمة عدد المرات التي يؤدي فيها تفاعل مع الإعلان إلى إحالة ناجحة قابلة للمزايدة، في المتوسط.
`client_account_conversions_value`	`double` قيمة الإحالات الناجحة في حساب العميل لا يشمل ذلك إلا إجراءات الإحالات الناجحة التي تم ضبط سمة `include_in_client_account_conversions_metric` فيها على `true`. إذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
`conversions_value_per_cost`	`double` قيمة الإحالة الناجحة القابلة للمزايدة مقسومة على التكلفة الإجمالية للتفاعلات المؤهَّلة للإحالة الناجحة
`conversions_from_interactions_value_per_interaction`	`double` قيمة الإحالات الناجحة الناتجة من التفاعلات مقسومة على عدد التفاعلات مع الإعلانات لا يشمل ذلك إلا إجراءات الإحالات الناجحة التي تم ضبط سمة `include_in_conversions_metric` فيها على `true`. إذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
`client_account_conversions`	`double` عدد الإحالات الناجحة في حساب العميل لا يشمل ذلك إلا إجراءات الإحالات الناجحة التي تم ضبط سمة `include_in_client_account_conversions_metric` فيها على `true`. إذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
`cost_micros`	`int64` مجموع تكلفة النقرة (CPC) والتكلفة لكل ألف ظهور خلال هذه الفترة. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS لمزيد من التفاصيل.
`cost_per_all_conversions`	`double` تكلفة التفاعلات مع الإعلانات مقسومة على جميع الإحالات الناجحة
`cost_per_conversion`	`double` متوسط التكلفة المؤهّلة للإحالة الناجحة لكلّ إحالة ناجحة قابلة للمزايدة.
`cost_per_current_model_attributed_conversion`	`double` تكلفة التفاعلات مع الإعلانات مقسومة على الإحالات الناجحة التي تم تحديد مصدرها باستخدام النموذج الحالي لا يشمل ذلك إلا إجراءات الإحالات الناجحة التي تم ضبط سمة `include_in_conversions_metric` فيها على `true`. إذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
`cross_device_conversions`	`double` الإحالات الناجحة التي تحدث عندما ينقر أحد العملاء على إعلان على جهاز معيّن، ثمّ يُجري إحالة ناجحة على جهاز أو متصفّح آخر. يتمّ تضمين الإحالات الناجحة على جميع الأجهزة في `all_conversions`.
`cross_device_conversions_by_conversion_date`	`double` عدد الإحالات الناجحة على جميع الأجهزة حسب تاريخ الإحالة الناجحة. تتوفّر تفاصيل عن عمودَي `by_conversion_date` في المقالة لمحة عن عمود "كلّ الإحالات الناجحة".
`cross_device_conversions_value`	`double` مجموع قيمة الإحالات الناجحة على جميع الأجهزة
`cross_device_conversions_value_by_conversion_date`	`double` مجموع قيمة الإحالات الناجحة على جميع الأجهزة حسب تاريخ الإحالة الناجحة تتوفّر تفاصيل عن عمودَي `by_conversion_date` في المقالة لمحة عن عمود "كلّ الإحالات الناجحة".
`ctr`	`double` عدد النقرات التي يتلقّاها إعلانك (النقرات) مقسومًا على عدد مرات عرض إعلانك (مرات الظهور).
`conversions`	`double` عدد الإحالات الناجحة لا يشمل ذلك إلا إجراءات الإحالات الناجحة التي تم ضبط سمة include_in_conversions_metric فيها على "صحيح". إذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
`conversions_value`	`double` مجموع قيم الإحالات الناجحة المُضمّنة في حقل "الإحالات الناجحة" يُعدّ هذا المقياس مفيدًا فقط إذا أدخلت قيمة لإجراءات الإحالات الناجحة.
`average_quality_score`	`double` متوسط نقاط الجودة
`historical_quality_score`	`int64` تمثّل هذه السمة نقاط الجودة للفترات السابقة.
`impressions`	`int64` عدد مرّات ظهور إعلانك على صفحة نتائج بحث أو موقع إلكتروني على "شبكة Google"
`interaction_rate`	`double` عدد مرات تفاعل الأشخاص مع إعلانك بعد ظهوره لهم. وهو عدد التفاعلات مقسومًا على عدد مرّات عرض إعلانك.
`interactions`	`int64` عدد التفاعلات التفاعل هو الإجراء الأساسي الذي يتخذه المستخدم والمرتبط بأحد أشكال الإعلانات - النقرات للإعلانات النصية وإعلانات Shopping، ومرات مشاهدة إعلانات الفيديو، وما إلى ذلك.
`invalid_click_rate`	`double` النسبة المئوية للنقرات التي تمت فلترتها من إجمالي عدد النقرات (النقرات التي تمت فلترتها + النقرات التي لم تتم فلترتها) خلال الفترة المشمولة بالتقارير
`invalid_clicks`	`int64` عدد النقرات التي تعتبرها Google غير مشروعة ولا تحصّل رسومًا منك مقابلها
`general_invalid_click_rate`	`double` النسبة المئوية للنقرات التي تم استبعادها من إجمالي عدد النقرات (النقرات المستبعَدة + النقرات غير المستبعَدة) لأنّها نقرات غير صالحة عامة. هذه هي النقرات التي تعتبرها Google غير مشروعة ويتم رصدها من خلال وسائل الفلترة الروتينية (أي الزيارات المعروفة غير الصالحة لمراكز البيانات أو برامج التتبّع أو العناكب أو برامج الزحف الأخرى أو الأنماط غير المنتظمة وما إلى ذلك). ولا يتم تحميلك تكلفة هذه النقرات، ولا تؤثر في إحصاءات حسابك. اطّلِع على فلترة الزيارات غير الصالحة لضمان الجودة.
`general_invalid_clicks`	`int64` عدد النقرات غير الصالحة العامة هذه هي مجموعة فرعية من النقرات غير الصالحة التي يتم رصدها من خلال وسائل الفلترة الروتينية (مثل الزيارات المعروفة غير الصالحة لمراكز البيانات أو برامج التتبّع أو برامج العنكبوت أو برامج الزحف الأخرى أو الأنماط غير المنتظمة أو ما إلى ذلك). ولا يتم تحميلك تكلفة هذه النقرات، ولا تؤثر في إحصاءات حسابك. اطّلِع على فلترة الزيارات غير الصالحة لضمان الجودة.
`mobile_friendly_clicks_percentage`	`double` النسبة المئوية للنقرات على الأجهزة الجوّالة التي تؤدي إلى صفحة متوافقة مع الأجهزة الجوّالة
`search_absolute_top_impression_share`	`double` النسبة المئوية لمرّات ظهور إعلانات Shopping أو الإعلانات على شبكة البحث التي تظهر في أبرز مواضع Shopping. راجِع مقالة لمحة عن مقياسَي "إعلانات أعلى الصفحة" و"إعلانات الصدارة في أعلى الصفحة" للحصول على التفاصيل. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.
`search_budget_lost_absolute_top_impression_share`	`double` الرقم الذي يقدّر معدّل تكرار عدم ظهور إعلانك كأول إعلان بين إعلانات أعلى الصفحة في نتائج البحث بسبب انخفاض الميزانية. ملاحظة: يتمّ تسجيل "نسبة عدم ظهور الإعلان في صدارة الصفحة على شبكة البحث" (الميزانية) في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.
`search_budget_lost_impression_share`	`double` النسبة المئوية المقدَّرة لعدد المرّات التي كان فيها إعلانك مؤهَّلاً للظهور على "شبكة البحث" ولكنّه لم يظهر لأنّ ميزانيتك كانت منخفضة جدًا. ملاحظة: يتم عرض نسبة عدم ظهور الإعلان المفقودة في شبكة البحث بسبب الميزانية في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.
`search_budget_lost_top_impression_share`	`double` النسبة المئوية المقدَّرة لعدد المرّات التي لم يظهر فيها إعلانك بجانب أهم نتائج البحث المجاني بسبب انخفاض الميزانية. ملاحظة: يتمّ تسجيل "نسبة عدم ظهور الإعلان في أعلى الصفحة على شبكة البحث" (الميزانية) في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.
`search_click_share`	`double` عدد النقرات التي تلقّيتها على "شبكة البحث" مقسومًا على العدد المقدَّر للنقرات التي كنت مؤهَّلاً للحصول عليها ملاحظة: يتم تسجيل نسبة النقر على الإعلان في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.
`search_exact_match_impression_share`	`double` عدد مرّات الظهور التي حصلت عليها مقسومًا على العدد المقدَّر لمرّات الظهور التي كنت مؤهّلاً للحصول عليها في "شبكة البحث" عن عبارات البحث التي تطابقت تمامًا مع كلماتك الرئيسية (أو كانت عبارة عن صيغ قريبة لكلمتك الرئيسية)، بغض النظر عن أنواع مطابقة كلماتك الرئيسية. ملاحظة: يتم تسجيل نسبة ظهور الإعلان بمطابقة تامة في شبكة البحث في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.
`search_impression_share`	`double` يشير هذا المقياس إلى عدد مرّات الظهور التي سجَّلها إعلانك على "شبكة البحث" مقسومًا على العدد المقدَّر لمرّات الظهور التي كنت مؤهَّلاً للحصول عليها. ملاحظة: يتمّ تسجيل نسبة ظهور الإعلان في البحث في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.
`search_rank_lost_absolute_top_impression_share`	`double` الرقم الذي يقدِّر معدّل تكرار عدم ظهور إعلانك كأول إعلان بين إعلانات أعلى الصفحة في نتائج البحث بسبب انخفاض ترتيب الإعلان. ملاحظة: يتم عرض "نسبة عدم ظهور الإعلان في صدارة الصفحة على شبكة البحث" (الترتيب) في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.
`search_rank_lost_impression_share`	`double` النسبة المئوية المقدَّرة لمرّات الظهور على "شبكة البحث" التي لم تحصل عليها إعلاناتك بسبب انخفاض ترتيب الإعلان. ملاحظة: يتم عرض نسبة عدم ظهور الإعلان على شبكة البحث (الترتيب) في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.
`search_rank_lost_top_impression_share`	`double` الرقم الذي يقدّر معدّل تكرار عدم ظهور إعلانك بجانب أهم نتائج البحث المجاني بسبب انخفاض ترتيب الإعلان. ملاحظة: يتمّ تسجيل "نسبة عدم ظهور الإعلان في أعلى الصفحة على شبكة البحث" في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.
`search_top_impression_share`	`double` عدد مرات الظهور التي تلقّاها إعلانك بين الإعلانات في أعلى الصفحة مقارنةً بالعدد المقدَّر لمرات الظهور التي كان إعلانك مؤهَّلاً للحصول عليها ليُعرض بين الإعلانات في أعلى الصفحة ملاحظة: يتمّ تسجيل "نسبة ظهور الإعلان في أعلى الصفحة على شبكة البحث" في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999. بشكل عام، تظهر الإعلانات في أعلى الصفحة فوق أهم نتائج البحث المجاني. ومع ذلك، قد تظهر هذه الإعلانات أسفل أهم نتائج البحث المجاني في طلبات بحث معيّنة.
`top_impression_percentage`	`double` هي النسبة المئوية لمرات ظهور إعلانك بجانب أهم نتائج البحث المجاني.
`value_per_all_conversions`	`double` قيمة جميع الإحالات الناجحة مقسومة على عدد جميع الإحالات الناجحة
`value_per_all_conversions_by_conversion_date`	`double` قيمة جميع الإحالات الناجحة مقسومة على عدد جميع الإحالات الناجحة عند اختيار هذا العمود مع التاريخ، تعني القيم في عمود التاريخ تاريخ الإحالة الناجحة. تتوفّر تفاصيل عن أعمدة `by_conversion_date` في لمحة عن عمود "كلّ الإحالات الناجحة".
`value_per_conversion`	`double` قيمة الإحالة الناجحة القابلة للمزايدة مقسومةً على عدد الإحالات الناجحة القابلة للمزايدة تعرِض هذه السمة متوسط قيمة كل إحالة ناجحة يمكن تقديم عروض أسعار لها.
`value_per_conversions_by_conversion_date`	`double` قيمة الإحالات الناجحة القابلة لتقديم عروض الأسعار حسب تاريخ الإحالة الناجحة مقسومة على الإحالات الناجحة القابلة لتقديم عروض الأسعار حسب تاريخ الإحالة الناجحة تعرِض هذه السمة متوسط قيمة كل إحالة ناجحة قابلة للمزايدة (حسب تاريخ الإحالة الناجحة). عند اختيار هذا العمود مع التاريخ، تعني القيم في عمود التاريخ تاريخ الإحالة الناجحة.
`client_account_view_through_conversions`	`int64` إجمالي عدد الإحالات الناجحة بعد رؤية الإعلان فقط. تحدث هذه الإحالات عندما يرى العميل إعلانًا يتضمّن صورة أو إعلان وسائط تفاعلية متقدّمة، ثمّ يُكمل لاحقًا إحالة ناجحة على موقعك الإلكتروني بدون التفاعل مع إعلان آخر (مثل النقر عليه).
`orders`	`double` تشير "الطلبات" إلى إجمالي عدد إحالاتك الناجحة المتمثّلة بعملية شراء، والتي يعود مصدرها إلى إعلاناتك. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. ويتم احتساب الإحالة الناجحة كطلب، إذا كان مصدرها يعود إلى التفاعلات السابقة مع إعلاناتك (النقرات على الإعلانات النصية أو إعلانات Shopping، ومرات مشاهدة إعلانات الفيديو، وما إلى ذلك). مثال: نقر شخص ما على إعلان Shopping يعرض قبّعة، ثم اشترى هذا الشخص القبّعة نفسها مع قميص باستخدام طلب على موقعك الإلكتروني. مع أنّه اشترى منتجَين، سيتم احتساب هذه الإحالة الناجحة كطلب واحد. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`average_order_value_micros`	`int64` متوسّط قيمة طلب الشراء هو متوسّط الإيرادات التي حقّقتها لكلّ طلب منسوب إلى إعلاناتك. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. متوسّط قيمة طلب الشراء هو إجمالي الإيرادات من طلباتك مقسومًا على إجمالي عدد الطلبات. مثال: تلقّيت 3 طلبات حقّقت إيرادات بقيمة 10 دولار أمريكي و15 دولار أمريكي و20 دولار أمريكي. متوسّط قيمة طلب الشراء هو 15 دولارًا أمريكيًا = (10 دولارات أمريكية + 15 دولارًا أمريكيًا + 20 دولارًا أمريكيًا)/3. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`average_cart_size`	`double` متوسّط حجم سلّة التسوّق هو متوسّط عدد المنتجات في كلّ طلب منسوب إلى إعلاناتك. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. متوسّط حجم سلّة التسوّق هو إجمالي عدد المنتجات المُباعة مقسومًا على إجمالي عدد الطلبات التي تلقّيتها. مثال: تلقّيت طلبَين، تضمّن الطلب الأوّل 3 منتجات والطلب الثاني منتجَين. يبلغ متوسّط حجم سلة التسوّق 2.5 منتج = (3+2)/2. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`cost_of_goods_sold_micros`	`int64` تكلفة السلع المُباعة هي إجمالي تكلفة المنتجات التي بِعتها في الطلبات المنسوبة إلى إعلاناتك. طريقة العمل: يمكنك إضافة تكلفة السلع المُباعة إلى كلّ منتج في Merchant Center. وفي حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق، ستتمّ مطابقة المنتجات التي تم بيعها مع قيمة تكلفة السلع المُباعة، ومن ثمَّ يمكن احتساب الأرباح الإجمالية التي حقّقتها لكلّ طلب. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة لهذا الطلب 8 دولار أمريكي = 3 دولار أمريكي + 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`gross_profit_micros`	`int64` الأرباح الإجمالية هي الربح الذي تحقّقه من الطلبات المنسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منه. طريقة العمل: الأرباح الإجمالية هي الأرباح التي تحقّقها من المبيعات التي يعود مصدرها إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. لا تتضمّن العمليات الحسابية للأرباح الإجمالية سوى المنتجات التي يكون لها قيمة تكلفة سلع مُباعة في Merchant Center. مثال: نقر شخص ما على إعلان Shopping يعرِض قبّعة، ثمّ اشترى القبّعة نفسها مع قميص من خلال طلب على موقعك الإلكتروني. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ قيمة تكلفة السلع المُباعة للقبّعة ‏$3، لكنّ القميص ليس له أيّ قيمة تكلفة للسلع المُباعة. ولن تأخذ الأرباح الإجمالية لهذا الطلب في الاعتبار سوى القبّعة، لذا سيكون المبلغ 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`gross_profit_margin`	`double` هامش الربح الإجمالي هو النسبة المئوية لإجمالي الربح الذي حقّقته من الطلبات المنسوبة إلى إعلاناتك، بعد خصم تكلفة السلع المُباعة. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. هامش الربح الإجمالي هو إجمالي الأرباح التي حقّقتها بعد قسمته على إجمالي الإيرادات وضربه في %100. لا تتضمّن العمليات الحسابية لهوامش الربح الإجمالية سوى المنتجات التي يكون لها قيمة تكلفة سلع مُباعة في Merchant Center. مثال: اشترى شخص ما قبّعة وقميصًا من خلال طلب على موقعك الإلكتروني. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ويبلغ سعر القميص 20 دولار أمريكي، ولكن ليس له قيمة تكلفة سلع مُباعة. لن يأخذ هامش الربح الإجمالي لهذا الطلب في الاعتبار سوى القبعة لأنّ لها قيمة تكلفة سلع مُباعة، وبذلك تكون النسبة% 70 = (10 دولار أمريكي - 3 دولار أمريكي)/10 دولار أمريكي × %100. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`revenue_micros`	`int64` الأرباح هي إجمالي المبلغ الذي تكسبه من الطلبات التي يكون مصدرها إعلاناتك. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. الأرباح هي القيمة الإجمالية لجميع الطلبات التي تلقّيتها والتي يكون مصدرها إعلاناتك، بعد طرح أيّ خصم. مثال: نقر شخص ما على إعلان Shopping يعرِض قبّعة، ثمّ اشترى القبّعة نفسها مع قميص من خلال طلب على موقعك الإلكتروني. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. يتم تطبيق خصم بقيمة 5 دولار أمريكي على الطلب بكامله. تبلغ الأرباح من هذا الطلب 25 دولار أمريكي = 10 دولار أمريكي + 20 دولار أمريكي - 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`units_sold`	`double` الوحدات المُباعة هي إجمالي عدد المنتجات المُباعة من الطلبات التي يعود مصدرها إلى إعلاناتك. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. الوحدات المُباعة هي إجمالي عدد المنتجات المُباعة من جميع الطلبات التي يعود مصدرها إلى إعلاناتك. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة في هذا الطلب هي 3. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`client_account_cross_sell_cost_of_goods_sold_micros`	`int64` تكلفة السلع المُباعة من خلال بيع منتجات إضافية في حساب العميل هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً للإعلان عن منتج مختلف. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. بناءً على ما سبق، تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`cross_sell_cost_of_goods_sold_micros`	`int64` تكلفة السلع المُباعة من خلال بيع منتجات إضافية (COGS) هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً لإعلان عن منتج مختلف. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. بناءً على ما سبق، تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`client_account_cross_sell_gross_profit_micros`	`int64` الأرباح الإجمالية من بيع منتجات إضافية في حساب العميل هي الأرباح التي حقّقتها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`cross_sell_gross_profit_micros`	`int64` الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي تحقّقها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`client_account_cross_sell_revenue_micros`	`int64` إيرادات بيع المنتجات الإضافية في حساب العميل هي إجمالي المبلغ الذي حقّقته من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`cross_sell_revenue_micros`	`int64` الأرباح من بيع المنتجات الإضافية هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`client_account_cross_sell_units_sold`	`double` الوحدات المُباعة من خلال بيع منتجات إضافية في حساب العميل هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة الإعلان عن منتج آخر. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الوحدات المُباعة من خلال بيع منتجات إضافية هي إجمالي عدد المنتجات التي تمّ بيعها من خلال جميع الطلبات المنسوبة إلى إعلاناتك. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. عدد الوحدات المُباعة من خلال بيع منتجات إضافية في هذا الطلب هو وحدتان. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`cross_sell_units_sold`	`double` الوحدات المُباعة من خلال بيع منتجات إضافية هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة الإعلان عن منتج آخر. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الوحدات المُباعة من خلال بيع منتجات إضافية هي إجمالي عدد المنتجات التي تمّ بيعها من خلال جميع الطلبات المنسوبة إلى إعلاناتك. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. عدد الوحدات المُباعة من خلال بيع منتجات إضافية في هذا الطلب هو وحدتان. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`client_account_lead_cost_of_goods_sold_micros`	`int64` تكلفة السلع المُباعة للعملاء المحتملِين في حساب العميل هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ احتساب تكلفة هذه السلع ضمن تكلفة السلع المُباعة للعملاء المحتملِين. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`lead_cost_of_goods_sold_micros`	`int64` تكلفة السلع المُباعة للعملاء المحتملِين هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ احتساب تكلفة هذه السلع ضمن تكلفة السلع المُباعة للعملاء المحتملِين. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`client_account_lead_gross_profit_micros`	`int64` الأرباح الإجمالية من العملاء المحتملِين في حساب العميل هي الأرباح التي حقّقتها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد خصم تكلفة السلع المُباعة. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`lead_gross_profit_micros`	`int64` الأرباح الإجمالية من العملاء المحتملِين هي الأرباح التي تحقِقّها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`client_account_lead_revenue_micros`	`int64` الإيرادات من العملاء المهتمين في حساب العميل هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الإيرادات من العملاء المحتملين لهذا الطلب 10 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`lead_revenue_micros`	`int64` الأرباح من العملاء المحتملِين هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الإيرادات من العملاء المحتملين لهذا الطلب 10 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة `metrics_currency` في عبارة PARAMETERS.
`client_account_lead_units_sold`	`double` الوحدات المُباعة للعملاء المحتملِين في حساب العميل هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة للإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمنتجات المُباعة، يظهر إجمالي عدد هذه المنتجات المُباعة ضمن "الوحدات المُباعة للعملاء المحتملِين". مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة للعملاء المحتملِين في هذا الطلب هي 1. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`lead_units_sold`	`double` الوحدات المُباعة للعملاء المحتملِين هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة للإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمنتجات المُباعة، يظهر إجمالي عدد هذه المنتجات المُباعة ضمن "الوحدات المُباعة للعملاء المحتملِين". مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة للعملاء المحتملِين في هذا الطلب هي 1. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`unique_users`	`int64` عدد المستخدمين الفرديين الذين شاهدوا إعلانك خلال الفترة الزمنية المطلوبة لا يمكن تجميع هذا المقياس، ويمكن طلبه فقط للنطاقات الزمنية التي تبلغ 92 يومًا أو أقل. يتوفّر هذا المقياس لأنواع الحملات التالية: "الحملات على الشبكة الإعلانية" و"حملات الفيديو" و"الحملات أثناء التصفّح" و"حملات التطبيقات".
`average_impression_frequency_per_user`	`double` متوسط عدد المرات التي شاهد فيها مستخدم فريد إعلانك خلال الفترة الزمنية المطلوبة. لا يمكن تجميع هذا المقياس، ويمكن طلبه فقط للنطاقات الزمنية التي تبلغ 92 يومًا أو أقل. يتوفّر هذا المقياس لأنواع الحملات التالية: "الحملات على الشبكة الإعلانية" و"حملات الفيديو" و"الحملات أثناء التصفّح" و"حملات التطبيقات".

MobileAppAsset

مادة عرض تمثّل تطبيقًا على الأجهزة الجوّالة.

الحقول

الحقول
`app_id`	`string` الحقل مطلوب. سلسلة تحدّد تطبيقًا على الأجهزة الجوّالة بشكلٍ فريد. يجب أن يحتوي فقط على المعرّف الأصلي للنظام الأساسي، مثل "com.android.ebay" لنظام Android أو "12345689" لنظام iOS.
`app_store`	`MobileAppVendor` الحقل مطلوب. متجر التطبيقات الذي يوزّع هذا التطبيق تحديدًا

app_id

string

الحقل مطلوب. سلسلة تحدّد تطبيقًا على الأجهزة الجوّالة بشكلٍ فريد. يجب أن يحتوي فقط على المعرّف الأصلي للنظام الأساسي، مثل "com.android.ebay" لنظام Android أو "12345689" لنظام iOS.

app_store

MobileAppVendor

الحقل مطلوب. متجر التطبيقات الذي يوزّع هذا التطبيق تحديدًا

PercentCpc

استراتيجية عروض أسعار تكون فيها عروض الأسعار جزءًا من السعر المُعلن عنه لبعض السلع أو الخدمات

الحقول

الحقول
`cpc_bid_ceiling_micros`	`int64` الحدّ الأقصى لعرض السعر الذي يمكن أن تحدّده استراتيجية عروض الأسعار هذا حقل اختياري يُدخله المعلِن ويتم تحديده في المواقع الجغرافية الصغيرة المحلية. ملاحظة: يتم تفسير القيمة الصفرية بالطريقة نفسها التي يتم بها تفسير bid_ceiling غير المحدّدة.
`enhanced_cpc_enabled`	`bool` تعدّل عرض السعر لكل مزاد بالزيادة أو النقصان، استنادًا إلى احتمال إتمام إحالة ناجحة. قد تتجاوز عروض الأسعار الفردية قيمة cpc_bid_ceiling_micros، ولكن يجب ألا يتجاوز متوسط مبلغ عرض السعر لإحدى الحملات هذه القيمة.

cpc_bid_ceiling_micros

int64

الحدّ الأقصى لعرض السعر الذي يمكن أن تحدّده استراتيجية عروض الأسعار هذا حقل اختياري يُدخله المعلِن ويتم تحديده في المواقع الجغرافية الصغيرة المحلية. ملاحظة: يتم تفسير القيمة الصفرية بالطريقة نفسها التي يتم بها تفسير bid_ceiling غير المحدّدة.

enhanced_cpc_enabled

bool

تعدّل عرض السعر لكل مزاد بالزيادة أو النقصان، استنادًا إلى احتمال إتمام إحالة ناجحة. قد تتجاوز عروض الأسعار الفردية قيمة cpc_bid_ceiling_micros، ولكن يجب ألا يتجاوز متوسط مبلغ عرض السعر لإحدى الحملات هذه القيمة.

RealTimeBiddingSetting

إعدادات "عروض الأسعار في الوقت الفعلي"، وهي ميزة متاحة فقط للحملات التي تستهدف شبكة Ad Exchange

الحقول

الحقول
`opt_in`	`bool` تُستخدَم لتحديد ما إذا كانت الحملة مفعَّلة لعروض الأسعار في الوقت الفعلي.

opt_in

bool

تُستخدَم لتحديد ما إذا كانت الحملة مفعَّلة لعروض الأسعار في الوقت الفعلي.

SearchAds360ExpandedDynamicSearchAdInfo

إعلان ديناميكي موسّع على شبكة البحث

الحقول

الحقول
`description1`	`string` السطر الأول من وصف الإعلان
`description2`	`string` السطر الثاني من وصف الإعلان.
`ad_tracking_id`	`int64` رقم تعريف تتبُّع الإعلان.

description1

string

السطر الأول من وصف الإعلان

description2

string

السطر الثاني من وصف الإعلان.

ad_tracking_id

int64

رقم تعريف تتبُّع الإعلان.

SearchAds360ExpandedTextAdInfo

إعلان نصي موسّع على "إعلانات شبكة البحث 360" تم إيقاف الإعلانات النصية الموسَّعة نهائيًا. استخدِم SearchAds360ResponsiveSearchAd بدلاً من ذلك.

الحقول
`headline`	`string` عنوان الإعلان.
`headline2`	`string` تمثّل هذه السمة العنوان الثاني للإعلان.
`headline3`	`string` تمثّل هذه السمة العنوان الثالث للإعلان.
`description1`	`string` السطر الأول من وصف الإعلان
`description2`	`string` السطر الثاني من وصف الإعلان.
`path1`	`string` النص الذي يتم إلحاقه بعنوان URL المرئي الذي تم إنشاؤه تلقائيًا باستخدام محدِّد
`path2`	`string` نص مُلحق بـ path1 مع محدد
`ad_tracking_id`	`int64` رقم تعريف تتبُّع الإعلان.

SearchAds360ProductAdInfo

لا يتضمّن هذا النوع أي حقول.

إعلان عن منتج في "إعلانات شبكة البحث 360"

SearchAds360ResponsiveSearchAdInfo

إعلان متجاوب على شبكة البحث في "إعلانات شبكة البحث 360"

الحقول
`headlines[]`	`AdTextAsset` قائمة بمواد العرض النصية للعناوين عند عرض الإعلان، سيتم اختيار العناوين من هذه القائمة.
`descriptions[]`	`AdTextAsset` قائمة بمواد العرض النصية الخاصة بالأوصاف عند عرض الإعلان، سيتم اختيار الأوصاف من هذه القائمة.
`path1`	`string` النص الذي يتم إلحاقه بعنوان URL المرئي الذي تم إنشاؤه تلقائيًا باستخدام محدِّد
`path2`	`string` نص مُلحق بـ path1 مع محدد
`ad_tracking_id`	`int64` رقم تعريف تتبُّع الإعلان.

SearchAds360TextAdInfo

إعلان نصي على "إعلانات شبكة البحث 360"

الحقول
`headline`	`string` عنوان الإعلان.
`description1`	`string` السطر الأول من وصف الإعلان
`description2`	`string` السطر الثاني من وصف الإعلان.
`display_url`	`string` عنوان URL المعروض للإعلان
`display_mobile_url`	`string` عنوان URL المعروض للإعلان على الأجهزة الجوّالة
`ad_tracking_id`	`int64` رقم تعريف تتبُّع الإعلان.

الشرائح

حقول الشرائح فقط

الحقول
`ad_format_type`	`AdFormatType` نوع شكل الإعلان
`ad_network_type`	`AdNetworkType` نوع شبكة الإعلانات
`conversion_action_category`	`ConversionActionCategory` فئة إجراء الإحالة الناجحة
`conversion_custom_dimensions[]`	`Value` سمات الإحالة الناجحة المخصّصة
`day_of_week`	`DayOfWeek` يوم من الأسبوع، على سبيل المثال، الاثنين
`device`	`Device` الجهاز الذي تنطبق عليه المقاييس
`keyword`	`Keyword` معيار الكلمة الرئيسية
`product_channel`	`ProductChannel` قناة المنتج
`product_channel_exclusivity`	`ProductChannelExclusivity` تُستخدَم لتحديد ما إذا كان المنتج متوفّرًا حصريًا على قناة معيّنة.
`product_condition`	`ProductCondition` تمثّل هذه السمة حالة المنتج.
`product_sold_condition`	`ProductCondition` تمثّل هذه السمة حالة المنتج المباع.
`raw_event_conversion_dimensions[]`	`Value` سمات الإحالات الناجحة على مستوى الحدث الأولية
`conversion_action`	`string` اسم مورد إجراء الإحالة الناجحة.
`conversion_action_name`	`string` اسم إجراء الإحالة الناجحة.
`date`	`string` التاريخ الذي تنطبق عليه المقاييس، بالتنسيق yyyy-MM-dd، مثلاً ‎2018-04-17
`geo_target_city`	`string` اسم المورد لثابت الاستهداف الجغرافي الذي يمثّل مدينة.
`geo_target_country`	`string` اسم المورد لثابت الاستهداف الجغرافي الذي يمثّل بلدًا
`geo_target_metro`	`string` اسم المورد لثابت الاستهداف الجغرافي الذي يمثّل مدينة كبرى
`geo_target_postal_code`	`string` اسم المورد لثابت الاستهداف الجغرافي الذي يمثّل رمزًا بريديًا.
`geo_target_region`	`string` اسم المورد لثابت الاستهداف الجغرافي الذي يمثّل منطقة
`hour`	`int32` ساعة اليوم كعدد بين 0 و23، شاملة.
`month`	`string` الشهر كما هو ممثّل بتاريخ اليوم الأول من الشهر يجب أن يكون التنسيق yyyy-MM-dd.
`product_bidding_category_level1`	`string` فئة عروض الأسعار (المستوى 1) للمنتج.
`product_bidding_category_level2`	`string` فئة عروض الأسعار (المستوى 2) للمنتج.
`product_bidding_category_level3`	`string` فئة عروض الأسعار (المستوى 3) للمنتج.
`product_bidding_category_level4`	`string` فئة عروض الأسعار (المستوى 4) للمنتج.
`product_bidding_category_level5`	`string` فئة عروض الأسعار (المستوى 5) للمنتج.
`product_brand`	`string` تمثّل هذه السمة العلامة التجارية للمنتج.
`product_country`	`string` اسم مصدر ثابت الاستهداف الجغرافي لبلد بيع المنتج.
`product_custom_attribute0`	`string` السمة المخصّصة 0 للمنتج.
`product_custom_attribute1`	`string` السمة المخصّصة 1 للمنتج.
`product_custom_attribute2`	`string` السمة المخصّصة 2 للمنتج
`product_custom_attribute3`	`string` السمة المخصّصة 3 للمنتج
`product_custom_attribute4`	`string` السمة المخصّصة 4 للمنتج
`product_item_id`	`string` معرّف السلعة للمنتج.
`product_language`	`string` اسم المورد لثابت اللغة الذي يمثّل لغة المنتج.
`product_sold_bidding_category_level1`	`string` فئة عروض الأسعار (المستوى 1) للمنتج المُباع.
`product_sold_bidding_category_level2`	`string` فئة عروض الأسعار (المستوى 2) للمنتج المُباع
`product_sold_bidding_category_level3`	`string` فئة عروض الأسعار (المستوى 3) للمنتج المُباع
`product_sold_bidding_category_level4`	`string` فئة عروض الأسعار (المستوى 4) للمنتج المُباع
`product_sold_bidding_category_level5`	`string` فئة عروض الأسعار (المستوى 5) للمنتج المُباع.
`product_sold_brand`	`string` تمثّل هذه السمة العلامة التجارية للمنتج المباع.
`product_sold_custom_attribute0`	`string` السمة المخصّصة 0 للمنتج المُباع.
`product_sold_custom_attribute1`	`string` السمة المخصّصة 1 للمنتج المُباع.
`product_sold_custom_attribute2`	`string` السمة المخصّصة 2 للمنتج المُباع.
`product_sold_custom_attribute3`	`string` السمة المخصّصة 3 للمنتج المُباع.
`product_sold_custom_attribute4`	`string` السمة المخصّصة 4 للمنتج المُباع.
`product_sold_item_id`	`string` معرّف السلعة للمنتج المُباع.
`product_sold_title`	`string` عنوان المنتج المُباع.
`product_sold_type_l1`	`string` نوع المنتج المُباع (المستوى 1)
`product_sold_type_l2`	`string` نوع المنتج المُباع (المستوى 2)
`product_sold_type_l3`	`string` نوع المنتج المُباع (المستوى 3)
`product_sold_type_l4`	`string` نوع المنتج المُباع (المستوى 4)
`product_sold_type_l5`	`string` نوع المنتج المُباع (المستوى 5)
`product_store_id`	`string` معرّف المنتج في المتجر
`product_title`	`string` تمثّل هذه السمة عنوان المنتج.
`product_type_l1`	`string` نوع المنتج (المستوى 1)
`product_type_l2`	`string` نوع المنتج (المستوى 2)
`product_type_l3`	`string` نوع المنتج (المستوى 3)
`product_type_l4`	`string` نوع المنتج (المستوى 4)
`product_type_l5`	`string` تمثّل هذه السمة نوع المنتج (المستوى 5).
`quarter`	`string` الربع كما هو ممثّل بتاريخ اليوم الأول من الربع يستخدم السنة التقويمية للأرباع، على سبيل المثال، يبدأ الربع الثاني من عام 2018 في 2018-04-01. يجب أن يكون التنسيق yyyy-MM-dd.
`vertical_ads_event_participant_display_names`	`string` تمثّل هذه السمة الأسماء المعروضة للمشاركين في بطاقة بيانات الفعالية، مثل المؤدين أو المتحدثين أو الفرق.
`vertical_ads_hotel_class`	`int64` فئة الفندق يتراوح عادةً بين نجمة واحدة و5 نجوم، ولكن يمكن تخصيصه بالكامل في خلاصة الفندق.
`vertical_ads_listing`	`string` البيانات المرتبطة بمرّة ظهور أو نقرة أو إحالة ناجحة خاصة ببيانات محلية
`vertical_ads_listing_brand`	`string` تمثّل هذه السمة العلامة التجارية المرتبطة ببطاقة بيانات معيّنة ضمن سياق "الإعلانات العمودية"، مثل العلامة التجارية لخدمة استئجار السيارات أو مكان مخصّص للاستئجار أو فعالية.
`vertical_ads_listing_city`	`string` المدينة التي يقع فيها إدراج الإعلانات العمودية
`vertical_ads_listing_country`	`string` البلد الذي يقع فيه إدراج الإعلانات العمودية.
`vertical_ads_listing_region`	`string` المنطقة التي يقع فيها إدراج الإعلانات العمودية
`vertical_ads_partner_account`	`int64` حساب شريك معيّن ضمن "مركز الشركاء" (على سبيل المثال، "مركز إدارة معلومات الفنادق") يوفّر بيانات خلاصة المستودع الإعلاني لـ "الإعلانات العمودية".
`vertical_ads_vertical`	`VerticalAdsItemVerticalType` نوع الإعلان الخاص بفئة معيّنة، مثل "أماكن للاستئجار" أو "تأجير السيارات" أو "الفعاليات"، ويُستخدم لتصنيف البيانات وتقسيمها في سياق "الإعلانات الخاصة بفئة معيّنة"
`week`	`string` الأسبوع هو الفترة من الاثنين إلى الأحد، ويتم تمثيله بتاريخ يوم الاثنين. يجب أن يكون التنسيق yyyy-MM-dd.
`year`	`int32` السنة، بتنسيق yyyy
`asset_interaction_target`	`AssetInteractionTarget` يتم استخدامها فقط مع مقاييس CustomerAsset وCampaignAsset وAdGroupAsset. تشير هذه السمة إلى ما إذا كانت مقاييس التفاعل قد حدثت على مادة العرض نفسها أو على مادة عرض أو وحدة إعلانية مختلفة. يتم احتساب التفاعلات (مثل النقرات) في جميع أجزاء الإعلان المعروض (مثل الإعلان نفسه والمكوّنات الأخرى، مثل روابط أقسام الموقع) عندما يتم عرضها معًا. عندما تكون قيمة interaction_on_this_asset صحيحة، يعني ذلك أنّ التفاعلات تتم على مادة العرض المحدّدة هذه، وعندما تكون القيمة خاطئة، يعني ذلك أنّ التفاعلات لا تتم على مادة العرض المحدّدة هذه، بل على أجزاء أخرى من الإعلان المعروض الذي يتم عرض مادة العرض هذه معه.

SyntheticContentAttestation

تمثّل هذه السمة شهادة بشأن المحتوى الاصطناعي من مصدر واحد.

الحقول

الحقول
`status`	`SyntheticContentAttestationStatus` تُستخدَم لتحديد ما إذا كان المصدر يعتبر المحتوى اصطناعيًا.
`source`	`SyntheticContentSource` تمثّل هذه السمة مصدر شهادة صحة المحتوى الاصطناعي.

status

SyntheticContentAttestationStatus

تُستخدَم لتحديد ما إذا كان المصدر يعتبر المحتوى اصطناعيًا.

source

SyntheticContentSource

تمثّل هذه السمة مصدر شهادة صحة المحتوى الاصطناعي.

SyntheticContentInfo

حاوية لشهادات صحة المحتوى الاصطناعي من مصادر مختلفة، مثل المعلِن وأنظمة Google

الحقول

الحقول
`advertiser_attestation`	`SyntheticContentAttestation` البيانات المقدَّمة من المعلِن
`system_attestation`	`SyntheticContentAttestation` معلومات حول المحتوى الاصطناعي الذي تنشئه أنظمة Google

advertiser_attestation

SyntheticContentAttestation

البيانات المقدَّمة من المعلِن

system_attestation

SyntheticContentAttestation

معلومات حول المحتوى الاصطناعي الذي تنشئه أنظمة Google

TargetCpa

استراتيجية عروض أسعار مُبرمَجة تحدّد عروض الأسعار للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للاكتساب التي تحدِّدها.

الحقول

الحقول
`target_cpa_micros`	`int64` متوسط سقف التكلفة المحدّد لكل إجراء يجب أن يكون هذا الاستهداف أكبر من أو يساوي الحدّ الأدنى لوحدة الفوترة استنادًا إلى عملة الحساب.
`cpc_bid_ceiling_micros`	`int64` الحدّ الأقصى لعرض السعر الذي يمكن أن تحدّده استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يجب ضبط هذا الإعداد لاستراتيجيات المحفظة لعروض الأسعار فقط.
`cpc_bid_floor_micros`	`int64` الحدّ الأدنى لعرض السعر الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يجب ضبط هذا الإعداد لاستراتيجيات المحفظة لعروض الأسعار فقط.

target_cpa_micros

int64

متوسط سقف التكلفة المحدّد لكل إجراء يجب أن يكون هذا الاستهداف أكبر من أو يساوي الحدّ الأدنى لوحدة الفوترة استنادًا إلى عملة الحساب.

cpc_bid_ceiling_micros

int64

الحدّ الأقصى لعرض السعر الذي يمكن أن تحدّده استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يجب ضبط هذا الإعداد لاستراتيجيات المحفظة لعروض الأسعار فقط.

cpc_bid_floor_micros

int64

الحدّ الأدنى لعرض السعر الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يجب ضبط هذا الإعداد لاستراتيجيات المحفظة لعروض الأسعار فقط.

TargetCpm

لا يتضمّن هذا النوع أي حقول.

"التكلفة المستهدَفة لكلّ ألف ظهور" هي استراتيجية عروض أسعار مبرمَجة تضبط عروض الأسعار لتحسين الأداء بالنظر إلى التكلفة المستهدَفة لكلّ ألف ظهور التي تحدّدها.

TargetImpressionShare

استراتيجية عروض أسعار مبرمَجة تحدّد عروض الأسعار لكي تظهر نسبة مئوية معيّنة من الإعلانات على شبكة البحث في أعلى الصفحة الأولى (أو في موقع جغرافي مستهدَف آخر).

الحقول

الحقول
`location`	`TargetImpressionShareLocation` الموقع المستهدَف في صفحة نتائج البحث
`location_fraction_micros`	`int64` النسبة المحدّدة من الإعلانات التي سيتم عرضها في الموقع الجغرافي المستهدَف بالميكرو. على سبيل المثال، %1 يساوي 10,000.
`cpc_bid_ceiling_micros`	`int64` أعلى عرض سعر للنقرة يُسمح لنظام عروض الأسعار المبرمَجة بتحديده. هذا حقل مطلوب يدخله المعلِن ويحدّد الحدّ الأقصى ويتم تحديده في المواقع الجغرافية الصغيرة المحلية.

location

TargetImpressionShareLocation

الموقع المستهدَف في صفحة نتائج البحث

location_fraction_micros

int64

النسبة المحدّدة من الإعلانات التي سيتم عرضها في الموقع الجغرافي المستهدَف بالميكرو. على سبيل المثال، %1 يساوي 10,000.

cpc_bid_ceiling_micros

int64

أعلى عرض سعر للنقرة يُسمح لنظام عروض الأسعار المبرمَجة بتحديده. هذا حقل مطلوب يدخله المعلِن ويحدّد الحدّ الأقصى ويتم تحديده في المواقع الجغرافية الصغيرة المحلية.

TargetOutrankShare

استراتيجية عروض أسعار مبرمَجة تحدّد عروض الأسعار استنادًا إلى الجزء المستهدَف من المزادات الذي يجب أن يتفوّق فيه المعلِن على منافس معيّن. تم إيقاف هذه الاستراتيجية نهائيًا.

الحقول

الحقول
`cpc_bid_ceiling_micros`	`Int64Value` الحدّ الأقصى لعرض السعر الذي يمكن أن تحدّده استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية.

cpc_bid_ceiling_micros

Int64Value

الحدّ الأقصى لعرض السعر الذي يمكن أن تحدّده استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية.

TargetRestriction

قائمة بإعدادات الاستهداف لكل سمة استهداف

الحقول

الحقول
`targeting_dimension`	`TargetingDimension` سمة الاستهداف التي تنطبق عليها هذه الإعدادات
`bid_only`	`bool` تُستخدَم لتحديد ما إذا كان سيتم حصر عرض إعلاناتك على المعايير التي اخترتها لسمة targeting_dimension هذه فقط، أو استهداف جميع القيم لسمة targeting_dimension هذه وعرض الإعلانات استنادًا إلى استهدافك في سمات TargetingDimensions الأخرى. تعني القيمة `true` أنّ هذه المعايير ستطبّق معدّلات تعديل عروض الأسعار فقط، ولن تؤثّر في الاستهداف. تعني القيمة `false` أنّ هذه المعايير ستحدّ من الاستهداف بالإضافة إلى تطبيق مُعدِّلات عروض الأسعار.

targeting_dimension

TargetingDimension

سمة الاستهداف التي تنطبق عليها هذه الإعدادات

bid_only

bool

تُستخدَم لتحديد ما إذا كان سيتم حصر عرض إعلاناتك على المعايير التي اخترتها لسمة targeting_dimension هذه فقط، أو استهداف جميع القيم لسمة targeting_dimension هذه وعرض الإعلانات استنادًا إلى استهدافك في سمات TargetingDimensions الأخرى. تعني القيمة true أنّ هذه المعايير ستطبّق معدّلات تعديل عروض الأسعار فقط، ولن تؤثّر في الاستهداف. تعني القيمة false أنّ هذه المعايير ستحدّ من الاستهداف بالإضافة إلى تطبيق مُعدِّلات عروض الأسعار.

TargetRoas

استراتيجية عروض أسعار مبرمَجة تساعدك في زيادة الأرباح إلى أقصى حدّ مع بلوغ متوسط عائد إنفاق إعلاني مستهدَف محدّد.

الحقول

الحقول
`target_roas`	`double` الحقل مطلوب. الإيرادات المحدّدة (استنادًا إلى بيانات الإحالات الناجحة) لكل وحدة إنفاق يجب أن تتراوح القيمة بين 0.01 و1000.0 (بما يشمل هذين الرقمَين).
`cpc_bid_ceiling_micros`	`int64` الحدّ الأقصى لعرض السعر الذي يمكن أن تحدّده استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يجب ضبط هذا الإعداد لاستراتيجيات المحفظة لعروض الأسعار فقط.
`cpc_bid_floor_micros`	`int64` الحدّ الأدنى لعرض السعر الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يجب ضبط هذا الإعداد لاستراتيجيات المحفظة لعروض الأسعار فقط.

target_roas

double

الحقل مطلوب. الإيرادات المحدّدة (استنادًا إلى بيانات الإحالات الناجحة) لكل وحدة إنفاق يجب أن تتراوح القيمة بين 0.01 و1000.0 (بما يشمل هذين الرقمَين).

cpc_bid_ceiling_micros

int64

cpc_bid_floor_micros

int64

TargetSpend

استراتيجية عروض أسعار مُبرمَجة تحدِّد عروض أسعارك للمساعدة في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.

الحقول

الحقول
`target_spend_micros (deprecated)`	`int64` تم إيقاف هذا العنصر نهائيًا. تم إيقافها نهائيًا: الإنفاق المستهدف الذي يجب تحقيقه لزيادة النقرات إلى أقصى حد. سيحاول مقدّم عروض الأسعار المستند إلى استراتيجية "الإنفاق المستهدف" إنفاق المبلغ الأصغر من هذه القيمة أو مبلغ الإنفاق المحدود بشكل طبيعي. في حال عدم تحديدها، يتم استخدام الميزانية كاستهداف للإنفاق. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه بعد الآن. لمزيد من التفاصيل، يُرجى الاطّلاع على https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.
`cpc_bid_ceiling_micros`	`int64` الحدّ الأقصى لعرض السعر الذي يمكن أن تحدّده استراتيجية عروض الأسعار ينطبق الحدّ على جميع الكلمات الرئيسية التي تديرها الاستراتيجية.

target_spend_micros
(deprecated)

int64

تم إيقافها نهائيًا: الإنفاق المستهدف الذي يجب تحقيقه لزيادة النقرات إلى أقصى حد. سيحاول مقدّم عروض الأسعار المستند إلى استراتيجية "الإنفاق المستهدف" إنفاق المبلغ الأصغر من هذه القيمة أو مبلغ الإنفاق المحدود بشكل طبيعي. في حال عدم تحديدها، يتم استخدام الميزانية كاستهداف للإنفاق. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه بعد الآن. لمزيد من التفاصيل، يُرجى الاطّلاع على https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.

cpc_bid_ceiling_micros

int64

TargetingSetting

إعدادات الميزات ذات الصلة بالاستهداف، على مستوى الحملة والمجموعة الإعلانية لمزيد من التفاصيل حول إعدادات الاستهداف، يُرجى الانتقال إلى https://support.google.com/google-ads/answer/7365594

الحقول

الحقول
`target_restrictions[]`	`TargetRestriction` إعداد لكل سمة استهداف لتقييد مدى وصول حملتك أو مجموعتك الإعلانية

target_restrictions[]

TargetRestriction

إعداد لكل سمة استهداف لتقييد مدى وصول حملتك أو مجموعتك الإعلانية

TextAsset

مادة عرض نصية

الحقول

الحقول
`text`	`string` المحتوى النصي لمادة العرض النصية

text

string

المحتوى النصي لمادة العرض النصية

TextLabel

نوع من التصنيفات يعرض نصًا على خلفية ملونة

الحقول

الحقول
`background_color`	`string` لون خلفية التصنيف بتنسيق HEX يجب أن تتطابق هذه السلسلة مع التعبير العادي ‎ '^#([a-fA-F0-9]{6}\|[a-fA-F0-9]{3})$'. ملاحظة: قد لا يظهر لون الخلفية لحسابات المشرفين.
`description`	`string` تمثّل هذه السمة وصفًا موجزًا للتصنيف. يجب ألا يزيد الطول عن 200 حرف.

background_color

string

لون خلفية التصنيف بتنسيق HEX يجب أن تتطابق هذه السلسلة مع التعبير العادي ‎ '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. ملاحظة: قد لا يظهر لون الخلفية لحسابات المشرفين.

description

string

تمثّل هذه السمة وصفًا موجزًا للتصنيف. يجب ألا يزيد الطول عن 200 حرف.

UnifiedCallAsset

مادة عرض موحّدة للمكالمات

الحقول
`country_code`	`string` رمز البلد المكوّن من حرفَين لرقم الهاتف أمثلة: 'US' و'us'.
`phone_number`	`string` رقم هاتف المعلِن الأولي أمثلة: ‎'1234567890' أو ‎'(123)456-7890'
`call_conversion_reporting_state`	`CallConversionReportingState` توضّح هذه السمة ما إذا كان يجب أن يستخدم CallAsset إعداد الإحالة الناجحة عبر الاتصال الهاتفي الخاص به، أو يتّبع الإعداد على مستوى الحساب، أو يوقف ميزة الإحالة الناجحة عبر الاتصال الهاتفي.
`call_conversion_action`	`string` إجراء الإحالة الناجحة الذي سيتمّ تحديد مصدر إحالة ناجحة عبر الاتّصال الهاتفي إليه. في حال عدم ضبط هذه القيمة، يتم استخدام إجراء الإحالة الناجحة التلقائي. لا يكون لهذا الحقل أي تأثير إلا إذا تم ضبط call_conversion_reporting_state على USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
`ad_schedule_targets[]`	`AdScheduleInfo` قائمة بالجداول الزمنية غير المتداخلة التي تحدّد جميع الفواصل الزمنية التي يمكن أن تعرض فيها مادة العرض. يمكن أن يكون هناك 6 جداول كحدّ أقصى في اليوم، أي 42 جدولاً إجمالاً.
`call_only`	`bool` تحديد ما إذا كان الإعلان عن الاتصال فقط يعرض رقم الهاتف بدون رابط إلى الموقع الإلكتروني تنطبق هذه المقالة على Microsoft Ads.
`call_tracking_enabled`	`bool` تحديد ما إذا كان يجب تفعيل المكالمة في ميزة تتبُّع المكالمات تنطبق هذه المقالة على Microsoft Ads.
`use_searcher_time_zone`	`bool` تحديد ما إذا كان سيتم عرض إضافة المكالمة في المنطقة الزمنية لمستخدم البحث تنطبق هذه المقالة على Microsoft Ads.
`start_date`	`string` تمثّل هذه السمة تاريخ بدء صلاحية هذا الأصل وإمكانية عرضه، وذلك بالتنسيق yyyy-MM-dd.
`end_date`	`string` تمثّل هذه السمة آخر تاريخ تكون فيه مادة العرض هذه فعّالة ولا تزال معروضة، وذلك بالتنسيق yyyy-MM-dd.

UnifiedCalloutAsset

مادة عرض موحّدة لوسائل الشرح

الحقول
`callout_text`	`string` نص وسيلة الشرح يجب أن يتراوح طول هذه السلسلة بين 1 و25 حرفًا، بما في ذلك القيمتان.
`start_date`	`string` تمثّل هذه السمة تاريخ بدء صلاحية هذا الأصل وإمكانية عرضه، وذلك بالتنسيق yyyy-MM-dd.
`end_date`	`string` تمثّل هذه السمة آخر تاريخ تكون فيه مادة العرض هذه فعّالة ولا تزال معروضة، وذلك بالتنسيق yyyy-MM-dd.
`ad_schedule_targets[]`	`AdScheduleInfo` قائمة بالجداول الزمنية غير المتداخلة التي تحدّد جميع الفواصل الزمنية التي يمكن أن تعرض فيها مادة العرض. يمكن أن يكون هناك 6 جداول كحدّ أقصى في اليوم، أي 42 جدولاً إجمالاً.
`use_searcher_time_zone`	`bool` تحديد ما إذا كان سيتم عرض مادة العرض في المنطقة الزمنية للمستخدم الذي يجري البحث تنطبق هذه المقالة على Microsoft Ads.

UnifiedLocationAsset

مادة عرض الموقع الجغرافي الموحّدة

الحقول

الحقول
`place_id`	`string` تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات Google Places وعلى "خرائط Google". هذا الحقل فريد لمعرّف عميل ونوع مادة عرض معيّنَين. يمكنك الانتقال إلى https://developers.google.com/places/web-service/place-id لمعرفة المزيد عن رقم تعريف المكان.
`business_profile_locations[]`	`BusinessProfileLocation` قائمة المواقع الجغرافية للنشاط التجاري الخاصة بالعميل لن يتم عرض هذه السمة إلا إذا كانت مادة عرض الموقع الجغرافي تتم مزامنتها من حساب "الملف التجاري". من الممكن أن تتضمّن القائمة نفسها عدة إدخالات في "الملف التجاري" ضمن الحساب نفسه وتشير إلى رقم تعريف المكان نفسه.
`location_ownership_type`	`LocationOwnershipType` نوع ملكية الموقع الجغرافي إذا كان النوع BUSINESS_OWNER، سيتم عرضه كإضافة موقع جغرافي. إذا كان النوع AFFILIATE، سيتم عرضه كموقع جغرافي تابع.

place_id

string

تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات Google Places وعلى "خرائط Google". هذا الحقل فريد لمعرّف عميل ونوع مادة عرض معيّنَين. يمكنك الانتقال إلى https://developers.google.com/places/web-service/place-id لمعرفة المزيد عن رقم تعريف المكان.

business_profile_locations[]

BusinessProfileLocation

قائمة المواقع الجغرافية للنشاط التجاري الخاصة بالعميل لن يتم عرض هذه السمة إلا إذا كانت مادة عرض الموقع الجغرافي تتم مزامنتها من حساب "الملف التجاري". من الممكن أن تتضمّن القائمة نفسها عدة إدخالات في "الملف التجاري" ضمن الحساب نفسه وتشير إلى رقم تعريف المكان نفسه.

location_ownership_type

LocationOwnershipType

نوع ملكية الموقع الجغرافي إذا كان النوع BUSINESS_OWNER، سيتم عرضه كإضافة موقع جغرافي. إذا كان النوع AFFILIATE، سيتم عرضه كموقع جغرافي تابع.

UnifiedPageFeedAsset

مادة عرض "خلاصة الصفحة الموحّدة"

الحقول

الحقول
`page_url`	`string` صفحة الويب التي يريد المعلِنون استهدافها
`labels[]`	`string` التصنيفات المستخدَمة لتجميع عناوين URL الخاصة بالصفحات

page_url

string

صفحة الويب التي يريد المعلِنون استهدافها

labels[]

string

التصنيفات المستخدَمة لتجميع عناوين URL الخاصة بالصفحات

UnifiedSitelinkAsset

مادة عرض موحّدة لروابط أقسام الموقع

الحقول
`link_text`	`string` نص عرض عنوان URL لرابط أقسام الموقع يجب أن يتراوح طول هذه السلسلة بين 1 و25 حرفًا، بما في ذلك القيمتان.
`description1`	`string` السطر الأول من وصف رابط أقسام الموقع. في حال ضبط هذه السمة، يجب أن يتراوح طولها بين 1 و35 حرفًا، ويجب ضبط السمة description2 أيضًا.
`description2`	`string` السطر الثاني من وصف رابط أقسام الموقع. في حال ضبطها، يجب أن يتراوح الطول بين 1 و35 حرفًا، ويجب ضبط description1 أيضًا.
`start_date`	`string` تمثّل هذه السمة تاريخ بدء صلاحية هذا الأصل وإمكانية عرضه، وذلك بالتنسيق yyyy-MM-dd.
`end_date`	`string` تمثّل هذه السمة آخر تاريخ تكون فيه مادة العرض هذه فعّالة ولا تزال معروضة، وذلك بالتنسيق yyyy-MM-dd.
`ad_schedule_targets[]`	`AdScheduleInfo` قائمة بالجداول الزمنية غير المتداخلة التي تحدّد جميع الفواصل الزمنية التي يمكن أن تعرض فيها مادة العرض. يمكن أن يكون هناك 6 جداول كحدّ أقصى في اليوم، أي 42 جدولاً إجمالاً.
`tracking_id`	`int64` المعرّف المستخدَم لتتبُّع النقرات لمادة عرض رابط إلى قسم الموقع هذا حساب Yahoo!. حقل خاص باليابان فقط
`use_searcher_time_zone`	`bool` تحديد ما إذا كان سيتم عرض مادة عرض رابط إلى قسم الموقع في المنطقة الزمنية لمستخدم البحث تنطبق هذه المقالة على Microsoft Ads.
`mobile_preferred`	`bool` ما إذا كان من المفضّل عرض مادة عرض رابط إلى قسم الموقع على الأجهزة الجوّالة. تنطبق هذه المقالة على Microsoft Ads.

UserListInfo

معيار قائمة المستخدمين تمثّل هذه السمة قائمة مستخدمين يحدّدها المعلِن لاستهدافها.

الحقول

الحقول
`user_list`	`string` اسم المورد الخاص بقائمة المستخدمين

user_list

string

اسم المورد الخاص بقائمة المستخدمين

القيمة

حاوية بيانات عامة

الحقول
حقل الربط `value` قيمة يمكن أن يكون التعليق `value` إحدى القيم التالية فقط:
`boolean_value`	`bool` قيمة منطقية
`int64_value`	`int64` تمثّل هذه السمة عددًا صحيحًا من النوع int64.
`float_value`	`float` قيمة عددية ذات فاصلة عشرية
`double_value`	`double` مزدوجة
`string_value`	`string` سلسلة

WebpageConditionInfo

تعبير منطقي لاستهداف صفحات الويب على الموقع الإلكتروني للمعلِن

الحقول

operand

WebpageConditionOperand

المعامل الخاص بشرط استهداف صفحة الويب.

operator

WebpageConditionOperator

عامل تشغيل شرط استهداف صفحة الويب.

argument

string

وسيطة شرط استهداف صفحة الويب.

WebpageInfo

تمثّل هذه السمة معيارًا لاستهداف صفحات الويب على الموقع الإلكتروني للمعلِن.

الحقول

conditions[]

WebpageConditionInfo

الشروط أو العبارات المنطقية لاستهداف صفحات الويب يتم ربط قائمة شروط استهداف صفحات الويب باستخدام عامل AND عند تقييمها لأغراض الاستهداف. تشير قائمة الشروط الفارغة إلى أنّه يتم استهداف جميع صفحات الموقع الإلكتروني للحملة.

هذا الحقل مطلوب لعمليات CREATE ومحظور في عمليات UPDATE.

coverage_percentage

double

نسبة تغطية معايير المواقع الإلكترونية هذه هي النسبة المئوية المحسوبة لتغطية الموقع الإلكتروني استنادًا إلى استهداف الموقع الإلكتروني واستهداف الموقع الإلكتروني السلبي والكلمات الرئيسية السلبية في المجموعة الإعلانية والحملة. على سبيل المثال، عندما تكون قيمة التغطية 1، يشير ذلك إلى أنّ التغطية تبلغ% 100. هذا الحقل مخصّص للقراءة فقط.

criterion_name

string

اسم معيار الاستهداف الذي تحدّده هذه المَعلمة. سيتم استخدام قيمة الاسم لتحديد معايير الفرز والتصفية وترتيبها باستخدام هذا النوع من المَعلمات.

هذا الحقل مطلوب لعمليات CREATE ومحظور في عمليات UPDATE.

YoutubeVideoAsset

مادة عرض على YouTube

الحقول

youtube_video_title

string

تمثّل هذه السمة عنوان الفيديو على YouTube.

youtube_video_id

string

معرّف الفيديو على YouTube هذه هي قيمة السلسلة المكوّنة من 11 حرفًا والمستخدَمة في عنوان URL الخاص بالفيديو على YouTube.

Package google.ads.searchads360.v0.common تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الفهرس

AdScheduleInfo

AdTextAsset

AgeRangeInfo

AssetInteractionTarget

AssetUsage

AudienceInfo

BusinessProfileLocation

CallToActionAsset

CustomParameter

DeviceInfo

EnhancedCpc

FinalAppUrl

FrequencyCapEntry

GenderInfo

ImageAsset

ImageDimension

الكلمة الرئيسية

KeywordInfo

LanguageInfo

ListingGroupInfo

LocationGroupInfo

LocationInfo

ManualCpa

ManualCpc

ManualCpm

MaximizeConversionValue

MaximizeConversions

المقاييس

MobileAppAsset

PercentCpc

RealTimeBiddingSetting

SearchAds360ExpandedDynamicSearchAdInfo

SearchAds360ExpandedTextAdInfo

SearchAds360ProductAdInfo

SearchAds360ResponsiveSearchAdInfo

SearchAds360TextAdInfo

الشرائح

SyntheticContentAttestation

SyntheticContentInfo

TargetCpa

TargetCpm

TargetImpressionShare

TargetOutrankShare

TargetRestriction

TargetRoas

TargetSpend

TargetingSetting

TextAsset

TextLabel

UnifiedCallAsset

UnifiedCalloutAsset

UnifiedLocationAsset

UnifiedPageFeedAsset

UnifiedSitelinkAsset

UserListInfo

القيمة

WebpageConditionInfo

WebpageInfo

YoutubeVideoAsset

Package google.ads.searchads360.v0.common