Package google.ads.searchads360.v0.common

الفهرس

AdScheduleInfo

يُمثِّل أحد معايير جدول عرض الإعلانات.

يتم تحديد Adالجدول في يوم من الأسبوع والفاصل الزمني الذي سيتم عرض الإعلانات خلاله.

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

الحقول
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.

AgeRangeInfo

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

الحقول
type

AgeRangeType

تمثّل هذه السمة نوع الفئة العمرية.

AssetInteractionTarget

شريحة AssetInteractionTarget

الحقول
asset

string

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

interaction_on_this_asset

bool

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

AssetUsage

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

الحقول
asset

string

اسم المورِد الخاص بمادة العرض

served_asset_field_type

ServedAssetFieldType

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

AudienceInfo

معيار شريحة الجمهور

الحقول
audience

string

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

BusinessProfileLocation

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

الحقول
labels[]

string

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

store_code

string

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

listing_id

int64

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

CallToActionAsset

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

الحقول
call_to_action

CallToActionType

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

CustomParameter

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

الحقول
key

string

المفتاح الذي يطابق اسم علامة المعلمة.

value

string

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

DeviceInfo

معيار الجهاز

الحقول
type

Device

نوع الجهاز

EnhancedCpc

لا يحتوي هذا النوع على أي حقول.

استراتيجية عروض أسعار مبرمَجة ترفع عروض الأسعار للنقرات التي يزداد احتمال أن تؤدي إلى إحالة ناجحة، وتخفضها للنقرات التي يقل احتمال أن تؤدي إلى إحالات ناجحة.

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

FrequencyCapEntry

لا يحتوي هذا النوع على أي حقول.

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

GenderInfo

معيار الجنس

الحقول
type

GenderType

تمثّل هذه السمة نوع الجنس.

ImageAsset

مادة عرض صورة

الحقول
mime_type

MimeType

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

full_size

ImageDimension

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

file_size

int64

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

ImageDimension

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

الحقول
height_pixels

int64

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

width_pixels

int64

عرض الصورة.

url

string

تمثّل هذه السمة عنوان URL يعرض الصورة بهذا الارتفاع والعرض.

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

شريحة معيار الكلمة الرئيسية.

الحقول
info

KeywordInfo

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

ad_group_criterion

string

اسم مورد AdGroupReference.

KeywordInfo

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

الحقول
match_type

KeywordMatchType

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

text

string

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

LanguageInfo

معيار لغة

الحقول
language_constant

string

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

ListingGroupInfo

معيار مجموعة بيانات.

الحقول
type

ListingGroupType

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

LocationGroupInfo

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

الحقول
geo_target_constants[]

string

تشير هذه السمة إلى ثوابت الاستهداف الجغرافي التي تفرض قيودًا على نطاق المنطقة الجغرافية ضمن الخلاصة. يُسمح حاليًا باستخدام ثابت هدف جغرافي واحد فقط.

radius_units

LocationGroupRadiusUnits

وحدة النطاق الجغرافي. يتم دعم الأميال والأمتار لثوابت الموقع الجغرافي المستهدف. ويُسمح باستخدام أجهزة المللي ميل والمتر مع مجموعات عناصر الخلاصة. هذا الإجراء مطلوب ويجب ضبطه في عمليات CREATE.

feed_item_sets[]

string

FeedItemSets التي يتم استهداف عناصر FeedItems فيها وفي حال تحديد أرقام تعريف متعددة، سيتم استهداف جميع العناصر التي تظهر في مجموعة واحدة على الأقل. لا يمكن استخدام هذا الحقل مع geo_target_constants. هذا اختياري ولا يمكن تعيينه إلا في عمليات CREATE.

radius

int64

المسافة بالوحدات التي تحدد النطاق الجغرافي حول المواقع المستهدفة. هذا الإجراء مطلوب ويجب ضبطه في عمليات CREATE.

LocationInfo

معيار الموقع الجغرافي

الحقول
geo_target_constant

string

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

ManualCpa

لا يحتوي هذا النوع على أي حقول.

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

ManualCpc

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

الحقول
enhanced_cpc_enabled

bool

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

ManualCpm

لا يحتوي هذا النوع على أي حقول.

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

MaximizeConversionValue

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

الحقول
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_roas

double

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

MaximizeConversions

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

الحقول
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

إجمالي عدد التحويلات. يشمل ذلك كل الإحالات الناجحة بغض النظر عن قيمة add_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

إجمالي عدد التحويلات. يشمل ذلك كل الإحالات الناجحة بغض النظر عن قيمة add_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"" عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.

client_account_conversions

double

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

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"" عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.

cross_device_conversions

double

يشير ذلك إلى الإحالات الناجحة عندما ينقر العميل على إعلان في أحد الأجهزة، ثم يُجري إحالة ناجحة على جهاز أو متصفّح آخر. يتم تضمين الإحالات الناجحة باستخدام أكثر من جهاز واحد في all_conversions.

cross_device_conversions_value

double

مجموع قيمة الإحالات الناجحة باستخدام أكثر من جهاز واحد.

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 غير قانونية ولا يتم تحصيل رسوم منك مقابلها.

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

تكلفة السلع المُباعة من خلال بيع منتجات إضافية (COGS) في حساب العميل هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً لإعلان عن منتج مختلف. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات 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

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

PercentCpc

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

الحقول
cpc_bid_ceiling_micros

int64

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

enhanced_cpc_enabled

bool

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

RealTimeBiddingSetting

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

الحقول
opt_in

bool

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

SearchAds360ExpandedDynamicSearchAdInfo

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

الحقول
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".

الحقول
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

يوم من الأسبوع، على سبيل المثال، MONDAY.

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، مثلًا، 17-04-2018.

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 في 2018-04-01. التنسيق بالتنسيق yyyy-MM-dd

week

string

أسبوع حسب تعريفه من الاثنين إلى الأحد، ويتم تمثيله بتاريخ الاثنين التنسيق بالتنسيق yyyy-MM-dd

year

int32

السنة، بالتنسيق yyyy.

asset_interaction_target

AssetInteractionTarget

تُستخدَم فقط مع مقاييس CustomerAsset وCampaignAsset وAdGroupAsset. يشير هذا المقياس إلى ما إذا كانت مقاييس التفاعل قد تم تسجيلها في مادة العرض نفسها أو في مادة عرض أو وحدة إعلانية مختلفة. ويتم احتساب التفاعلات (على سبيل المثال، النقرات) على مستوى جميع أجزاء الإعلان المعروض (مثل الإعلان نفسه والمكوّنات الأخرى مثل روابط أقسام الموقع) عندما يتم عرضها معًا. عندما تكون قيمةInteract_on_this_asset صحيحة، هذا يعني أنّ التفاعلات تتم على مادة العرض المحدّدة هذه. أمّا إذا كانت شريحة engagement_on_this_asset إما خاطئة، هذا يعني أنّ التفاعلات ليست في مادة العرض المحدّدة هذه، بل في أجزاء أخرى من الإعلان المعروض.

TargetCpa

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

الحقول
target_cpa_micros

int64

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

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

TargetCpm

لا يحتوي هذا النوع على أي حقول.

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

TargetImpressionShare

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

الحقول
location

TargetImpressionShareLocation

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

location_fraction_micros

int64

الجزء المختار من الإعلانات التي سيتم عرضها في الموقع الجغرافي المستهدف بوحدات المايكرو. على سبيل المثال، 1% تساوي 10000.

cpc_bid_ceiling_micros

int64

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

TargetOutrankShare

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

الحقول
cpc_bid_ceiling_micros

Int64Value

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

TargetRestriction

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

الحقول
targeting_dimension

TargetingDimension

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

bid_only

bool

يشير إلى ما إذا كنت تريد تقييد عرض إعلاناتك فقط للمعايير التي اخترتها لهذه السمة target_dimension، أو استهداف جميع القيم لسمة استهداف_الاستهداف هذه وعرض الإعلانات استنادًا إلى استهدافك في أبعاد استهداف أخرى. وتعني القيمة true أنّ هذه المعايير لن تطبّق سوى معدِّلات عروض الأسعار، ولن تؤثر في الاستهداف. وتعني القيمة false أنّ هذه المعايير ستقيّد الاستهداف بالإضافة إلى تطبيق معدِّلات عروض الأسعار.

TargetRoas

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

الحقول
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

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

TargetingSetting

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

الحقول
target_restrictions[]

TargetRestriction

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

TextAsset

مادة عرض نصية

الحقول
text

string

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

TextLabel

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

الحقول
background_color

string

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

description

string

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

UnifiedCallAsset

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

الحقول
country_code

string

رمز البلد المكوّن من حرفَين لرقم الهاتف. أمثلة: "الولايات المتحدة" و"الولايات المتحدة".

phone_number

string

رقم الهاتف الأولي للمعلِن. أمثلة: '1234567890'، '(123)456-7890'

call_conversion_reporting_state

CallConversionReportingState

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

call_conversion_action

string

إجراء الإحالة الناجحة الذي يتم تحديد مصدر إحالة ناجحة للمكالمات عليه. وفي حال ترك هذه السياسة بدون ضبط، يتم استخدام إجراء الإحالة الناجحة التلقائي. لن يكون لهذا الحقل تأثير إلا إذا تم ضبط call_conversion_reporting_state على USE_LOCATION_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" وعلى "خرائط 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 للصفحات.

UnifiedSitelinkAsset

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

الحقول
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 Ads.

mobile_preferred

bool

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

UserListInfo

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

الحقول
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

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

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