کنترل‌ها و فیلتر کردن موجودی برای تبلیغات عمودی

تبلیغات عمودی ویژگی‌های تخصصی را برای کمپین‌های جستجوی مجهز به هوش مصنوعی مکس که به یک فید عمودی مانند هتل‌ها مرتبط هستند، ارائه می‌دهند. شما می‌توانید کنترل کنید که کدام قالب‌های تبلیغات عمودی در سطح گروه تبلیغاتی ارائه شوند و می‌توانید با استفاده از قوانین گروه آیتم‌های تبلیغات عمودی، کنترل کنید که کدام موجودیت‌های فید هدف قرار گیرند.

نمای کلی

این راهنما دو ویژگی اصلی برای مدیریت تبلیغات عمودی را پوشش می‌دهد:

1. کنترل‌های قالب: در سطح گروه تبلیغاتی، قالب‌های تبلیغاتی خاص (تبلیغات متنی، لینک‌های رزرو و تبلیغات تبلیغاتی عمودی) را انتخاب یا از آنها انصراف دهید.
2. مدیریت آیتم‌های تبلیغات عمودی: با استفاده از یک سیستم مبتنی بر قانون که شامل SharedSet and SharedCriterion می‌شود، موجودی خاص را از فید عمودی (که قبلاً سفر نامیده می‌شد) مرتبط خود فیلتر و هدف قرار دهید.

پیش‌نیازها

قبل از پیاده‌سازی این ویژگی‌ها، مطمئن شوید که کمپین شما الزامات زیر را برآورده می‌کند:

• نوع کمپین: باید یک کمپین جستجو باشد.
• فید عمودی: یک فید داده عمودی فعال باید به کمپین متصل باشد.
• حداکثر هوش مصنوعی: تنظیمات «حداکثر هوش مصنوعی» باید در کمپین فعال باشد.

توجه: اگر سعی کنید تنظیمات کنترل قالب را در کمپین‌هایی بدون AI Max یا فید داده عمودی فعال تغییر دهید، منجر به خطای VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED خواهد شد. به طور مشابه، اگر سعی کنید مدیریت آیتم‌ها را در چنین کمپین‌هایی تغییر دهید، منجر به خطای VERTICAL_ADS_ITEM_GROUP_RULE_LIST_NOT_SUPPORTED خواهد شد.

کنترل‌های قالب گروه‌های تبلیغاتی

اکنون می‌توانید پیکربندی کنید که کدام قالب‌های تبلیغات عمودی برای یک گروه تبلیغاتی خاص فعال باشند. این کار از طریق فیلد vertical_ads_format_setting در منبع AdGroup مدیریت می‌شود.

فرمت‌های موجود

• تبلیغات متنی: به طور پیش‌فرض فعال است. می‌توان آن را غیرفعال کرد.
• لینک‌های رزرو: ثبت نام الزامی است.
• تبلیغات عمودی: ثبت نام الزامی است.

قوانین اعتبارسنجی

• شما نمی‌توانید همزمان از هر سه قالب برای یک گروه تبلیغاتی واحد صرف نظر کنید.
• این تنظیمات فقط برای انواع گروه‌های تبلیغاتی STANDARD و SEARCH_DYNAMIC_ADS اعمال می‌شود.

مثال: به‌روزرسانی تنظیمات قالب

مثال زیر نحوه غیرفعال کردن تبلیغات متنی و فعال کردن تبلیغات عمودی برای یک گروه تبلیغاتی موجود را نشان می‌دهد.

جاوا

// Assuming 'adGroup' is an existing AdGroup object.
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName()) // Example: "customers/{id}/adGroups/{id}"
    .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 : با استفاده از AdGroupCriterion SharedSet به AdGroup خود لینک دهید.

ابعاد پشتیبانی شده

شما می‌توانید موجودیت‌ها را بر اساس ابعاد زیر در SharedCriterion فیلتر کنید:

• item_code : شناسه‌ی خاص فهرست.
• city_criterion_id region_criterion_id country_criterion_id
• brand_text : نام تجاری.
• hotel_class : رتبه‌بندی ستاره (۱-۵).
• vertical_ads_item_category : دسته‌بندی، مانند CONCERT .

مثال کد: ایجاد و پیوند دادن قوانین

این مثال قانونی ایجاد می‌کند که اقلام موجود در «بوستون» یا «سانفرانسیسکو» را شامل شود و هتل‌های «یک ستاره» و «دو ستاره» را شامل نشود.

پایتون

# 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_LISTshared_set.vertical_ads_item_vertical_type = client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
# Submit SharedSetOperation...

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

# Rule A: Include Boston and SF
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 = 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
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 بازیابی کنید. برای API تبلیغات گوگل، نسخه ۲۳ بخش‌های خاصی را برای گزارش‌دهی جزئی اضافه کرده است.

بخش‌های جدید

• segments.vertical_ads_listing_city : شهری که با آگهی مرتبط است.
• segments.vertical_ads_vertical_type : نوع عمودی، مانند هتل یا ماشین کرایه‌ای.

نمونه پرس و جو GAQL

SQL

SELECT
  segments.vertical_ads_listing_city,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.impressions
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

مدیریت خطا

اینها خطاهای رایجی هستند که ممکن است هنگام پیکربندی تبلیغات عمودی با آنها مواجه شوید.

کد خطا	علت	اقدام توصیه شده
INVALID_VERTICAL_ADS_FORMAT_SETTING	هر سه قالب تبلیغ (متن، لینک رزرو، تبلیغات ویژه) به طور همزمان غیرفعال شدند.	مطمئن شوید که حداقل یک فرمت در VerticalAdsFormatSetting فعال باشد (روی true تنظیم شده باشد).
VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_...	این کمپین فاقد قابلیت AI Max است یا فید عمودی فعال ندارد.	فعال کردن AI Max در تنظیمات کمپین و اطمینان از اتصال فید عمودی معتبر.
VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST	نام منبع SharedSet ارائه شده در AdGroupCriterion وجود ندارد.	تأیید کنید که نام منبع shared_set با یک مجموعه ایجاد شده مطابقت دارد.
VERTICAL_ADS_ITEM_GROUP_RULE_IS_NOT_SUPPORTED...	نوع معیار مورد استفاده برای رده خاص، مانند کلاس هتل برای اجاره خودرو، پشتیبانی نمی‌شود.	بررسی کنید که بُعد vertical_ads_item_group_rule با نوع عمودی شما مطابقت داشته باشد.