Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

搜尋廣告旅遊動態饋給

將飯店、度假民宿或觀光景點產品動態饋給連結至 Google Ads 帳戶後，Google Ads 會自動從動態饋給中擷取價格和圖片，在現有搜尋廣告活動中加入這些資訊。這項功能稱為搜尋廣告旅遊動態饋給。

客戶設定和廣告活動設定的互動方式

根據預設，廣告活動會透過CustomerAssetSet關聯資料，從客戶層級沿用旅遊動態饋給連結 (TRAVEL_FEED 素材資源組合)。如要為特定廣告活動覆寫客戶層級設定，請務必在廣告活動的 excluded_parent_asset_set_types 欄位中新增 TRAVEL_FEED，並使用 CampaignAssetSet 管理廣告活動專屬連結。

沿用顧客動態饋給 (預設)：保留連結的顧客層級 CustomerAssetSet，並確保 Campaign.excluded_parent_asset_set_types不含 TRAVEL_FEED。
在客戶層級停用：移除客戶層級的CustomerAssetSet關聯，且不要連結廣告活動層級的CampaignAssetSet。
停用特定廣告活動：在 Campaign.excluded_parent_asset_set_types 中加入 TRAVEL_FEED，並移除所有廣告活動層級的 CampaignAssetSet 關聯。
只為特定廣告活動啟用：移除客戶層級的CustomerAssetSet關聯，然後為該廣告活動建立廣告活動層級的CampaignAssetSet連結。
使用廣告活動專屬動態饋給，同時讓其他廣告活動繼續沿用：在廣告活動的 Campaign.excluded_parent_asset_set_types 中新增 TRAVEL_FEED，並為其建立廣告活動層級的 CampaignAssetSet 連結。

停用搜尋廣告旅遊動態饋給

如果您不想使用這項功能，可以透過 Google Ads API，在客戶和廣告活動層級停用搜尋廣告旅遊動態饋給。

在客戶層級停用

如要在客戶層級停用搜尋廣告旅遊動態饋給，請按照下列步驟操作：

使用 customer_asset_set 報表，擷取類型為 TRAVEL_FEED 的所有 CustomerAssetSet 連結的 customer_asset_set.resource_name 和 asset_set.resource_name：

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

針對每個 customer_asset_set.resource_name，建立 CustomerAssetSetOperation 並將 remove 設為上一個步驟中擷取的 customer_asset_set.resource_name。
使用建立的 CustomerAssetSetOperation 物件，向 CustomerAssetSetService.MutateCustomerAssetSets 提交要求。

如要再次在客戶層級啟用這項功能，請按照下列步驟操作：

針對要連結的每個基礎 AssetSet (asset_set.resource_name)，建立新的 CustomerAssetSet，並將 asset_set 設為 asset_set.resource_name，將 customer 設為客戶的資源名稱。
針對上一個步驟中建立的每個 CustomerAssetSet，建立 CustomerAssetSetOperation，並將 create 設為 CustomerAssetSet。
使用建立的 CustomerAssetSetOperation 物件，向 CustomerAssetSetService.MutateCustomerAssetSets 提交要求。

在廣告活動層級選擇退出

如要在廣告活動層級停用搜尋廣告旅遊動態饋給，請先排除從客戶層級沿用的啟用狀態：

使用 campaign 報表擷取 excluded_parent_asset_set_types：

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

建立新的 Campaign 物件，並將 excluded_parent_asset_set_types 設為先前的值 TRAVEL_FEED，並將 resource_name 設為廣告活動的資源名稱。
建立 CampaignOperation，並將 update 設為先前建立的 Campaign，然後相應地設定 update_mask。
使用上一個步驟建立的 CampaignOperation，向 CampaignService.MutateCampaigns 提交要求。

接著，移除所有廣告活動層級的旅遊動態饋給關聯：

如要為廣告活動停用連結，請使用 campaign_asset_set 報表，針對所有類型為 TRAVEL_FEED 的 CampaignAssetSet 連結擷取 campaign_asset_set.resource_name 和 asset_set.resource_name：

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'

針對每個 campaign_asset_set.resource_name，建立 CampaignAssetSetOperation 並將 remove 設為上一個步驟中擷取的 campaign_asset_set.resource_name。
使用建立的 CampaignAssetSetOperation 物件，向 CampaignAssetSetService.MutateCampaignAssetSets 提交要求。

如要再次在廣告活動層級啟用這項功能，請按照下列步驟操作：

針對要加入的每個基礎 AssetSet (asset_set.resource_name)，建立新的 CampaignAssetSet，並將 asset_set 設為 asset_set.resource_name，以及將 campaign 設為廣告活動的資源名稱。
針對上一個步驟中建立的每個 CampaignAssetSet，建立 CampaignAssetSetOperation，並將 create 設為 CampaignAssetSet。
使用建立的 CampaignAssetSetOperation 物件，向 CampaignAssetSetService.MutateCampaignAssetSets 提交要求。

還原廣告活動的客戶層級採用狀態

如要讓廣告活動的啟用狀態再次沿用客戶層級設定，請按照下列步驟操作：

建立新的 Campaign 物件，其中包含清單中的 excluded_parent_asset_set_types 「without TRAVEL_FEED，且 resource_name 設為廣告活動的資源名稱。
建立 CampaignOperation，並將 update 設為先前建立的 Campaign，然後相應地設定 update_mask。
使用上一個步驟建立的 CampaignOperation，向 CampaignService.MutateCampaigns 提交要求。

依實體手動單次點擊出價

自 Google Ads API v25 起，您可以使用 AdGroupCriterion 資源，為觀光景點旅遊搜尋廣告活動中的飯店設定實體的手動單次點擊出價覆寫，條件類型為 CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid)。

先決條件和相容性需求

如要建立及管理 VERTICAL_ADS_ITEM_BID 條件，必須符合下列條件：

廣告活動類型：旅遊搜尋廣告活動 (搜尋廣告活動，AdvertisingChannelType.SEARCH啟用 AI Max 搜尋廣告活動Campaign.ai_max_setting.enable_ai_max，並連結飯店動態饋給 [TRAVEL_FEED 素材資源組合]；僅支援飯店動態饋給)。
出價策略：僅限手動單次點擊出價 (BiddingStrategyType.MANUAL_CPC)。
- 不支援自動或智慧出價策略 (例如「盡量爭取轉換」、「盡量提高轉換價值」、「目標單次動作出價」或「目標廣告投資報酬率」)。
僅限正向條件： negative 必須設為 false。系統不支援負實體出價。
必要實體 ID 和出價：建立實體出價條件時，需要 entity_bid.item_code 和 cpc_bid_micros。

結構定義和欄位定義

資源： AdGroupCriterion (ad_group_criterion)
資源名稱格式： customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
條件類型列舉： CriterionType.VERTICAL_ADS_ITEM_BID
訊息： EntityBid (ad_group_criterion.entity_bid)

欄位	類型	行為	說明
`entity_bid`	`EntityBid`	`IMMUTABLE`	代表單一項目的手動出價覆寫條件。
`entity_bid.item_code`	`string`	`IMMUTABLE`，必填	指定特定飯店實體 (飯店資訊 ID) 的 ID 或代碼，須與合作夥伴飯店動態饋給相符 (1 到 256 個字元，會經過修剪)。
`cpc_bid_micros`	`int64`	讀取/寫入	手動單次點擊出價金額 (以微元為單位)，例如 `1000000` 等於 `$1.00`。
`negative`	`bool`	`IMMUTABLE`	必須為 `false`。

支援的服務和作業

服務	方法	支援的動作
`AdGroupCriterionService`	`MutateAdGroupCriteria`	`create`、`update` (`cpc_bid_micros`)、`remove`
`GoogleAdsService`	`Search` / `SearchStream`	查詢條件屬性、項目代碼和出價值

程式碼和酬載範例

下列範例說明如何讀取、建立、更新及移除 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"
        }
      }
    }
  ]
}

更新現有實體的競價金額

使用 updateMask 將 update 作業傳送至 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"
    }
  ]
}

驗證規則和錯誤處理

情境	觸發條件	傳回的錯誤代碼
非手動單次點擊出價廣告活動	嘗試在採用自動或智慧出價的廣告活動中，建立實體出價。	`ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT`
行銷活動類型無效	在非搜尋廣告活動 (例如多媒體廣告活動) 中加入實體出價。	`ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT`
排除條件	正在為 `VERTICAL_ADS_ITEM_BID` 設定 `negative = true`。	`ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT`
缺少商品代碼或出價	嘗試建立 `entity_bid`，但未提供 `item_code` 或 `cpc_bid_micros`。	`RequestError.REQUIRED_FIELD_MISSING` / `FieldError.REQUIRED`
變動項目代碼	嘗試更新現有條件的 `entity_bid.item_code`。	`RequestError.IMMUTABLE_FIELD`/`FieldError.IMMUTABLE_FIELD`

成效報表

您可以使用 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

報表