تستخدم 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: النسبة المئوية للفرق بين السعر الذي يقدّمه المعلِن وأدنى سعر منافس للفندق نفسه.

اعتبارًا من v26، يمكنك أيضًا الاستعلام عن مقياسَي metrics.search_top_impression_share وmetrics.search_click_share إلى جانب كلّ من شرائح segments.vertical_ads_* وشرائح سمة برنامج الرحلة.

لا يمكنك اختيار مقاييس metrics.vertical_ads_* مع شرائح سمات برنامج الرحلة (segments.advance_booking_window وsegments.length_of_booking وsegments.start_date وsegments.start_day_of_week وsegments.user_set_dates).
تتوافق شرائح سمة برنامج الرحلة فقط مع شرائح الإعلانات في قطاعات معيّنة على مستوى البيانات وعلى مستوى الشريك (segments.vertical_ads_hotel_class و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 وsegments.vertical_ads_vertical).
لا يمكنك دمج شرائح الإعلانات العمودية الخاصة بالأسعار والخاصة بالفعاليات (segments.vertical_ads_price_tier وsegments.vertical_ads_rate_rule_id وsegments.vertical_ads_rate_type وsegments.vertical_ads_event_participant_display_names وsegments.vertical_ads_listing_user_rating وsegments.vertical_ads_listing_venue) مع شرائح سمة برنامج الرحلة.

أمثلة على طلبات 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,
  metrics.search_top_impression_share,
  metrics.search_click_share
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,
  metrics.search_top_impression_share,
  metrics.search_click_share
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` تتطابق مع نوع المجال.