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

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

Package google.ads.searchads360.v0.common

الفهرس

AdScheduleInfo (رسالة)
AdTextAsset (رسالة)
AgeRangeInfo (رسالة)
AssetInteractionTarget (رسالة)
AssetUsage (رسالة)
AudienceInfo (رسالة)
BusinessProfileLocation (رسالة)
CallToActionAsset (رسالة)
CustomParameter (رسالة)
DeviceInfo (رسالة)
EnhancedCpc (رسالة)
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 (رسالة)
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` التصنيف الذي حدّده المعلِن للموقع الجغرافي في حساب "الملف التجاري" وتتم مزامنة هذه المعلومات من حساب "الملف التجاري على Google".
`store_code`	`string` رمز المتجر في "الملف التجاري" لهذا الموقع الجغرافي تتم مزامنة هذه البيانات من حساب "الملف التجاري على Google".
`listing_id`	`int64` رقم تعريف النشاط لهذا الموقع الجغرافي في "الملف التجاري" تتم مزامنة هذه البيانات من حساب "الملف التجاري" المرتبط.

labels[]

string

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

store_code

string

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

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 على true للحصول على وظيفة مماثلة.

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. هذا الخيار اختياري ولا يمكن ضبطه إلا في عمليات الإنشاء.
`radius`	`int64` المسافة بوحدات تحدّد النطاق الجغرافي حول المواقع الجغرافية المستهدَفة هذا الإجراء مطلوب ويجب ضبطه في عمليات الإنشاء.

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 على الرابط https://support.google.com/sa360/answer/9250611.
`all_conversions_by_conversion_date`	`double` إجمالي عدد التحويلات. ويشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمة include_in_conversions_metric. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود التاريخ إلى تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.
`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` نسبة النقر إلى الظهور المتوقّعة في نتائج البحث السابقة
`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 على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`average_cpm`	`double` متوسّط التكلفة لكل ألف ظهور (CPM) هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
`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"" عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
`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) والتكلفة لكل ألف ظهور (CPM) خلال هذه الفترة. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
`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 على الرابط https://support.google.com/sa360/answer/9250611.
`cross_device_conversions_value`	`double` مجموع قيمة الإحالات الناجحة باستخدام أكثر من جهاز واحد.
`cross_device_conversions_value_by_conversion_date`	`double` مجموع قيمة الإحالات الناجحة باستخدام أكثر من جهاز واحد حسب تاريخ الإحالة الناجحة تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.
`ctr`	`double` عدد النقرات التي يتلقّاها إعلانك (النقرات) مقسومًا على عدد مرّات ظهور إعلانك (مرّات الظهور).
`conversions`	`double` عدد الإحالات الناجحة. لا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة include_in_conversions_metric عليها على true. إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة.
`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 غير مشروعة ويتم رصدها من خلال وسائل الفلترة الروتينية (أي الزيارات المعروفة غير الصالحة لمراكز البيانات أو برامج التتبّع أو العناكب أو برامج الزحف الأخرى أو الأنماط غير المنتظمة وما إلى ذلك). ولا يتم تحميلك تكلفة هذه النقرات، ولا تؤثر في إحصاءات حسابك. يمكنك الاطّلاع على صفحة المساعدة على الرابط https://support.google.com/campaignmanager/answer/6076504 للحصول على التفاصيل.
`general_invalid_clicks`	`int64` عدد النقرات غير الصالحة العامة هذه هي مجموعة فرعية من النقرات غير الصالحة التي يتم رصدها من خلال وسائل الفلترة الروتينية (مثل الزيارات المعروفة غير الصالحة لمراكز البيانات أو برامج التتبّع أو برامج العنكبوت أو برامج الزحف الأخرى أو الأنماط غير المنتظمة أو ما إلى ذلك). ولا يتم تحميلك تكلفة هذه النقرات، ولا تؤثر في إحصاءات حسابك. يمكنك الاطّلاع على صفحة المساعدة على الرابط https://support.google.com/campaignmanager/answer/6076504 للحصول على التفاصيل.
`mobile_friendly_clicks_percentage`	`double` النسبة المئوية للنقرات على الأجهزة الجوّالة التي تذهب إلى صفحة متوافقة مع الأجهزة الجوّالة.
`search_absolute_top_impression_share`	`double` النسبة المئوية لمرات ظهور إعلانات Shopping أو إعلانات شبكة البحث للعملاء التي تظهر في أبرز موضع على Shopping. يُرجى الاطّلاع على https://support.google.com/sa360/answer/9566729 للحصول على التفاصيل. يتم تسجيل أي قيمة أقل من 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 على الرابط https://support.google.com/sa360/answer/9250611.
`value_per_conversion`	`double` قيمة الإحالة الناجحة التي يمكن تقديم عروض أسعار لها مقسومةً على عدد الإحالات الناجحة التي يمكن تقديم عروض أسعار لها. تعرِض هذه السمة القيمة المتوسطة لكلّ إحالة ناجحة يمكن تقديم عروض أسعار لها.
`value_per_conversions_by_conversion_date`	`double` قيمة الإحالات الناجحة التي يمكن تقديم عروض أسعار لها حسب تاريخ الإحالة الناجحة مقسومةً على الإحالات الناجحة التي يمكن تقديم عروض أسعار لها حسب تاريخ الإحالة الناجحة. يعرِض متوسّط قيمة كل إحالة من الإحالات الناجحة التي يمكن تقديم عروض أسعار لها (حسب تاريخ الإحالة الناجحة). عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود التاريخ إلى تاريخ الإحالة الناجحة.
`client_account_view_through_conversions`	`int64` إجمالي عدد الإحالات الناجحة بعد رؤية الإعلان فقط تحدث هذه الإحالات الناجحة عندما يرى عميل صورة أو إعلانًا بالوسائط الغنية، ثم يُكمل لاحقًا إحالة ناجحة على موقعك الإلكتروني بدون التفاعل مع إعلان آخر (مثلاً، النقر عليه).
`client_account_cross_sell_cost_of_goods_sold_micros`	`int64` تكلفة السلع المُباعة من خلال بيع منتجات إضافية لحساب العميل هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً لإعلان عن منتج مختلف. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. إذًا تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
`cross_sell_cost_of_goods_sold_micros`	`int64` تكلفة السلع المُباعة من خلال بيع منتجات إضافية (COGS) هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً لإعلان عن منتج مختلف. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. إذًا تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
`client_account_cross_sell_gross_profit_micros`	`int64` الأرباح الإجمالية من بيع منتجات إضافية في حساب العميل هي الأرباح التي حقّقتها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
`cross_sell_gross_profit_micros`	`int64` الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي تحقّقها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
`client_account_cross_sell_revenue_micros`	`int64` الأرباح من بيع منتجات إضافية في حسابات العملاء هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`cross_sell_revenue_micros`	`int64` الأرباح من بيع المنتجات الإضافية هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
`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 على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
`lead_cost_of_goods_sold_micros`	`int64` تكلفة السلع المُباعة للعملاء المحتملِين هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ احتساب تكلفة هذه السلع ضمن تكلفة السلع المُباعة للعملاء المحتملِين. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
`client_account_lead_gross_profit_micros`	`int64` الأرباح الإجمالية من العملاء المحتملِين لحساب العميل هي الأرباح التي حقّقتها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
`lead_gross_profit_micros`	`int64` الأرباح الإجمالية من العملاء المحتملِين هي الأرباح التي تحقِقّها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
`client_account_lead_revenue_micros`	`int64` الأرباح من العملاء المحتملِين لحساب العميل هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الإيرادات من العملاء المحتملين لهذا الطلب 10 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`lead_revenue_micros`	`int64` الأرباح من العملاء المحتملِين هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الإيرادات من العملاء المحتملين لهذا الطلب 10 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
`client_account_lead_units_sold`	`double` الوحدات المُباعة للعملاء المحتملِين في حساب العميل هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة الإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمنتجات المُباعة، يظهر إجمالي عدد هذه المنتجات المُباعة ضمن "الوحدات المُباعة للعملاء المحتملِين". على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة للعملاء المحتملِين في هذا الطلب هي 1. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
`lead_units_sold`	`double` الوحدات المُباعة للعملاء المحتملِين هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة للإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمنتجات المُباعة، يظهر إجمالي عدد هذه المنتجات المُباعة ضمن "الوحدات المُباعة للعملاء المحتملِين". مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة للعملاء المحتملِين في هذا الطلب هي 1. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.

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` الحد الأقصى لعروض الأسعار الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. هذا حقل اختياري يُدخله المعلِن ويتم تحديده في الإعلانات المصغّرة المحلية. ملاحظة: يتم تفسير القيمة صفر بالطريقة نفسها التي يتم بها تفسير عدم تحديد الحدّ الأقصى للعروض.
`enhanced_cpc_enabled`	`bool` تعمل هذه الاستراتيجية على تعديل عرض السعر لكل مزاد بالزيادة أو النقصان، استنادًا إلى احتمالية حدوث إحالة ناجحة. قد تتجاوز عروض الأسعار الفردية cpc_bid_ceiling_micros، ولكن يجب ألا يتجاوز متوسط مبلغ عرض السعر لحملة معيّنة هذا الحدّ.

cpc_bid_ceiling_micros

int64

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

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"

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

SearchAds360ProductAdInfo

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

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

SearchAds360ResponsiveSearchAdInfo

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

الحقول
`headlines[]`	`AdTextAsset` قائمة بمواد العرض النصية للعناوين عند عرض الإعلانات، سيتم اختيار العناوين من هذه القائمة.
`descriptions[]`	`AdTextAsset` قائمة بمواد العرض النصية للأوصاف عند عرض الإعلان، سيتم اختيار الأوصاف من هذه القائمة.
`path1`	`string` نص مرفق بعنوان URL المرئي الذي تم إنشاؤه تلقائيًا باستخدام فاصل
`path2`	`string` نص مرفق بالمسار 1 باستخدام فاصل
`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_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_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 في 01‏-04‏-2018. بالتنسيق yyyy-MM-dd
`week`	`string` الأسبوع على أنّه من الاثنين إلى الأحد، ويمثّله تاريخ الاثنين التنسيق بالتنسيق yyyy-MM-dd
`year`	`int32` السنة بالتنسيق yyyy
`asset_interaction_target`	`AssetInteractionTarget` لا يتمّ استخدامها إلا مع مقاييس CustomerAsset وCampaignAsset وAdGroupAsset. يشير إلى ما إذا كانت مقاييس التفاعل قد حدثت على مادة العرض نفسها أو على مادة عرض أو وحدة إعلانية مختلفة. يتم احتساب التفاعلات (مثل النقرات) في جميع أجزاء الإعلان المعروض (مثل الإعلان نفسه والمكوّنات الأخرى، مثل روابط أقسام الموقع) عند عرضها معًا. عندما تكون قيمة interaction_on_this_asset صحيحة، يعني ذلك أنّ التفاعلات تحدث في مادة العرض المحدّدة هذه، وعندما تكون قيمة interaction_on_this_asset خاطئة، يعني ذلك أنّ التفاعلات لا تحدث في مادة العرض المحدّدة هذه، بل في أجزاء أخرى من الإعلان المعروض الذي يتم عرض مادة العرض معه.

TargetCpa

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

الحقول

الحقول
`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` يشير إلى ما إذا كان يجب حصر عرض إعلاناتك بالمعايير التي اخترتها لسمة_الاستهداف هذه فقط، أو استهداف جميع قيم سمة_الاستهداف هذه وعرض الإعلانات استنادًا إلى استهدافك في سمات_الاستهداف الأخرى. تعني القيمة `true` أنّ هذه المعايير ستطبّق فقط مُعدِّلات عروض الأسعار، ولن تؤثّر في الاستهداف. وتعني القيمة `false` أنّ هذه المعايير ستقيّد الاستهداف بالإضافة إلى تطبيق معدِّلات عروض الأسعار.

targeting_dimension

TargetingDimension

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

bid_only

bool

يشير إلى ما إذا كان يجب حصر عرض إعلاناتك بالمعايير التي اخترتها لسمة_الاستهداف هذه فقط، أو استهداف جميع قيم سمة_الاستهداف هذه وعرض الإعلانات استنادًا إلى استهدافك في سمات_الاستهداف الأخرى. تعني القيمة 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` تم إيقاف هذا العنصر نهائيًا. تم إيقاف هذه السمة نهائيًا: الإنفاق المستهدَف الذي يتمّ من خلاله زيادة النقرات إلى أقصى حدّ. سيحاول مقدّم عروض أسعار TargetSpend إنفاق القيمة الأصغر من هذه القيمة أو مبلغ الإنفاق الطبيعي الذي تمّ تقييده. في حال عدم تحديدها، يتم استخدام الميزانية كمستهدف الإنفاق. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه. اطّلِع على https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html للاطّلاع على التفاصيل.
`cpc_bid_ceiling_micros`	`int64` الحد الأقصى لعروض الأسعار الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. ينطبق الحد على جميع الكلمات الرئيسية التي تديرها الإستراتيجية.

target_spend_micros
(deprecated)

int64

تم إيقاف هذه السمة نهائيًا: الإنفاق المستهدَف الذي يتمّ من خلاله زيادة النقرات إلى أقصى حدّ. سيحاول مقدّم عروض أسعار TargetSpend إنفاق القيمة الأصغر من هذه القيمة أو مبلغ الإنفاق الطبيعي الذي تمّ تقييده. في حال عدم تحديدها، يتم استخدام الميزانية كمستهدف الإنفاق. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه. اطّلِع على 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` لون خلفية التصنيف بتنسيق سداسي عشري يجب أن تتطابق هذه السلسلة مع التعبير العادي "^#([a-fA-F0-9]{6}\|[a-fA-F0-9]{3})$". ملاحظة: قد لا يكون لون الخلفية مرئيًا للحسابات الإدارية.
`description`	`string` وصف موجز للتصنيف يجب ألا يزيد طول العنوان عن 200 حرف.

background_color

string

لون خلفية التصنيف بتنسيق سداسي عشري يجب أن تتطابق هذه السلسلة مع التعبير العادي "^#([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_LOCATION_LEVEL_CALL_CONVERSION_ACTION.
`ad_schedule_targets[]`	`AdScheduleInfo` قائمة بالجداول الزمنية غير المتداخلة التي تحدّد جميع الفواصل الزمنية التي يمكن أن يتم عرض مادة العرض خلالها يمكن أن يكون هناك 6 جداول زمنية كحد أقصى في اليوم، وإجمالي 42 جدولاً.
`call_only`	`bool` ما إذا كان الاتصال يعرض رقم الهاتف فقط بدون رابط إلى الموقع الإلكتروني تنطبق هذه المقالة على Microsoft Advertising.
`call_tracking_enabled`	`bool` يشير إلى ما إذا كان يجب تفعيل المكالمة في ميزة تتبُّع المكالمات. تنطبق هذه المقالة على Microsoft Advertising.
`use_searcher_time_zone`	`bool` ما إذا كان سيتم عرض إضافة المكالمة في المنطقة الزمنية لمستخدم البحث تنطبق هذه المقالة على Microsoft Advertising.
`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 Advertising.

UnifiedLocationAsset

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

الحقول

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

place_id

string

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

business_profile_locations[]

BusinessProfileLocation

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

location_ownership_type

LocationOwnershipType

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

UnifiedPageFeedAsset

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

الحقول

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

page_url

string

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

labels[]

string

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

UnifiedSitelinkAsset

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

الحقول
`link_text`	`string` نص عرض عنوان URL لرابط أقسام الموقع. يجب أن يتراوح طول هذه السلسلة بين 1 و25 حرفًا.
`description1`	`string` سطر الوصف الأول لرابط أقسام الموقع. وفي حال ضبطها، يجب أن يكون الطول بين 1 و35، ويجب أيضًا ضبط الوصف 2.
`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 Advertising.
`mobile_preferred`	`bool` ما إذا كان الخيار المفضّل هو عرض مادة عرض رابط أقسام الموقع على الأجهزة الجوّالة. تنطبق هذه المقالة على Microsoft Advertising.

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` وسيطة شرط استهداف صفحة الويب.

operand

WebpageConditionOperand

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

operator

WebpageConditionOperator

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

argument

string

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

WebpageInfo

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

الحقول

الحقول
`conditions[]`	`WebpageConditionInfo` الشروط أو التعبيرات المنطقية لاستهداف صفحات الويب يتم جمع قائمة شروط استهداف صفحات الويب معًا عند تقييمها للاستهداف. تشير قائمة الشروط الفارغة إلى أنّه يتم استهداف جميع صفحات الموقع الإلكتروني للحملة. هذا الحقل مطلوب لعمليات الإنشاء (CREATE) وغير مسموح به في عمليات التعديل (UPDATE).
`coverage_percentage`	`double` النسبة المئوية لتغطية معايير الموقع الإلكتروني هذه هي النسبة المئوية المحسوبة لتغطية الموقع الإلكتروني استنادًا إلى استهداف الموقع الإلكتروني واستهداف الموقع الإلكتروني السلبي والكلمات الرئيسية السلبية في المجموعة الإعلانية والحملة. على سبيل المثال، عندما يتم عرض التغطية على أنّها 1، يعني ذلك أنّها تبلغ% 100. هذا الحقل للقراءة فقط.
`criterion_name`	`string` اسم المعيار الذي تحدّده هذه المَعلمة. سيتم استخدام قيمة الاسم لتحديد المعايير وترتيبها وتصفيتها باستخدام هذا النوع من المعلمات. هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE.

conditions[]

WebpageConditionInfo

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

هذا الحقل مطلوب لعمليات الإنشاء (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.

youtube_video_title

string

عنوان الفيديو على YouTube

youtube_video_id

string

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