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 على الرابط https://support.google.com/sa360/answer/9250611.

all_conversions_by_conversion_date

double

إجمالي عدد التحويلات. ويشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمة include_in_conversions_metric. عند تحديد هذا العمود مع التاريخ، تعني القيم في عمود التاريخ تاريخ الإحالة الناجحة. تتوفّر تفاصيل عن أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.

conversion_custom_metrics[]

Value

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

conversions_value_by_conversion_date

double

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

conversions_by_conversion_date

double

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

historical_creative_quality_score

QualityScoreBucket

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

historical_landing_page_quality_score

QualityScoreBucket

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

historical_search_predicted_ctr

QualityScoreBucket

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

interaction_event_types[]

InteractionEventType

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

raw_event_conversion_metrics[]

Value

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

absolute_top_impression_percentage

double

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

all_conversions_from_interactions_rate

double

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

all_conversions_value

double

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

all_conversions

double

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

all_conversions_value_per_cost

double

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

all_conversions_from_click_to_call

double

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

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

all_conversions_from_directions

double

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

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

all_conversions_from_interactions_value_per_interaction

double

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

all_conversions_from_menu

double

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

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

all_conversions_from_order

double

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

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

all_conversions_from_other_engagement

double

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

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

all_conversions_from_store_visit

double

العدد المقدّر للمرّات التي زار فيها العملاء متجرًا بعد النقر على إعلان.

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

visits

double

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

all_conversions_from_store_website

double

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

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

average_cost

double

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

average_cpc

double

التكلفة الإجمالية لجميع النقرات مقسومة على إجمالي عدد النقرات التي تم تلقّيها هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

average_cpm

double

متوسط التكلفة لكل ألف ظهور هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة 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) والتكلفة لكل ألف ظهور خلال هذه الفترة. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة 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_by_conversion_date

double

عدد الإحالات الناجحة باستخدام أكثر من جهاز واحد حسب تاريخ الإحالة الناجحة تتوفّر تفاصيل عن أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.

cross_device_conversions_value

double

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

cross_device_conversions_value_by_conversion_date

double

مجموع قيمة الإحالات الناجحة على جميع الأجهزة حسب تاريخ الإحالة الناجحة تتوفّر تفاصيل عن أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.

ctr

double

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

conversions

double

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

conversions_value

double

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

average_quality_score

double

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

historical_quality_score

int64

نقاط الجودة للفترات السابقة

impressions

int64

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

interaction_rate

double

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

interactions

int64

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

invalid_click_rate

double

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

invalid_clicks

int64

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

general_invalid_click_rate

double

النسبة المئوية للنقرات التي تم استبعادها من إجمالي عدد النقرات (النقرات المستبعَدة + النقرات غير المستبعَدة) لأنّها نقرات غير صالحة عامة. هذه هي النقرات التي تعتبرها Google غير مشروعة ويتم رصدها من خلال وسائل الفلترة الروتينية (أي الزيارات المعروفة غير الصالحة لمراكز البيانات أو برامج التتبّع أو العناكب أو برامج الزحف الأخرى أو الأنماط غير المنتظمة وما إلى ذلك). ولا يتم تحميلك تكلفة هذه النقرات، ولا تؤثر في إحصاءات حسابك. يمكنك الاطّلاع على صفحة المساعدة على https://support.google.com/campaignmanager/answer/6076504 للحصول على التفاصيل.

general_invalid_clicks

int64

عدد النقرات غير الصالحة العامة هذه هي مجموعة فرعية من النقرات غير الصالحة التي يتمّ رصدها من خلال وسائل الفلترة الروتينية (مثل الزيارات المعروفة غير الصالحة لمراكز البيانات أو برامج التتبّع أو برامج العنكبوت أو برامج الزحف الأخرى أو الأنماط غير المنتظمة أو ما إلى ذلك). ولا يتم تحميلك تكلفة هذه النقرات، ولا تؤثر في إحصاءات حسابك. يمكنك الاطّلاع على صفحة المساعدة على https://support.google.com/campaignmanager/answer/6076504 للحصول على التفاصيل.

mobile_friendly_clicks_percentage

double

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

search_absolute_top_impression_share

double

النسبة المئوية لمرات ظهور إعلانات Shopping أو الإعلانات على شبكة البحث التي تظهر في أبرز مواضع Shopping. يمكنك الاطّلاع على https://support.google.com/sa360/answer/9566729 للحصول على التفاصيل. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.

search_budget_lost_absolute_top_impression_share

double

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

search_budget_lost_impression_share

double

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

search_budget_lost_top_impression_share

double

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

search_click_share

double

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

search_exact_match_impression_share

double

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

search_impression_share

double

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

search_rank_lost_absolute_top_impression_share

double

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

search_rank_lost_impression_share

double

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

search_rank_lost_top_impression_share

double

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

search_top_impression_share

double

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

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

top_impression_percentage

double

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

value_per_all_conversions

double

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

value_per_all_conversions_by_conversion_date

double

قيمة جميع الإحالات الناجحة مقسومة على عدد جميع الإحالات الناجحة عند تحديد هذا العمود مع التاريخ، تعني القيم في عمود التاريخ تاريخ الإحالة الناجحة. تتوفّر تفاصيل عن أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.

value_per_conversion

double

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

value_per_conversions_by_conversion_date

double

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

client_account_view_through_conversions

int64

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

client_account_cross_sell_cost_of_goods_sold_micros

int64

تكلفة السلع المُباعة من خلال بيع منتجات إضافية في حساب العميل هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً للإعلان عن منتج مختلف. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. بناءً على ما سبق، تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross_sell_cost_of_goods_sold_micros

int64

تكلفة السلع المُباعة من خلال بيع منتجات إضافية (COGS) هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً لإعلان عن منتج مختلف. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. بناءً على ما سبق، تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_cross_sell_gross_profit_micros

int64

الأرباح الإجمالية من بيع منتجات إضافية في حساب العميل هي الأرباح التي تحقّقها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross_sell_gross_profit_micros

int64

الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي تحقّقها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_cross_sell_revenue_micros

int64

الأرباح من بيع المنتجات الإضافية في حساب العميل هي إجمالي المبلغ الذي حقّقته من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross_sell_revenue_micros

int64

الأرباح من بيع المنتجات الإضافية هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_cross_sell_units_sold

double

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

cross_sell_units_sold

double

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

client_account_lead_cost_of_goods_sold_micros

int64

تكلفة السلع المُباعة للعملاء المحتملِين في حساب العميل هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ احتساب تكلفة هذه السلع ضمن تكلفة السلع المُباعة للعملاء المحتملِين. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

lead_cost_of_goods_sold_micros

int64

تكلفة السلع المُباعة للعملاء المحتملِين هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ احتساب تكلفة هذه السلع ضمن تكلفة السلع المُباعة للعملاء المحتملِين. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_lead_gross_profit_micros

int64

الأرباح الإجمالية من العملاء المحتملِين في حساب العميل هي الأرباح التي تحقّقها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

lead_gross_profit_micros

int64

الأرباح الإجمالية من العملاء المحتملِين هي الأرباح التي تحقِقّها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_lead_revenue_micros

int64

الأرباح من العملاء المحتملِين في حساب العميل هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الإيرادات من العملاء المحتملين لهذا الطلب 10 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

lead_revenue_micros

int64

الأرباح من العملاء المحتملِين هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. مثال: نقر أحد المستخدِمين على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الإيرادات من العملاء المحتملين لهذا الطلب 10 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_lead_units_sold

double

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

lead_units_sold

double

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

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"

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

AdNetworkType

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

conversion_action_category

ConversionActionCategory

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

conversion_custom_dimensions[]

Value

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

day_of_week

DayOfWeek

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

device

Device

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

keyword

Keyword

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

product_channel

ProductChannel

قناة المنتج

product_channel_exclusivity

ProductChannelExclusivity

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

product_condition

ProductCondition

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

product_sold_condition

ProductCondition

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

raw_event_conversion_dimensions[]

Value

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

conversion_action

string

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

conversion_action_name

string

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

date

string

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

geo_target_city

string

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

geo_target_country

string

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

geo_target_metro

string

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

geo_target_region

string

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

hour

int32

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

month

string

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

product_bidding_category_level1

string

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

product_bidding_category_level2

string

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

product_bidding_category_level3

string

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

product_bidding_category_level4

string

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

product_bidding_category_level5

string

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

product_brand

string

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

product_country

string

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

product_custom_attribute0

string

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

product_custom_attribute1

string

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

product_custom_attribute2

string

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

product_custom_attribute3

string

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

product_custom_attribute4

string

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

product_item_id

string

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

product_language

string

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

product_sold_bidding_category_level1

string

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

product_sold_bidding_category_level2

string

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

product_sold_bidding_category_level3

string

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

product_sold_bidding_category_level4

string

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

product_sold_bidding_category_level5

string

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

product_sold_brand

string

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

product_sold_custom_attribute0

string

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

product_sold_custom_attribute1

string

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

product_sold_custom_attribute2

string

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

product_sold_custom_attribute3

string

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

product_sold_custom_attribute4

string

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

product_sold_item_id

string

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

product_sold_title

string

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

product_sold_type_l1

string

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

product_sold_type_l2

string

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

product_sold_type_l3

string

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

product_sold_type_l4

string

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

product_sold_type_l5

string

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

product_store_id

string

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

product_title

string

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

product_type_l1

string

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

product_type_l2

string

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

product_type_l3

string

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

product_type_l4

string

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

product_type_l5

string

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

quarter

string

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

week

string

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

year

int32

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

asset_interaction_target

AssetInteractionTarget

يتم استخدامها فقط مع مقاييس CustomerAsset وCampaignAsset وAdGroupAsset. توضّح هذه السمة ما إذا كانت مقاييس التفاعل قد حدثت على مادة العرض نفسها أو على مادة عرض أو وحدة إعلانية مختلفة. يتم احتساب التفاعلات (مثل النقرات) في جميع أجزاء الإعلان المعروض (مثل الإعلان نفسه والمكوّنات الأخرى، مثل روابط أقسام الموقع) عند عرضها معًا. عندما تكون قيمة interaction_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 يساوي 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" وعلى "خرائط Google". هذا الحقل فريد لمعرّف عميل ونوع مادة عرض معيّنَين. يمكنك الانتقال إلى https://developers.google.com/places/web-service/place-id لمعرفة المزيد عن معرّف المكان.

business_profile_locations[]

BusinessProfileLocation

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

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

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

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