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

توفّر الإعلانات العمودية ميزات متخصّصة في "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): يجب الموافقة على تفعيل الميزة.
• إعلانات العروض الترويجية العمودية (enable_vertical_promotion_ads): يجب الموافقة على تفعيل الميزة.

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

• لا يمكنك إيقاف جميع التنسيقات الثلاثة في الوقت نفسه لمجموعة إعلانية واحدة.
• لا تنطبق هذه الإعدادات إلا على نوعَي المجموعات الإعلانية 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(
        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):

• item_code: رقم تعريف خاص بالبيانات
• ‫city_criterion_id وregion_criterion_id وcountry_criterion_id: أسماء موارد Geo Target Constant (geoTargetConstants/{id}).
• hotel_class: التقييم بالنجوم (من 1 إلى 5)
• ‫user_rating وvenue وevent_participant_display_name (بدءًا من v24): فلاتر خاصة بتقييم الفعاليات والنتائج العمودية، والمكان، واسم المشارك

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

ينشئ مثال 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.

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

• ‫segments.vertical_ads_hotel_class: قيمة عدد صحيح تتراوح بين 1 و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 (بدءًا من v24): تمثّل هذه السمة الأسماء المعروضة للمشاركين في بطاقة بيانات الفعالية، مثل الفنانين أو المتحدثين أو الفِرق.
• 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.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

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

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