Package google.ads.searchads360.v0.common

الفهرس

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

نص مادة العرض

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

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

store_code

string

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

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

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

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

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

FinalAppUrl

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

الحقول
os_type

AppUrlOperatingSystemType

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

url

string

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

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

اسم مصدر AdGroupCriterion.

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

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

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

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 في لمحة عن عمود "كلّ الإحالات الناجحة".

all_conversions_by_conversion_date

double

إجمالي عدد التحويلات. ويشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمة include_in_conversions_metric. عند اختيار هذا العمود مع التاريخ، تعني القيم في عمود التاريخ تاريخ الإحالة الناجحة. تتوفّر تفاصيل عن أعمدة by_conversion_date في لمحة عن عمود "كلّ الإحالات الناجحة".

conversion_custom_metrics[]

Value

مقاييس الإحالات الناجحة المخصّصة

conversions_value_by_conversion_date

double

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

conversions_by_conversion_date

double

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

historical_creative_quality_score

QualityScoreBucket

تمثّل هذه السمة نقاط الجودة السابقة لتصميم الإعلان.

historical_landing_page_quality_score

QualityScoreBucket

جودة تجربة الصفحة المقصودة للفترات السابقة

historical_search_predicted_ctr

QualityScoreBucket

نسبة النقر إلى الظهور المتوقّعة في "بحث Google" للفترات السابقة

interaction_event_types[]

InteractionEventType

أنواع التفاعلات المدفوعة والمجانية

raw_event_conversion_metrics[]

Value

مقاييس الإحالات الناجحة للأحداث الأولية

absolute_top_impression_percentage

double

"نسبة ظهور الإعلان في صدارة الصفحة على شبكة البحث" هي النسبة المئوية لمرات ظهور إعلانك في أبرز موضع على "شبكة البحث".

all_conversions_from_interactions_rate

double

جميع الإحالات الناجحة الناتجة من التفاعلات (على عكس الإحالات الناجحة بعد رؤية الإعلان فقط) مقسومة على عدد التفاعلات مع الإعلانات

all_conversions_value

double

تمثّل هذه السمة قيمة جميع الإحالات الناجحة.

all_conversions

double

إجمالي عدد التحويلات. ويشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمة include_in_conversions_metric.

all_conversions_value_per_cost

double

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

all_conversions_from_click_to_call

double

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

ينطبق هذا المقياس على عناصر الخلاصة فقط.

all_conversions_from_directions

double

عدد المرّات التي نقر فيها المستخدمون على زر "الحصول على الاتجاهات" للانتقال إلى نشاط تجاري بعد النقر على إعلان.

ينطبق هذا المقياس على عناصر الخلاصة فقط.

all_conversions_from_interactions_value_per_interaction

double

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

all_conversions_from_menu

double

عدد المرّات التي نقر فيها الأشخاص على رابط لعرض قائمة مؤسسة بعد النقر على إعلان.

ينطبق هذا المقياس على عناصر الخلاصة فقط.

all_conversions_from_order

double

عدد المرّات التي قدَّم فيها الأشخاص طلبًا في مؤسسة بعد النقر على إعلان

ينطبق هذا المقياس على عناصر الخلاصة فقط.

all_conversions_from_other_engagement

double

عدد الإحالات الناجحة الأخرى (مثل، نشر مراجعة أو حفظ موقع جغرافي لمؤسسة) التي حدثت بعد نقر المستخدمين على إعلان.

ينطبق هذا المقياس على عناصر الخلاصة فقط.

all_conversions_from_store_visit

double

العدد المقدّر لمرّات زيارة المستخدمين لنشاط تجاري بعد النقر على إعلان

ينطبق هذا المقياس على عناصر الخلاصة فقط.

visits

double

النقرات التي سجّلتها "إعلانات شبكة البحث 360" بنجاح وأعادت توجيهها إلى الصفحة المقصودة للمعلِن

all_conversions_from_store_website

double

عدد المرّات التي تمّ فيها توجيه الأشخاص إلى عنوان URL لنشاط تجاري بعد النقر على إعلان.

ينطبق هذا المقياس على عناصر الخلاصة فقط.

average_cost

double

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

average_cpc

double

التكلفة الإجمالية لجميع النقرات مقسومة على إجمالي عدد النقرات التي تم تلقّيها هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency في عبارة PARAMETERS.

average_cpm

double

متوسط التكلفة لكل ألف ظهور هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency في عبارة PARAMETERS.

clicks

int64

عدد النقرات

content_budget_lost_impression_share

double

النسبة المئوية المقدَّرة لعدد المرّات التي كان فيها إعلانك مؤهَّلاً للظهور على "الشبكة الإعلانية" ولكنّه لم يظهر بسبب انخفاض ميزانيتك. ملاحظة: يتم تسجيل نسبة عدم ظهور الإعلان المفقودة بسبب ميزانية المحتوى في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.

content_impression_share

double

يشير هذا المقياس إلى عدد مرّات الظهور التي سجَّلها إعلانك على "الشبكة الإعلانية" مقسومًا على العدد المقدَّر لمرّات الظهور التي كنت مؤهَّلاً للحصول عليها.

ملاحظة: يتم عرض نسبة ظهور الإعلان في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.

content_rank_lost_impression_share

double

النسبة المئوية المقدَّرة لمرّات الظهور على "الشبكة الإعلانية" التي لم تتلقّها إعلاناتك بسبب انخفاض ترتيب الإعلان.

ملاحظة: يتم تسجيل نسبة عدم ظهور الإعلان المفقودة بسبب ترتيب المحتوى في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.

conversions_from_interactions_rate

double

متوسّط الإحالات الناجحة القابلة للمزايدة (من التفاعل) لكل تفاعل مؤهَّل للإحالة الناجحة توضّح هذه السمة عدد المرات التي يؤدي فيها تفاعل مع الإعلان إلى إحالة ناجحة قابلة للمزايدة، في المتوسط.

client_account_conversions_value

double

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

conversions_value_per_cost

double

قيمة الإحالة الناجحة القابلة للمزايدة مقسومة على التكلفة الإجمالية للتفاعلات المؤهَّلة للإحالة الناجحة

conversions_from_interactions_value_per_interaction

double

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

client_account_conversions

double

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

cost_micros

int64

مجموع تكلفة النقرة (CPC) والتكلفة لكل ألف ظهور خلال هذه الفترة. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency في عبارة PARAMETERS لمزيد من التفاصيل.

cost_per_all_conversions

double

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

cost_per_conversion

double

متوسط التكلفة المؤهّلة للإحالة الناجحة لكلّ إحالة ناجحة قابلة للمزايدة.

cost_per_current_model_attributed_conversion

double

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

cross_device_conversions

double

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

cross_device_conversions_by_conversion_date

double

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

cross_device_conversions_value

double

مجموع قيمة الإحالات الناجحة على جميع الأجهزة

cross_device_conversions_value_by_conversion_date

double

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

ctr

double

عدد النقرات التي يتلقّاها إعلانك (النقرات) مقسومًا على عدد مرات عرض إعلانك (مرات الظهور).

conversions

double

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

conversions_value

double

مجموع قيم الإحالات الناجحة المُضمّنة في حقل "الإحالات الناجحة" يُعدّ هذا المقياس مفيدًا فقط إذا أدخلت قيمة لإجراءات الإحالات الناجحة.

average_quality_score

double

متوسط نقاط الجودة

historical_quality_score

int64

تمثّل هذه السمة نقاط الجودة للفترات السابقة.

impressions

int64

عدد مرّات ظهور إعلانك على صفحة نتائج بحث أو موقع إلكتروني على "شبكة Google"

interaction_rate

double

عدد مرات تفاعل الأشخاص مع إعلانك بعد ظهوره لهم. وهو عدد التفاعلات مقسومًا على عدد مرّات عرض إعلانك.

interactions

int64

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

invalid_click_rate

double

النسبة المئوية للنقرات التي تمت فلترتها من إجمالي عدد النقرات (النقرات التي تمت فلترتها + النقرات التي لم تتم فلترتها) خلال الفترة المشمولة بالتقارير

invalid_clicks

int64

عدد النقرات التي تعتبرها Google غير مشروعة ولا تحصّل رسومًا منك مقابلها

general_invalid_click_rate

double

النسبة المئوية للنقرات التي تم استبعادها من إجمالي عدد النقرات (النقرات المستبعَدة + النقرات غير المستبعَدة) لأنّها نقرات غير صالحة عامة. هذه هي النقرات التي تعتبرها Google غير مشروعة ويتم رصدها من خلال وسائل الفلترة الروتينية (أي الزيارات المعروفة غير الصالحة لمراكز البيانات أو برامج التتبّع أو العناكب أو برامج الزحف الأخرى أو الأنماط غير المنتظمة وما إلى ذلك). ولا يتم تحميلك تكلفة هذه النقرات، ولا تؤثر في إحصاءات حسابك. اطّلِع على فلترة الزيارات غير الصالحة لضمان الجودة.

general_invalid_clicks

int64

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

mobile_friendly_clicks_percentage

double

النسبة المئوية للنقرات على الأجهزة الجوّالة التي تؤدي إلى صفحة متوافقة مع الأجهزة الجوّالة

search_absolute_top_impression_share

double

النسبة المئوية لمرّات ظهور إعلانات Shopping أو الإعلانات على شبكة البحث التي تظهر في أبرز مواضع Shopping. راجِع مقالة لمحة عن مقياسَي "إعلانات أعلى الصفحة" و"إعلانات الصدارة في أعلى الصفحة" للحصول على التفاصيل. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.

search_budget_lost_absolute_top_impression_share

double

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

ملاحظة: يتمّ تسجيل "نسبة عدم ظهور الإعلان في صدارة الصفحة على شبكة البحث" (الميزانية) في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.

search_budget_lost_impression_share

double

النسبة المئوية المقدَّرة لعدد المرّات التي كان فيها إعلانك مؤهَّلاً للظهور على "شبكة البحث" ولكنّه لم يظهر لأنّ ميزانيتك كانت منخفضة جدًا.

ملاحظة: يتم عرض نسبة عدم ظهور الإعلان المفقودة في شبكة البحث بسبب الميزانية في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.

search_budget_lost_top_impression_share

double

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

ملاحظة: يتمّ تسجيل "نسبة عدم ظهور الإعلان في أعلى الصفحة على شبكة البحث" (الميزانية) في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.

search_click_share

double

عدد النقرات التي تلقّيتها على "شبكة البحث" مقسومًا على العدد المقدَّر للنقرات التي كنت مؤهَّلاً للحصول عليها

ملاحظة: يتم تسجيل نسبة النقر على الإعلان في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.

search_exact_match_impression_share

double

عدد مرّات الظهور التي حصلت عليها مقسومًا على العدد المقدَّر لمرّات الظهور التي كنت مؤهّلاً للحصول عليها في "شبكة البحث" عن عبارات البحث التي تطابقت تمامًا مع كلماتك الرئيسية (أو كانت عبارة عن صيغ قريبة لكلمتك الرئيسية)، بغض النظر عن أنواع مطابقة كلماتك الرئيسية.

ملاحظة: يتم تسجيل نسبة ظهور الإعلان بمطابقة تامة في شبكة البحث في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.

search_impression_share

double

يشير هذا المقياس إلى عدد مرّات الظهور التي سجَّلها إعلانك على "شبكة البحث" مقسومًا على العدد المقدَّر لمرّات الظهور التي كنت مؤهَّلاً للحصول عليها.

ملاحظة: يتمّ تسجيل نسبة ظهور الإعلان في البحث في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.

search_rank_lost_absolute_top_impression_share

double

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

ملاحظة: يتم عرض "نسبة عدم ظهور الإعلان في صدارة الصفحة على شبكة البحث" (الترتيب) في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.

search_rank_lost_impression_share

double

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

search_rank_lost_top_impression_share

double

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

ملاحظة: يتمّ تسجيل "نسبة عدم ظهور الإعلان في أعلى الصفحة على شبكة البحث" في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.

search_top_impression_share

double

عدد مرات الظهور التي تلقّاها إعلانك بين الإعلانات في أعلى الصفحة مقارنةً بالعدد المقدَّر لمرات الظهور التي كان إعلانك مؤهَّلاً للحصول عليها ليُعرض بين الإعلانات في أعلى الصفحة ملاحظة: يتمّ تسجيل "نسبة ظهور الإعلان في أعلى الصفحة على شبكة البحث" في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.

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

top_impression_percentage

double

هي النسبة المئوية لمرات ظهور إعلانك بجانب أهم نتائج البحث المجاني.

value_per_all_conversions

double

قيمة جميع الإحالات الناجحة مقسومة على عدد جميع الإحالات الناجحة

value_per_all_conversions_by_conversion_date

double

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

value_per_conversion

double

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

value_per_conversions_by_conversion_date

double

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

client_account_view_through_conversions

int64

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

orders

double

تشير "الطلبات" إلى إجمالي عدد إحالاتك الناجحة المتمثّلة بعملية شراء، والتي يعود مصدرها إلى إعلاناتك.

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

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

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

average_order_value_micros

int64

متوسّط قيمة طلب الشراء هو متوسّط الإيرادات التي حقّقتها لكلّ طلب منسوب إلى إعلاناتك.

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

مثال: تلقّيت 3 طلبات حقّقت إيرادات بقيمة 10 دولار أمريكي و15 دولار أمريكي و20 دولار أمريكي. متوسّط قيمة طلب الشراء هو 15 دولارًا أمريكيًا = (10 دولارات أمريكية + 15 دولارًا أمريكيًا + 20 دولارًا أمريكيًا)/3.

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

average_cart_size

double

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

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

مثال: تلقّيت طلبَين، تضمّن الطلب الأوّل 3 منتجات والطلب الثاني منتجَين. يبلغ متوسّط حجم سلة التسوّق 2.5 منتج = (3+2)/2.

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

cost_of_goods_sold_micros

int64

تكلفة السلع المُباعة هي إجمالي تكلفة المنتجات التي بِعتها في الطلبات المنسوبة إلى إعلاناتك.

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

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة لهذا الطلب 8 دولار أمريكي = 3 دولار أمريكي + 5 دولار أمريكي.

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

gross_profit_micros

int64

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

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

مثال: نقر شخص ما على إعلان Shopping يعرِض قبّعة، ثمّ اشترى القبّعة نفسها مع قميص من خلال طلب على موقعك الإلكتروني. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ قيمة تكلفة السلع المُباعة للقبّعة ‏$3، لكنّ القميص ليس له أيّ قيمة تكلفة للسلع المُباعة. ولن تأخذ الأرباح الإجمالية لهذا الطلب في الاعتبار سوى القبّعة، لذا سيكون المبلغ 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي.

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

gross_profit_margin

double

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

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. هامش الربح الإجمالي هو إجمالي الأرباح التي حقّقتها بعد قسمته على إجمالي الإيرادات وضربه في %100. لا تتضمّن العمليات الحسابية لهوامش الربح الإجمالية سوى المنتجات التي يكون لها قيمة تكلفة سلع مُباعة في Merchant Center.

مثال: اشترى شخص ما قبّعة وقميصًا من خلال طلب على موقعك الإلكتروني. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ويبلغ سعر القميص 20 دولار أمريكي، ولكن ليس له قيمة تكلفة سلع مُباعة. لن يأخذ هامش الربح الإجمالي لهذا الطلب في الاعتبار سوى القبعة لأنّ لها قيمة تكلفة سلع مُباعة، وبذلك تكون النسبة% 70 = (10 دولار أمريكي - 3 دولار أمريكي)/10 دولار أمريكي × %100.

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

revenue_micros

int64

الأرباح هي إجمالي المبلغ الذي تكسبه من الطلبات التي يكون مصدرها إعلاناتك.

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. الأرباح هي القيمة الإجمالية لجميع الطلبات التي تلقّيتها والتي يكون مصدرها إعلاناتك، بعد طرح أيّ خصم.

مثال: نقر شخص ما على إعلان Shopping يعرِض قبّعة، ثمّ اشترى القبّعة نفسها مع قميص من خلال طلب على موقعك الإلكتروني. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. يتم تطبيق خصم بقيمة 5 دولار أمريكي على الطلب بكامله. تبلغ الأرباح من هذا الطلب 25 دولار أمريكي = 10 دولار أمريكي + 20 دولار أمريكي - 5 دولار أمريكي.

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

units_sold

double

الوحدات المُباعة هي إجمالي عدد المنتجات المُباعة من الطلبات التي يعود مصدرها إلى إعلاناتك.

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. الوحدات المُباعة هي إجمالي عدد المنتجات المُباعة من جميع الطلبات التي يعود مصدرها إلى إعلاناتك.

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة في هذا الطلب هي 3.

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

client_account_cross_sell_cost_of_goods_sold_micros

int64

تكلفة السلع المُباعة من خلال بيع منتجات إضافية في حساب العميل هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً للإعلان عن منتج مختلف.

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها.

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. بناءً على ما سبق، تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي.

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

cross_sell_cost_of_goods_sold_micros

int64

تكلفة السلع المُباعة من خلال بيع منتجات إضافية (COGS) هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً لإعلان عن منتج مختلف.

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها.

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. بناءً على ما سبق، تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي.

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

client_account_cross_sell_gross_profit_micros

int64

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

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها.

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5.

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

cross_sell_gross_profit_micros

int64

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

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها.

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5.

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

هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency في عبارة PARAMETERS.

client_account_cross_sell_revenue_micros

int64

إيرادات بيع المنتجات الإضافية في حساب العميل هي إجمالي المبلغ الذي حقّقته من المنتجات المُباعة نتيجة للإعلان عن منتج آخر.

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك.

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي.

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

cross_sell_revenue_micros

int64

الأرباح من بيع المنتجات الإضافية هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن منتج آخر.

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك.

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي.

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

client_account_cross_sell_units_sold

double

الوحدات المُباعة من خلال بيع منتجات إضافية في حساب العميل هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة الإعلان عن منتج آخر.

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الوحدات المُباعة من خلال بيع منتجات إضافية هي إجمالي عدد المنتجات التي تمّ بيعها من خلال جميع الطلبات المنسوبة إلى إعلاناتك.

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

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

cross_sell_units_sold

double

الوحدات المُباعة من خلال بيع منتجات إضافية هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة الإعلان عن منتج آخر.

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الوحدات المُباعة من خلال بيع منتجات إضافية هي إجمالي عدد المنتجات التي تمّ بيعها من خلال جميع الطلبات المنسوبة إلى إعلاناتك.

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

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

client_account_lead_cost_of_goods_sold_micros

int64

تكلفة السلع المُباعة للعملاء المحتملِين في حساب العميل هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه.

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

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي.

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

lead_cost_of_goods_sold_micros

int64

تكلفة السلع المُباعة للعملاء المحتملِين هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه.

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

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي.

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

client_account_lead_gross_profit_micros

int64

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

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين.

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي.

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

lead_gross_profit_micros

int64

الأرباح الإجمالية من العملاء المحتملِين هي الأرباح التي تحقِقّها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها.

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين.

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي.

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

client_account_lead_revenue_micros

int64

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

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

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الإيرادات من العملاء المحتملين لهذا الطلب 10 دولار أمريكي.

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

lead_revenue_micros

int64

الأرباح من العملاء المحتملِين هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه.

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

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الإيرادات من العملاء المحتملين لهذا الطلب 10 دولار أمريكي.

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

client_account_lead_units_sold

double

الوحدات المُباعة للعملاء المحتملِين في حساب العميل هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة للإعلان عن المنتج نفسه.

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمنتجات المُباعة، يظهر إجمالي عدد هذه المنتجات المُباعة ضمن "الوحدات المُباعة للعملاء المحتملِين".

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة للعملاء المحتملِين في هذا الطلب هي 1.

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

lead_units_sold

double

الوحدات المُباعة للعملاء المحتملِين هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة للإعلان عن المنتج نفسه.

طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمنتجات المُباعة، يظهر إجمالي عدد هذه المنتجات المُباعة ضمن "الوحدات المُباعة للعملاء المحتملِين".

مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة للعملاء المحتملِين في هذا الطلب هي 1.

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

unique_users

int64

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

average_impression_frequency_per_user

double

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

MobileAppAsset

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

الحقول
app_id

string

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

app_store

MobileAppVendor

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

PercentCpc

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

الحقول
cpc_bid_ceiling_micros

int64

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

enhanced_cpc_enabled

bool

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

RealTimeBiddingSetting

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

الحقول
opt_in

bool

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

SearchAds360ExpandedDynamicSearchAdInfo

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

الحقول
description1

string

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

description2

string

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

ad_tracking_id

int64

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

SearchAds360ExpandedTextAdInfo

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

الحقول
headline

string

عنوان الإعلان.

headline2

string

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

headline3

string

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

description1

string

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

description2

string

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

path1

string

النص الذي يتم إلحاقه بعنوان URL المرئي الذي تم إنشاؤه تلقائيًا باستخدام محدِّد

path2

string

نص مُلحق بـ path1 مع محدد

ad_tracking_id

int64

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

SearchAds360ProductAdInfo

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

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

SearchAds360ResponsiveSearchAdInfo

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

الحقول
headlines[]

AdTextAsset

قائمة بمواد العرض النصية للعناوين عند عرض الإعلان، سيتم اختيار العناوين من هذه القائمة.

descriptions[]

AdTextAsset

قائمة بمواد العرض النصية الخاصة بالأوصاف عند عرض الإعلان، سيتم اختيار الأوصاف من هذه القائمة.

path1

string

النص الذي يتم إلحاقه بعنوان URL المرئي الذي تم إنشاؤه تلقائيًا باستخدام محدِّد

path2

string

نص مُلحق بـ path1 مع محدد

ad_tracking_id

int64

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

SearchAds360TextAdInfo

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

الحقول
headline

string

عنوان الإعلان.

description1

string

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

description2

string

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

display_url

string

عنوان URL المعروض للإعلان

display_mobile_url

string

عنوان URL المعروض للإعلان على الأجهزة الجوّالة

ad_tracking_id

int64

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

الشرائح

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

الحقول
ad_format_type

AdFormatType

نوع شكل الإعلان

ad_network_type

AdNetworkType

نوع شبكة الإعلانات

conversion_action_category

ConversionActionCategory

فئة إجراء الإحالة الناجحة

conversion_custom_dimensions[]

Value

سمات الإحالة الناجحة المخصّصة

day_of_week

DayOfWeek

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

device

Device

الجهاز الذي تنطبق عليه المقاييس

keyword

Keyword

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

product_channel

ProductChannel

قناة المنتج

product_channel_exclusivity

ProductChannelExclusivity

تُستخدَم لتحديد ما إذا كان المنتج متوفّرًا حصريًا على قناة معيّنة.

product_condition

ProductCondition

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

product_sold_condition

ProductCondition

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

raw_event_conversion_dimensions[]

Value

سمات الإحالات الناجحة على مستوى الحدث الأولية

conversion_action

string

اسم مورد إجراء الإحالة الناجحة.

conversion_action_name

string

اسم إجراء الإحالة الناجحة.

date

string

التاريخ الذي تنطبق عليه المقاييس، بالتنسيق yyyy-MM-dd، مثلاً ‎2018-04-17

geo_target_city

string

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

geo_target_country

string

اسم المورد لثابت الاستهداف الجغرافي الذي يمثّل بلدًا

geo_target_metro

string

اسم المورد لثابت الاستهداف الجغرافي الذي يمثّل مدينة كبرى

geo_target_postal_code

string

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

geo_target_region

string

اسم المورد لثابت الاستهداف الجغرافي الذي يمثّل منطقة

hour

int32

ساعة اليوم كعدد بين 0 و23، شاملة.

month

string

الشهر كما هو ممثّل بتاريخ اليوم الأول من الشهر يجب أن يكون التنسيق yyyy-MM-dd.

product_bidding_category_level1

string

فئة عروض الأسعار (المستوى 1) للمنتج.

product_bidding_category_level2

string

فئة عروض الأسعار (المستوى 2) للمنتج.

product_bidding_category_level3

string

فئة عروض الأسعار (المستوى 3) للمنتج.

product_bidding_category_level4

string

فئة عروض الأسعار (المستوى 4) للمنتج.

product_bidding_category_level5

string

فئة عروض الأسعار (المستوى 5) للمنتج.

product_brand

string

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

product_country

string

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

product_custom_attribute0

string

السمة المخصّصة 0 للمنتج.

product_custom_attribute1

string

السمة المخصّصة 1 للمنتج.

product_custom_attribute2

string

السمة المخصّصة 2 للمنتج

product_custom_attribute3

string

السمة المخصّصة 3 للمنتج

product_custom_attribute4

string

السمة المخصّصة 4 للمنتج

product_item_id

string

معرّف السلعة للمنتج.

product_language

string

اسم المورد لثابت اللغة الذي يمثّل لغة المنتج.

product_sold_bidding_category_level1

string

فئة عروض الأسعار (المستوى 1) للمنتج المُباع.

product_sold_bidding_category_level2

string

فئة عروض الأسعار (المستوى 2) للمنتج المُباع

product_sold_bidding_category_level3

string

فئة عروض الأسعار (المستوى 3) للمنتج المُباع

product_sold_bidding_category_level4

string

فئة عروض الأسعار (المستوى 4) للمنتج المُباع

product_sold_bidding_category_level5

string

فئة عروض الأسعار (المستوى 5) للمنتج المُباع.

product_sold_brand

string

تمثّل هذه السمة العلامة التجارية للمنتج المباع.

product_sold_custom_attribute0

string

السمة المخصّصة 0 للمنتج المُباع.

product_sold_custom_attribute1

string

السمة المخصّصة 1 للمنتج المُباع.

product_sold_custom_attribute2

string

السمة المخصّصة 2 للمنتج المُباع.

product_sold_custom_attribute3

string

السمة المخصّصة 3 للمنتج المُباع.

product_sold_custom_attribute4

string

السمة المخصّصة 4 للمنتج المُباع.

product_sold_item_id

string

معرّف السلعة للمنتج المُباع.

product_sold_title

string

عنوان المنتج المُباع.

product_sold_type_l1

string

نوع المنتج المُباع (المستوى 1)

product_sold_type_l2

string

نوع المنتج المُباع (المستوى 2)

product_sold_type_l3

string

نوع المنتج المُباع (المستوى 3)

product_sold_type_l4

string

نوع المنتج المُباع (المستوى 4)

product_sold_type_l5

string

نوع المنتج المُباع (المستوى 5)

product_store_id

string

معرّف المنتج في المتجر

product_title

string

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

product_type_l1

string

نوع المنتج (المستوى 1)

product_type_l2

string

نوع المنتج (المستوى 2)

product_type_l3

string

نوع المنتج (المستوى 3)

product_type_l4

string

نوع المنتج (المستوى 4)

product_type_l5

string

تمثّل هذه السمة نوع المنتج (المستوى 5).

quarter

string

الربع كما هو ممثّل بتاريخ اليوم الأول من الربع يستخدم السنة التقويمية للأرباع، على سبيل المثال، يبدأ الربع الثاني من عام 2018 في 2018-04-01. يجب أن يكون التنسيق yyyy-MM-dd.

vertical_ads_event_participant_display_names

string

تمثّل هذه السمة الأسماء المعروضة للمشاركين في بطاقة بيانات الفعالية، مثل المؤدين أو المتحدثين أو الفرق.

vertical_ads_hotel_class

int64

فئة الفندق يتراوح عادةً بين نجمة واحدة و5 نجوم، ولكن يمكن تخصيصه بالكامل في خلاصة الفندق.

vertical_ads_listing

string

البيانات المرتبطة بمرّة ظهور أو نقرة أو إحالة ناجحة خاصة ببيانات محلية

vertical_ads_listing_brand

string

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

vertical_ads_listing_city

string

المدينة التي يقع فيها إدراج الإعلانات العمودية

vertical_ads_listing_country

string

البلد الذي يقع فيه إدراج الإعلانات العمودية.

vertical_ads_listing_region

string

المنطقة التي يقع فيها إدراج الإعلانات العمودية

vertical_ads_partner_account

int64

حساب شريك معيّن ضمن "مركز الشركاء" (على سبيل المثال، "مركز إدارة معلومات الفنادق") يوفّر بيانات خلاصة المستودع الإعلاني لـ "الإعلانات العمودية".

vertical_ads_vertical

VerticalAdsItemVerticalType

نوع الإعلان الخاص بفئة معيّنة، مثل "أماكن للاستئجار" أو "تأجير السيارات" أو "الفعاليات"، ويُستخدم لتصنيف البيانات وتقسيمها في سياق "الإعلانات الخاصة بفئة معيّنة"

week

string

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

year

int32

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

asset_interaction_target

AssetInteractionTarget

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

SyntheticContentAttestation

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

الحقول
status

SyntheticContentAttestationStatus

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

source

SyntheticContentSource

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

SyntheticContentInfo

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

الحقول
advertiser_attestation

SyntheticContentAttestation

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

system_attestation

SyntheticContentAttestation

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

TargetCpa

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

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

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

TargetOutrankShare

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

الحقول
cpc_bid_ceiling_micros

Int64Value

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

TargetRestriction

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

الحقول
targeting_dimension

TargetingDimension

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

bid_only

bool

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

TargetRoas

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

الحقول
target_roas

double

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

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

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

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

description

string

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

UnifiedCallAsset

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

الحقول
country_code

string

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

phone_number

string

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

call_conversion_reporting_state

CallConversionReportingState

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

call_conversion_action

string

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

ad_schedule_targets[]

AdScheduleInfo

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

call_only

bool

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

call_tracking_enabled

bool

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

use_searcher_time_zone

bool

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

start_date

string

تمثّل هذه السمة تاريخ بدء صلاحية هذا الأصل وإمكانية عرضه، وذلك بالتنسيق yyyy-MM-dd.

end_date

string

تمثّل هذه السمة آخر تاريخ تكون فيه مادة العرض هذه فعّالة ولا تزال معروضة، وذلك بالتنسيق yyyy-MM-dd.

UnifiedCalloutAsset

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

الحقول
callout_text

string

نص وسيلة الشرح يجب أن يتراوح طول هذه السلسلة بين 1 و25 حرفًا، بما في ذلك القيمتان.

start_date

string

تمثّل هذه السمة تاريخ بدء صلاحية هذا الأصل وإمكانية عرضه، وذلك بالتنسيق yyyy-MM-dd.

end_date

string

تمثّل هذه السمة آخر تاريخ تكون فيه مادة العرض هذه فعّالة ولا تزال معروضة، وذلك بالتنسيق yyyy-MM-dd.

ad_schedule_targets[]

AdScheduleInfo

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

use_searcher_time_zone

bool

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

UnifiedLocationAsset

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

الحقول
place_id

string

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

business_profile_locations[]

BusinessProfileLocation

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

location_ownership_type

LocationOwnershipType

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

UnifiedPageFeedAsset

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

الحقول
page_url

string

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

labels[]

string

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

UnifiedSitelinkAsset

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

الحقول
description1

string

السطر الأول من وصف رابط أقسام الموقع. في حال ضبط هذه السمة، يجب أن يتراوح طولها بين 1 و35 حرفًا، ويجب ضبط السمة description2 أيضًا.

description2

string

السطر الثاني من وصف رابط أقسام الموقع. في حال ضبطها، يجب أن يتراوح الطول بين 1 و35 حرفًا، ويجب ضبط description1 أيضًا.

start_date

string

تمثّل هذه السمة تاريخ بدء صلاحية هذا الأصل وإمكانية عرضه، وذلك بالتنسيق yyyy-MM-dd.

end_date

string

تمثّل هذه السمة آخر تاريخ تكون فيه مادة العرض هذه فعّالة ولا تزال معروضة، وذلك بالتنسيق yyyy-MM-dd.

ad_schedule_targets[]

AdScheduleInfo

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

tracking_id

int64

المعرّف المستخدَم لتتبُّع النقرات لمادة عرض رابط إلى قسم الموقع هذا حساب Yahoo!. حقل خاص باليابان فقط

use_searcher_time_zone

bool

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

mobile_preferred

bool

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

UserListInfo

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

الحقول
user_list

string

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

القيمة

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

الحقول
حقل الربط value قيمة يمكن أن يكون التعليق value إحدى القيم التالية فقط:
boolean_value

bool

قيمة منطقية

int64_value

int64

تمثّل هذه السمة عددًا صحيحًا من النوع int64.

float_value

float

قيمة عددية ذات فاصلة عشرية

double_value

double

مزدوجة

string_value

string

سلسلة

WebpageConditionInfo

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

الحقول
operand

WebpageConditionOperand

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

operator

WebpageConditionOperator

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

argument

string

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

WebpageInfo

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

الحقول
conditions[]

WebpageConditionInfo

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

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

coverage_percentage

double

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

criterion_name

string

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

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

YoutubeVideoAsset

مادة عرض على YouTube

الحقول
youtube_video_title

string

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

youtube_video_id

string

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