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

توفّر الإعلانات العمودية ميزات متخصّصة لـ "الحملات على شبكة البحث" التي تم تفعيل ميزات 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...

عروض أسعار النقرة اليدوية على مستوى كل عنصر

اعتبارًا من 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 وأمثلة على حمولات التعديل، راجِع مقالة عروض أسعار النقرة اليدوية لكل كيان على حدة في دليل "خلاصات السفر في الإعلانات على شبكة البحث".

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

يمكنك استرداد مقاييس الأداء للإعلانات العمودية باستخدام الطريقتَين 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

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

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