فیدهای سفر در «آگهی‌های جستجوها»

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

نحوه تعامل تنظیمات مشتری و تنظیمات پویش

به‌طور پیش‌فرض، پویش‌ها پیوندهای فید سفر (TRAVEL_FEED مجموعه دارایی) را از سطح مشتری ازطریق CustomerAssetSet انجمن‌ها به‌ارث می‌برند. برای لغو تنظیمات سطح مشتری برای پویشی خاص، باید TRAVEL_FEED را به فیلد excluded_parent_asset_set_types پویش اضافه کنید و پیوندهای خاص پویش را بااستفاده از CampaignAssetSet مدیریت کنید.

• به‌ارث بردن فیدهای مشتری (پیش‌فرض): سطح مشتری را CustomerAssetSet پیوندشده نگه دارید و مطمئن شوید Campaign.excluded_parent_asset_set_types حاوی TRAVEL_FEED نباشد.
• انصراف در سطح مشتری: ارتباط سطح مشتری را بردارید CustomerAssetSet و ارتباط سطح پویش را پیوند ندهید CampaignAssetSet.
• انصراف دادن از پویشی خاص: TRAVEL_FEED را به Campaign.excluded_parent_asset_set_types اضافه کنید و هرگونه CampaignAssetSet مورد منسوب در سطح پویش را بردارید.
• موافقت کردن فقط برای پویشی خاص: ارتباط سطح مشتری CustomerAssetSet را بردارید، سپس پیوند سطح پویش CampaignAssetSet را برای آن پویش ایجاد کنید.
• استفاده از فیدهای ویژه پویش درحالی‌که پویش‌های دیگر همچنان به ارث بردن ادامه می‌دهند: TRAVEL_FEED را به Campaign.excluded_parent_asset_set_types پویش اضافه کنید، و پیوند CampaignAssetSet سطح پویش برای آن ایجاد کنید.

انصراف دادن از «فیدهای سفر در آگهی‌های شبکه جستجو»

اگر ترجیح می‌دهید از این ویژگی استفاده نکنید، می‌توانید از Google Ads API برای انصراف از «فیدهای سفر» در «آگهی‌های جستجو» در سطح مشتری و پویش استفاده کنید.

انصراف در سطح مشتری

برای انصراف دادن از «فیدهای سفر» در «آگهی‌های جستجو» در سطح مشتری، کارهای زیر را انجام دهید:

1. بازیابی customer_asset_set.resource_name و asset_set.resource_name برای همه پیوندهای CustomerAssetSet که نوع آن‌ها TRAVEL_FEED است بااستفاده از گزارش customer_asset_set:

   SELECT
     customer_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM customer_asset_set
   WHERE asset_set.type = 'TRAVEL_FEED'
   

2. برای هر customer_asset_set.resource_name، یک CustomerAssetSetOperation ایجاد کنید و remove را روی customer_asset_set.resource_name بازیابی‌شده در مرحله قبل تنظیم کنید.

3. بااستفاده از اشیای CustomerAssetSetOperation ایجادشده، درخواستی به CustomerAssetSetService.MutateCustomerAssetSets ارسال کنید.

اگر می‌خواهید دوباره در سطح مشتری با این ویژگی موافقت کنید:

1. برای هر AssetSet (asset_set.resource_name) زیربنایی که می‌خواهید پیوند دهید، یک CustomerAssetSet جدید ایجاد کنید و asset_set را روی asset_set.resource_name و customer را روی نام منبع مشتری‌تان تنظیم کنید.
2. برای هر CustomerAssetSet که در مرحله قبلی ایجاد شده است، CustomerAssetSetOperation با create تنظیم‌شده روی CustomerAssetSet ایجاد کنید.
3. بااستفاده از اشیای CustomerAssetSetOperation ایجادشده، درخواستی به CustomerAssetSetService.MutateCustomerAssetSets ارسال کنید.

انصراف دادن در سطح پویش

برای انصراف دادن از «فیدهای سفر» در «آگهی‌های جستجو» در سطح پویش، ابتدا باید وضعیت موافقت موروثی را از سطح مشتری مستثنا کنید:

1. بازیابی excluded_parent_asset_set_types بااستفاده از گزارش campaign:

   SELECT
     campaign.excluded_parent_asset_set_types
   FROM campaign
   WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'
   

2. شیء Campaign جدیدی ایجاد کنید که excluded_parent_asset_set_types آن روی مقادیر قبلی به‌علاوه TRAVEL_FEED تنظیم شده باشد و resource_name روی نام منبع پویشتان تنظیم شده باشد.

3. CampaignOperation ایجاد کنید و update را روی Campaign که قبلاً ایجاد شده است و update_mask به‌طور متناظر تنظیم کنید.

4. درخواستی را به CampaignService.MutateCampaigns بااستفاده از CampaignOperation ایجادشده در مرحله قبلی ارسال کنید.

سپس، همه موارد منسوب به فید سفر سطح پویش را بردارید:

1. برای پویشی که می‌خواهید انصراف دهید، هر دو campaign_asset_set.resource_name و asset_set.resource_name را برای همه CampaignAssetSet پیوندهایی که نوع آن‌ها TRAVEL_FEED است بااستفاده از campaign_asset_set گزارش بازیابی کنید:

   SELECT
     campaign_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM campaign_asset_set
   WHERE campaign_asset_set.campaign =
       'INSERT_YOUR_CAMPAIGN_RESOURCE_NAME'
     AND asset_set.type = 'TRAVEL_FEED'
   

2. برای هر campaign_asset_set.resource_name، یک CampaignAssetSetOperation ایجاد کنید و remove را روی campaign_asset_set.resource_name بازیابی‌شده در مرحله قبل تنظیم کنید.

3. بااستفاده از اشیای CampaignAssetSetOperation ایجادشده، درخواستی به CampaignAssetSetService.MutateCampaignAssetSets ارسال کنید.

اگر می‌خواهید دوباره در سطح پویش با این ویژگی موافقت کنید:

1. برای هر AssetSet (asset_set.resource_name) زیربنایی که می‌خواهید موافقت کنید، CampaignAssetSet جدیدی با asset_set تنظیم‌شده روی asset_set.resource_name و campaign تنظیم‌شده روی نام منبع پویشتان بسازید.
2. برای هر CampaignAssetSet که در مرحله قبلی ایجاد شده است، CampaignAssetSetOperation با create تنظیم‌شده روی CampaignAssetSet ایجاد کنید.
3. بااستفاده از اشیای CampaignAssetSetOperation ایجادشده، درخواستی به CampaignAssetSetService.MutateCampaignAssetSets ارسال کنید.

بازیابی وضعیت موافقت در سطح مشتری برای پویش

برای اینکه وضعیت موافقت پویش دوباره تنظیم سطح مشتری را به‌ارث ببرد، این مراحل را دنبال کنید:

1. با excluded_parent_asset_set_types بدون TRAVEL_FEED در فهرست و resource_name تنظیم‌شده روی نام منبع پویش شما، شیء Campaign جدیدی ایجاد کنید.
2. CampaignOperation ایجاد کنید و update را روی Campaign که قبلاً ایجاد شده است و update_mask به‌طور متناظر تنظیم کنید.
3. درخواستی به CampaignService.MutateCampaigns بااستفاده از CampaignOperation ایجادشده در مرحله قبلی ارسال کنید.

پیشنهاد قیمت کلیک‌بهای دستی برای هر نهاد

از Google Ads API v25، می‌توانید پیشنهاد قیمت کلیک‌بهای دستی را برای هر نهاد در هتل‌ها در «کمپین‌های جستجوی سفر» بااستفاده از منبع AdGroupCriterion با نوع معیار CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid) لغو کنید.

پیش‌نیازها و الزامات سازگاری

برای ایجاد و مدیریت معیارهای VERTICAL_ADS_ITEM_BID، باید شرایط زیر برآورده شود:

• نوع پویش: «پویش‌های جستجو برای سفر» (پویش‌های جستجو، AdvertisingChannelType.SEARCH، با «بیشینه‌سازی هوشواره‌ای» ویژه پویش‌های «جستجو» فعال Campaign.ai_max_setting.enable_ai_max و فید هتل منسوب [مجموعه دارایی TRAVEL_FEED]؛ فقط فیدهای هتل پشتیبانی می‌شوند).
• استراتژی پیشنهاد قیمت: فقط «کلیک‌بهای دستی» (BiddingStrategyType.MANUAL_CPC).
  • در استراتژی‌های خودکارسازی‌شده یا «پیشنهاد قیمت هوشمند» (مثل «بیشینه‌سازی تبدیل‌ها»، «بیشینه‌سازی مقدار تبدیل»، «کنش‌بهای هدف»، یا «برگشت هزینه‌های تبلیغات هدف») پشتیبانی نمی‌شود.
• فقط معیارهای مثبت: negative باید روی false تنظیم شود. پیشنهاد قیمت‌های عنصر منفی پشتیبانی نمی‌شود.
• شناسه نهاد و قیمت پیشنهادی الزامی: entity_bid.item_code و cpc_bid_micros هنگام ایجاد معیار قیمت پیشنهادی نهاد الزامی هستند.

تعاریف طرح‌واره و فیلد

• منبع: AdGroupCriterion (ad_group_criterion)
• قالب نام منبع: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• نوع معیار enum: CriterionType.VERTICAL_ADS_ITEM_BID
• پیام: EntityBid (ad_group_criterion.entity_bid)

سرویس‌ها و عملیات پشتیبانی‌شده

نمونه‌های کد و بار مفید

مثال‌های زیر نشان می‌دهد که چگونه VERTICAL_ADS_ITEM_BID معیارها را بخوانید، ایجاد کنید، به‌روز کنید، و بردارید.

خواندن پیشنهادهای قیمت نهاد بااستفاده از GAQL

برای پُرسمان کردن VERTICAL_ADS_ITEM_BID معیار، از GoogleAdsService.Search یا GoogleAdsService.SearchStream استفاده کنید:

SELECT
  ad_group_criterion.resource_name,
  ad_group_criterion.ad_group,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.cpc_bid_micros,
  ad_group_criterion.entity_bid.item_code
FROM ad_group_criterion
WHERE ad_group_criterion.type = 'VERTICAL_ADS_ITEM_BID'

ایجاد پیشنهاد قیمت نهاد

ارسال عملیات create به AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "create": {
        "adGroup": "customers/1234567890/adGroups/987654321",
        "negative": false,
        "cpcBidMicros": "1500000",
        "entityBid": {
          "itemCode": "hotel_nyc_12345"
        }
      }
    }
  ]
}

به‌روزرسانی مبلغ قیمت پیشنهادی نهاد موجود

عملیات update را با updateMask به AdGroupCriterionService.MutateAdGroupCriteria ارسال کنید:

{
  "customerId": "1234567890",
  "operations": [
    {
      "updateMask": "cpcBidMicros",
      "update": {
        "resourceName": "customers/1234567890/adGroupCriteria/987654321~555444333",
        "cpcBidMicros": "2000000"
      }
    }
  ]
}

برداشتن پیشنهاد قیمت نهاد

ارسال عملیات remove به AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "remove": "customers/1234567890/adGroupCriteria/987654321~555444333"
    }
  ]
}

قوانین اعتبارسنجی و رسیدگی به خطا

گزارش‌های عملکرد

می‌توانید از ClickType.TRAVEL_ASSETS برای شناسایی داده‌های عملکرد آگهی‌هایی که به‌عنوان فیدهای سفر در آگهی‌های «جستجو» ارائه می‌شوند استفاده کنید، مثلاً واکشی داده‌های عملکرد برای آگهی‌ها در همه کمپین‌هایتان:

SELECT
  campaign.name,
  segments.click_type,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.click_type = 'TRAVEL_ASSETS'

بخش‌های بعد برنامه سفر

همچنین می‌توانید گزارش‌های عملکرد را برای کمپین‌های دارای فیدهای سفر پیوندشده براساس ابعاد برنامه سفر بخش‌بندی کنید:

• 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).

پرسمان نمونه

SELECT
  campaign.name,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  segments.start_day_of_week,
  segments.user_set_dates,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS