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

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

نظرة عامة

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

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

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

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

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

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

  1. أنشئ عنصر CampaignAssetSet، مع ضبط asset_set على اسم مرجع مجموعة مواد عرض الخلاصة العمودية وcampaign على اسم مرجع حملتك.
  2. أنشئ CampaignAssetSetOperation مع ضبط create على CampaignAssetSet.
  3. أرسِل العملية باستخدام 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...

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

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

طريقة عمل نموذج البيانات

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

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

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

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

  • ‫item_code: رقم تعريف خاص بالبطاقة (متاح لجميع أنواع المجالات)
  • ‫city_criterion_id وregion_criterion_id وcountry_criterion_id: أسماء موارد Geo Target Constant (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...

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

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

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

شرائح سمات خطوط السير

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

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

اعتبارًا من 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 تتطابق مع نوع السوق المتخصّص.