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

عناصر التحكّم وفلترة المستودع الإعلاني للإعلانات العمودية

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

نظرة عامة

يتناول هذا الدليل ميزتَين رئيسيتَين لإدارة الإعلانات العمودية:

عناصر التحكّم في أشكال الإعلانات: يمكنك تفعيل أشكال إعلانات معيّنة أو إيقافها (الإعلانات النصية وروابط الحجز وإعلانات الترويج لقطاعات معيّنة) على مستوى المجموعة الإعلانية.
إدارة عناصر الإعلانات في مجال معيّن: يمكنك فلترة مستودع إعلاني معيّن واستهدافه من خلاصتك المرتبطة بمجال معيّن (المعروفة سابقًا باسم خلاصة السفر) باستخدام نظام مستند إلى القواعد يتضمّن SharedSet وSharedCriterion.

المتطلبات الأساسية

قبل تنفيذ هذه الميزات، تأكَّد من أنّ حملتك تستوفي المتطلبات التالية:

نوع الحملة: يجب أن تكون "حملة على شبكة البحث".
خلاصة بيانات عمودية: يجب ربط خلاصة بيانات عمودية نشطة على مستوى العميل أو الحملة. اطّلِع على المقالة ربط خلاصات بيانات المجال على مستوى الحملة لربط خلاصة على مستوى الحملة. يؤدي ربط خلاصة بيانات لمجال معيّن إلى تفعيل خلاصات السفر في "الإعلانات على شبكة البحث" (TFSA) وإتاحة عناصر التحكّم في الإعلانات لمجال معيّن في الحملة.
ميزات AI Max في "الحملات على شبكة بحث Google": يجب تفعيل إعداد ميزات "AI Max في الحملات على شبكة بحث Google" في الحملة.

ربط خلاصات بيانات المجال على مستوى الحملة

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

أنشئ عنصر CampaignAssetSet، واضبط asset_set على اسم المورد لمجموعة مواد عرض الخلاصة في مجال معيّن و campaign على اسم المورد لحملتك.
أنشئ CampaignAssetSetOperation مع ضبط create على CampaignAssetSet.
أرسِل العملية باستخدام CampaignAssetSetService.MutateCampaignAssetSets.

لمزيد من التفاصيل حول إدارة خلاصات السفر على نطاق واسع، يُرجى الرجوع إلى مستند خلاصات السفر في "الإعلانات على شبكة البحث".

عناصر التحكّم في أشكال الإعلانات على مستوى المجموعة الإعلانية

يمكنك ضبط أشكال الإعلانات العمودية النشطة لمجموعة إعلانية معيّنة. تتم إدارة ذلك من خلال حقل vertical_ads_format_setting (VerticalAdsFormatSetting) في مورد AdGroup.

الأشكال المتاحة

الإعلانات النصية (disable_text_ads): تكون مفعَّلة تلقائيًا. ويمكن إيقافها.
روابط الحجز (enable_booking_links): يجب الموافقة على تفعيل الميزة. تتوفّر هذه الميزة فقط للخلاصات في المجالين HOTELS وTHINGS_TO_DO.
إعلانات العروض الترويجية العمودية (enable_vertical_promotion_ads): يجب الموافقة على تفعيل الميزة.

قواعد التحقّق من الصحة

لا يمكنك إيقاف جميع الأشكال الثلاثة في الوقت نفسه لمجموعة إعلانية واحدة.
لا يمكن ضبط enable_booking_links على true إلا عندما تكون الخلاصة العمودية النشطة للحملة هي HOTELS أو THINGS_TO_DO.
لا تنطبق هذه الإعدادات إلا على نوعَي المجموعات الإعلانية SEARCH_STANDARD وSEARCH_DYNAMIC_ADS.

مثال: تعديل إعدادات التنسيق

يوضّح مثال Java التالي كيفية إيقاف الإعلانات النصية وتفعيل إعلانات الترويج في فئات معيّنة لمجموعة إعلانية حالية:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .setVerticalAdsFormatSetting(
        AdGroup.VerticalAdsFormatSetting.newBuilder()
            .setDisableTextAds(true)
            .setEnableBookingLinks(false)
            .setEnableVerticalPromotionAds(true)
    )
    .build();

AdGroupOperation operation = AdGroupOperation.newBuilder()
    .setUpdate(adGroupToUpdate)
    .setUpdateMask(FieldMasks.allSetFieldsOf(adGroupToUpdate))
    .build();

// Submit the operation using AdGroupService...

إدارة عناصر الإعلانات العمودية

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

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

يستخدم نموذج البيانات منهج المعايير المشتركة:

‫SharedSet: يمكنك إنشاء SharedSet من النوع VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
SharedCriterion: أضِف قواعد (معايير) إلى هذه المجموعة. تحدّد كل قاعدة سمة، مثل "المدينة" أو "فئة الفندق"، وقيمة. يمكنك أيضًا إنشاء معايير سلبية لاستبعاد العناصر.
AdGroupCriterion: اربط SharedSet بجهاز AdGroup باستخدام AdGroupCriterion (vertical_ads_item_group_rule_list).

الأبعاد المعتمدة

يمكنك فلترة الكيانات استنادًا إلى السمات التالية في SharedCriterion (VerticalAdsItemGroupRuleInfo)، استنادًا إلى vertical_ads_item_vertical_type في SharedSet:

item_code: رقم تعريف بيانات معيّن (متوافق مع جميع أنواع المجالات)
‫city_criterion_id وregion_criterion_id وcountry_criterion_id: أسماء موارد ثابتة للموقع الجغرافي المستهدَف (geoTargetConstants/{id}، متوافقة مع جميع أنواع المجالات باستثناء FLIGHTS).
‫hotel_class: التقييم بالنجوم من 1 إلى 5 (HOTELS فقط)
‫user_rating (بدءًا من v24): تقييم المستخدمين مقرَّبًا إلى أقرب عدد صحيح من 1 إلى 5 (THINGS_TO_DO فقط)
‫venue وevent_participant_display_name (بدءًا من v24): فلاتر مكان الحدث والاسم المعروض للمشاركين (EVENTS فقط)

مثال على الرمز البرمجي: إنشاء القواعد وربطها

ينشئ مثال Python هذا قاعدة لتضمين الفنادق في "بوسطن" أو "سان فرانسيسكو" واستبعاد الفنادق من فئة "نجمة واحدة" و "نجمتَين":

# 1. Create the SharedSet
shared_set_operation = client.get_type("SharedSetOperation")
shared_set = shared_set_operation.create
shared_set.name = "Boston/SF Premium Hotels"
shared_set.type_ = (
    client.enums.SharedSetTypeEnum.VERTICAL_ADS_ITEM_GROUP_RULE_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

# 2. Add Criteria (Rules) to the SharedSet
shared_criteria_operations = []

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
included_city_ids = [1006543, 1014221]  # Geo Target Constant IDs
for city_id in included_city_ids:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.city_criterion_id = (
      geo_target_constant_service.geo_target_constant_path(city_id)
  )
  shared_criteria_operations.append(op)

# Rule B: Exclude 1 and 2 Star Hotels
excluded_stars = [1, 2]
for star_rating in excluded_stars:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.hotel_class = star_rating
  criterion.negative = True  # Mark as exclusion
  shared_criteria_operations.append(op)

# Submit SharedCriterionOperations...

# 3. Link to AdGroup
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
agc_operation = client.get_type("AdGroupCriterionOperation")
agc = agc_operation.create
agc.ad_group = ad_group_resource_name
agc.status = client.enums.AdGroupCriterionStatusEnum.ENABLED
agc.vertical_ads_item_group_rule_list.shared_set = shared_set_resource_name

# Submit AdGroupCriterionOperation...

عروض أسعار النقرة اليدوية لكل جهة

اعتبارًا من v25، بالنسبة إلى "الحملات على شبكة البحث للسفر" (أي "الحملات على شبكة البحث" التي تم فيها تفعيل ميزات "AI Max في الحملات على شبكة بحث Google" وخلاصة فنادق مرتبطة) والتي تستخدم استراتيجية عروض أسعار النقرة اليدوية (BiddingStrategyType.MANUAL_CPC)، يمكنك ضبط تجاوزات عروض أسعار النقرة اليدوية (cpc_bid_micros) لعناصر خلاصة الفنادق الفردية باستخدام معيار EntityBid (ad_group_criterion.entity_bid) مع CriterionType.VERTICAL_ADS_ITEM_BID وentity_bid.item_code.

لا تتوافق المعايير السلبية (negative = true) والحملات غير التابعة لشبكة البحث واستراتيجيات عروض الأسعار المبرمَجة أو الذكية مع VERTICAL_ADS_ITEM_BID وتُرجع ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT. لا تتم تعبئة مقاييس الأداء في معايير "VERTICAL_ADS_ITEM_BID". للحصول على تفاصيل المخطط الكاملة وطلبات بحث GAQL وأمثلة على حمولة البيانات المتحوّلة، يُرجى الاطّلاع على عروض أسعار النقرة اليدوية لكل كيان في دليل "خلاصات السفر في الإعلانات على شبكة البحث". لضبط تعديلات عروض أسعار المجموعات الإعلانية المضاعفة على مستوى سمات برنامج الرحلة لإعلانات الفنادق باستخدام AdGroupBidModifier، يُرجى الاطّلاع على تعديل عروض الأسعار باستخدام تعديلات عروض الأسعار.

تقارير الأداء

يمكنك استرداد مقاييس الأداء للإعلانات في قطاعات معيّنة باستخدام الطريقتَين GoogleAdsService.SearchStream أو GoogleAdsService.Search.

شرائح الإعلانات العمودية

segments.vertical_ads_hotel_class: قيمة عددية صحيحة (من نجمة واحدة إلى 5 نجوم) تحدّد تقييم الفئة لبيانات فندق
‫segments.vertical_ads_listing: معرّف لقائمة إعلانات عمودية معيّنة
segments.vertical_ads_listing_brand: العلامة التجارية المرتبطة بقائمة إعلانات في مجال معيّن
‫segments.vertical_ads_listing_city: المدينة المرتبطة ببيانات المنتج
‫segments.vertical_ads_listing_country: البلد المرتبط ببيانات المنتج
‫segments.vertical_ads_listing_region: المنطقة المرتبطة ببيانات المنتج.
segments.vertical_ads_partner_account: حساب الشريك ضمن "مركز الشركاء" (مثل Hotel Center) الذي يوفّر بيانات خلاصة المستودع
‫segments.vertical_ads_vertical: نوع المجال، مثل فندق أو سيارة مستأجرة
‫segments.vertical_ads_event_participant_display_names: تمثّل هذه السمة الأسماء المعروضة للمشاركين في بيانات الفعالية، مثل المؤدين أو المتحدثين أو الفِرق.
segments.vertical_ads_listing_user_rating (بدءًا من v24): قيمة عدد صحيح (من 1 إلى 5) تحدّد تقييم المستخدم لقائمة الإعلانات في المجال المعنيّ.
segments.vertical_ads_listing_venue (بدءًا من v24): اسم المكان المخصّص لقائمة الإعلانات العمودية (على سبيل المثال، مكان إقامة حفلة موسيقية).
segments.vertical_ads_price_tier (اعتبارًا من v25): فئة مكانة السعر في المنافسة النسبية لبيانات الفنادق
segments.vertical_ads_rate_rule_id (بدءًا من v25): معرّف سلسلة يتوافق مع قواعد الأسعار الخاصة أو المشروطة المطبَّقة على عرض السعر أو مرّة الظهور
segments.vertical_ads_rate_type (اعتبارًا من v25): تصنيف نوع السعر العلني أو الخاص أو المشروط

شرائح سمات برامج الرحلات

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

‫segments.advance_booking_window: فترة الحجز المُسبَق لبرنامج الرحلة بالأيام
‫segments.length_of_booking: مدة الحجز لبرنامج الرحلة بالأيام
segments.start_date: تاريخ بدء الحجز بالتنسيق yyyy-MM-dd
‫segments.start_day_of_week: يوم بدء الحجز من الأسبوع
segments.user_set_dates: تشير إلى ما إذا تم اختيار تواريخ محدّدة من قِبل المستخدم (USER_SELECTED أو DEFAULT_SELECTION).

مقاييس "الإعلانات العمودية"

اعتبارًا من v25، يمكنك استرداد مقاييس الإعلانات العمودية التالية:

metrics.vertical_ads_potential_impressions: مرّات الظهور المحتملة التي تمثّل إجمالي مرّات الظهور المؤهَّلة التي تم تحديد سقف لها والمتاحة في سياق طلب البحث.
metrics.vertical_ads_average_booking_value_micros: يشير هذا الحقل إلى متوسط السعر اليومي المرجّح بالنقرات بالوحدات الصغرى، بما في ذلك الضرائب والرسوم، على مدار إجمالي مدة الإقامة.
metrics.vertical_ads_price_difference_percentage: النسبة المئوية للفرق بين السعر الذي يقدّمه المعلِن وأدنى سعر منافس للفندق نفسه.

أمثلة على طلبات GAQL

يستردّ طلب البحث هذا مقاييس الإعلانات العمودية التنافسية ومقاييس الحجز مقسّمة حسب المدينة التي يقع فيها الفندق وفئة السعر ونوع السعر:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.vertical_ads_price_tier,
  segments.vertical_ads_rate_type,
  metrics.vertical_ads_potential_impressions,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

يقسّم هذا الطلب مقاييس الأداء العادية حسب سمات حجز برنامج الرحلة:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.clicks,
  metrics.all_conversions_value
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

معالجة الأخطاء

في ما يلي الأخطاء الشائعة التي قد تواجهها عند ضبط الإعلانات العمودية:

رمز الخطأ	السبب	الإجراء المقترَح
`AdGroupError.INVALID_VERTICAL_ADS_FORMAT_SETTING`	تم إيقاف أشكال الإعلانات الثلاثة (الإعلانات النصية، والإعلانات مع روابط للحجز، وإعلانات عروض الفنادق) في الوقت نفسه، أو تم تفعيل `enable_booking_links` لمجال آخر غير `HOTELS` أو `THINGS_TO_DO`.	تأكَّد من تفعيل شكل واحد على الأقل في `VerticalAdsFormatSetting`، وفعِّل روابط الحجز فقط لخلاصات `HOTELS` أو `THINGS_TO_DO`.
`AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX`	لم يتم تفعيل ميزات "AI Max في الحملات على شبكة بحث Google" في الحملة.	فعِّل ميزات "AI Max في الحملات على شبكة بحث Google" في إعدادات الحملة.
`AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED`	لا تتضمّن الحملة خلاصة بيانات عمودية نشطة.	تأكَّد من ربط خلاصة مجال معيّن صالحة على مستوى العميل أو الحملة.
`CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST`	اسم المورد `SharedSet` المقدَّم في `AdGroupCriterion` غير متوفّر أو ليس من النوع `VERTICAL_ADS_ITEM_GROUP_RULE_LIST`.	يُرجى التأكّد من أنّ اسم المورد "`shared_set`" يشير إلى "`SharedSet`" حالي من النوع `VERTICAL_ADS_ITEM_GROUP_RULE_LIST`.
`CriterionError.CANNOT_ADD_REMOVED_VERTICAL_ADS_ITEM_GROUP_RULE_LIST_SHARED_SET`	إنّ `SharedSet` المُشار إليه في `AdGroupCriterion` يحمل الحالة `REMOVED`.	يجب الإشارة إلى `SharedSet` مفعَّل من النوع `VERTICAL_ADS_ITEM_GROUP_RULE_LIST`.
`CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE`	سمة المعيار المستخدَمة غير متاحة للمجال المحدّد، مثل تصنيف الفندق لتأجير السيارات.	تأكَّد من أنّ السمة `vertical_ads_item_group_rule` تتطابق مع نوع المجال.