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

با پیوند دادن فیدهای محصول «هتل‌ها»، «اقامتگاه‌های اجاره‌ای»، یا «فعالیت‌های پیشنهادی» به حساب 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 را بردارید.
• فقط برای یک پویش خاص موافقت کنید: ارتباط سطح مشتری را بردارید، سپس پیوند سطح پویش برای آن پویش ایجاد کنید.CustomerAssetSetCampaignAssetSet
• استفاده از فیدهای خاص پویش درحالی‌که پویش‌های دیگر همچنان به ارث بردن ادامه می‌دهند: 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. شیء Campaign جدیدی با excluded_parent_asset_set_types بدون TRAVEL_FEED در فهرست ایجاد کنید و resource_name را روی نام منبع پویشتان تنظیم کنید.
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) لغو کنید. برای تنظیم تعدیل‌های قیمت پیشنهادی گروه آگهی افزاینده در ابعاد برنامه سفر بااستفاده از AdGroupBidModifier، به تعدیل قیمت‌های پیشنهادی با اصلاح‌کننده‌های قیمت پیشنهادی مراجعه کنید.

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

برای ایجاد و مدیریت معیارهای 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

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

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