版本資訊

v23 (2026 年 1 月 28 日)

v23 新增了下列功能和更新。

如需相關指引，請參閱「升級至最新版本」。

廣告

• 已將 AD_SHARING_NOT_ALLOWED 新增至 AdGroupAdErrorEnum。嘗試在多個廣告群組之間共用廣告時，系統會傳回這項錯誤，因為系統已不再允許這麼做。
• 在 AdFormatType 中新增格式類型：TEXT、VERTICAL_ADS_BOOKING_LINK、VERTICAL_ADS_PROMOTION。
• 在第 23 版中，我們已停止支援 CallAd 和 CallAdInfo。詳情請參閱 https://support.google.com/google-ads/answer/6341403。

素材資源

• 在 asset_group 報表中新增其他指標：

  • metrics.engagements
  • metrics.engagement_rate
  • metrics.average_cpe

• 在 asset_group_asset 報表中新增其他指標：

  • metrics.average_cpe
  • metrics.average_cpm
  • metrics.trueview_average_cpv
  • metrics.video_trueview_view_rate
  • metrics.video_trueview_views
  • metrics.interaction_event_types

• 在 Asset 中，為圖片和影片素材資源新增唯讀欄位 orientation。

• 新增支援，可透過 field_type HEADLINE 和 DESCRIPTION 擷取 CampaignAsset。

• 為以網站連結形式放送的素材資源新增 HEADLINE_AS_SITELINK_POSITION_ONE、HEADLINE_AS_SITELINK_POSITION_TWO、DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE 和 DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO 至 ServedAssetFieldType。

• 已更新消費者訊息素材資源：

  • 在 BusinessMessageAsset 中新增對 Facebook Messenger 和 Zalo 的支援，在 BusinessMessageProviderEnum.BusinessMessageProvider 中新增 FACEBOOK_MESSENGER 和 ZALO，並在 BusinessMessageAsset 中新增 facebook_messenger_info 和 zalo_info 欄位。
  • 已將 CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS 新增至 AssetErrorEnum。

帳單

• InvoiceService.ListInvoices 現在可以在 Invoice 中傳回更精細的詳細資料，包括廣告活動層級的費用明細、列出的法規費用和調整資訊，方法是在 ListInvoicesRequest 中設定 include_granular_level_invoice_details。
• 已新增 RegulatoryFeeTypeEnum 和 UnitOfMeasureEnum。

廣告活動

• 新增 CampaignError.DURATION_TOO_LONG_FOR_TOTAL_BUDGET 和 CampaignError.END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET 錯誤代碼。
• 新增 Campaign.start_date_time 和 Campaign.end_date_time 來取代 Campaign.start_date 和 Campaign.end_date，可為特定廣告活動類型指定時間元件。

轉換

• 新增 YOUTUBE_FOLLOW_ON_VIEWS 至 ConversionActionCategory，支援追蹤觀看廣告後，又觀看同一頻道影片的使用者。

需求開發

• 新增 DemandGenVideoResponsiveAdInfo.companion_banner 欄位。
• 已從 DemandGenMultiAssetAdInfo 移除「lead_form_only」欄位。

獎勵

• 新增自選 (CYO) 獎勵支援，合作夥伴可透過程式輔助，為客戶擷取及套用 Google Ads 獎勵：

  • 已新增 IncentiveService：
    • FetchIncentive 方法可根據國家/地區、語言和使用者電子郵件 (選用)，擷取使用者的可用獎勵。這項功能可傳回個人化的「選擇你的獎勵」(CYO) 選項。
    • ApplyIncentive 方法可將使用者選取的獎勵套用至特定 Google Ads 客戶帳戶。
  • 新增唯讀資源 AppliedIncentive，可透過 GoogleAdsService.Search 和 GoogleAdsService.SearchStream 查詢。包括狀態、兌換進度、獎勵金額和相關日期等詳細資料。
  • 在 IncentiveErrorEnum 中新增錯誤代碼，處理與擷取或套用獎勵相關的問題。
  • 已將 INVALID_EMAIL_ADDRESS 新增至 AuthenticationErrorEnum。

• 為方便以程式輔助方式更精細地處理失敗情形，我們會在日後發布的版本中，於 IncentivesService 新增其他錯誤代碼。建議您留意即將發布的公告和版本資訊，瞭解這些新錯誤代碼，確保應用程式可以管理這些新的失敗模式。

規劃

• 已將 LIFE_EVENT_USER_INTEREST 新增至 AudienceInsightsDimensionEnum。這項新維度可讓使用者透過下列方法，使用人生大事建立目標對象：

  • AudienceInsightsService.GenerateAudienceCompositionInsights
  • AudienceInsightsService.GenerateSuggestedTargetingInsights
  • AudienceInsightsService.GenerateInsightsFinderReport
  • ContentCreatorInsightsService.GenerateCreatorInsights

  其他 AudienceInsightsService 方法 (例如 AudienceInsightsService.GenerateAudienceOverlap 和 AudienceInsightsService.GenerateTargetingSuggestionMetrics) 不支援人生大事。

• ReachPlanService.GenerateConversionRates 回應現在包含平台，可根據平台控制項 (例如 Gmail、Shorts) 提供不同的轉換率建議。這項功能僅適用於需求開發廣告活動。

• 新增 LanguageDistribution 至 YouTubeChannelInsights，提供 YouTube 頻道內容的語言分布。

• 新增 BenchmarksService，可比較 YouTube 廣告資料與業界基準。

• 新增 AudienceInsightsService.GenerateAudienceDefinition，可使用生成式 AI 將目標對象的任意文字說明翻譯成相符的目標對象屬性。

• 新增 YouTubeChannelInsights.relevance_score，可評估創作者與主題的相關程度，並依觀看次數加權。

• 新增 TrendInsightMetrics.trend_change_percent，代表趨勢值在比較期間的百分比變化。

建議

• 在 GenerateRecommendationsRequest 中新增 is_new_customer 欄位。如果將 true 設為 CAMPAIGN_BUDGET 類型的建議，系統會使用新客模型生成建議。建議只有沒有廣告活動的客戶使用。

報表

• 指標和區隔

  • AdGroupAdAssetView 和 AdGroupAdAssetCombinationView 現在支援RESPONSIVE_DISPLAY_AD的曝光、成效和轉換指標。
  • 新增 ad_sub_network_type 區隔，可在廣告聯播網中查看更精細的成效明細。這項功能最初適用於 YouTube 需求開發廣告活動 (串流內、動態內、Shorts)。這個區隔必須與 ad_network_type 一併選取。
  • 啟用最高成效廣告活動的廣告聯播網類型細目。
  • UserLocationView 和 GeographicView 現在支援按轉換日期區隔的指標：
    • conversions_by_conversion_date、
    • all_conversions_by_conversion_date、
    • conversions_value_by_conversion_date、
    • all_conversions_value_by_conversion_date、
    • value_per_conversions_by_conversion_date、
    • value_per_all_conversions_by_conversion_date、
    • cross_device_conversions_by_conversion_date、
    • cross_device_conversions_value_by_conversion_date。

• 直向廣告的新區隔

  • vertical_ads_event_participant_display_names
  • vertical_ads_hotel_class
  • vertical_ads_listing
  • vertical_ads_listing_brand
  • vertical_ads_listing_city
  • vertical_ads_listing_country
  • vertical_ads_listing_region
  • vertical_ads_partner_account
  • vertical_ads_vertical

• 新瀏覽次數：

  • 新增 PerStoreView，可查詢商店位置詳細資料。
  • 為 AI Max 廣告活動新增 MatchedLocationInterestView，提供使用者感興趣的地理位置細分成效指標。

• 最高成效：

  • 啟用最高成效廣告活動的廣告聯播網類型細目。

• 移除：

  • 移除匯總資產成效標籤指標。系統不會再為搜尋和多媒體廣告傳回成效標籤列舉。

Google 購物

• ShoppingPerformanceView 現在支援下列按轉換日期區隔的指標：conversions_by_conversion_date、all_conversions_by_conversion_date、conversions_value_by_conversion_date、all_conversions_value_by_conversion_date、value_per_conversions_by_conversion_date、value_per_all_conversions_by_conversion_date。
• ShoppingPerformanceView 現在支援下列競爭指標：search_budget_lost_impression_share、search_rank_lost_impression_share、search_budget_lost_absolute_top_impression_share、search_rank_lost_absolute_top_impression_share。
• 已將 product_image_uri 新增至 ShoppingProduct。

直向廣告

• 為使用旅遊動態饋給的搜尋廣告活動新增 vertical_ads_format_setting，可控管可放送的廣告格式。AdGroup
• 已將 vertical_ads_item_group_rule_list 條件類型新增至 AdGroupCriterion。已將 vertical_ads_item_group_rule 新增至 SharedCriterion。這些條件允許在搜尋廣告活動中，使用旅遊動態饋給指定項目群組。
• 您現在可以將垂直廣告資料動態饋給連結至執行 AI Max 的搜尋廣告活動，以便在文字廣告旁顯示房源宣傳和預訂連結旅遊廣告。在廣告群組層級，您可以透過 vertical_ads_format_setting 控制要顯示的格式，並定義一組項目群組規則，從垂直廣告資料動態饋給中指定實體子集。此外，報表現在可以依AdFormatType和直向廣告資料動態饋給的維度進行區隔。

影片

• 新增 AdVideoAssetInfo.ad_video_asset_feature_control 欄位。
• 新增 CampaignCriterionError.INVALID_VIDEO_LINEUP_ID 錯誤代碼。
• 新增 YouTube 音訊廣告的可聽度指標，回報廣告是否可聽，以及可評估可聽度的曝光次數。

v22 (2025-10-15)

v22 新增了下列功能和更新。

素材資源

• 新增 LANDING_PAGE_PREVIEW 做為新的圖片素材資源欄位類型。
• 推出 AssetGenerationService (Beta 版)：
  • 這項服務可使用生成式 AI 生成文字和圖片素材資源。這項服務初期僅開放給少數封測參與者。
  • GenerateText：根據最終到達網址、任意形式的提示、關鍵字和現有廣告活動內容等輸入內容，生成文字。
  • GenerateImages：根據最終到達網址、任意形式的提示、現有廣告活動內容等輸入內容生成圖片，或重新調整現有產品圖片的內容。
  • 素材資源生成期間發生錯誤時，系統會傳回 AssetGenerationErrorEnum 中的代碼。

廣告活動

• 為應用程式安裝廣告活動新增出價目標，以便在不指定目標的情況下進行最佳化，有助於快速擴大規模，或是在難以判斷合適目標時使用。在 AppCampaignBiddingStrategyGoalType： * OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA：搭配標準「盡量爭取轉換」使用。
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS：搭配標準「盡量提高轉換價值」使用。
• 新增支援固定曝光比例出價策略類型。
• 新增 Campaign.feed_types，顯示附加至廣告活動的動態饋給類型。如果是最高成效廣告活動，這可能表示商家產業別，例如零售業的 MERCHANT_CENTER_FEED。
• 允許將NEGATIVE_KEYWORDS共用組合附加至MULTI_CHANNEL (適用於應用程式廣告活動) 和LOCAL廣告活動。

需求開發

• 為需求開發廣告活動新增目標單次點擊出價策略。這項策略會根據您設定的目標單次點擊出價，盡量爭取點擊。
  • 使用 Campaign.target_cpc 設定廣告活動層級的目標單次點擊出價。
  • 使用 AdGroup.target_cpc_micros 在廣告群組層級覆寫。
• 新增 AssetAutomationType： * GENERATE_DESIGN_VERSIONS_FOR_IMAGES：適用於 DemandGenMultiAssetAds。啟用後，系統會將設計元素和文字素材資源嵌入圖片素材資源，建立不同顯示比例的新圖片素材資源。新帳戶預設會啟用DemandGenMultiAssetAds。
• 新增 AssetAutomationType： * GENERATE_VIDEOS_FROM_OTHER_ASSETS：適用於 DemandGenMultiAssetAds。啟用後，系統會使用圖片和文字等其他素材資源生成影片。這些影片可用來建立新的 DemandGenVideoResponsiveAds。新帳戶預設會啟用DemandGenMultiAssetAds。
• 將欄位「BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros」重新命名為「minimum_budget_amount_micros」。

一般

• 每個AddBatchJobOperations要求最多可執行 10,000 項作業。
• 已更新 ListBatchJobResultsRequest 中「page_size」欄位的處理方式：
  • 如果未設定 page_size 或設為 0，現在預設為最多 1,000 個 (先前會傳回 INVALID_PAGE_SIZE)。
  • 如果 page_size 超過 1,000，API 現在會傳回 INVALID_PAGE_SIZE 錯誤 (先前會無聲無息地設為 1,000)。
• 新增錯誤代碼： QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED， 表示已超過付款資料啟用率上限。

最高成效

• 為最高成效廣告活動新增 AssetAutomationType 值：
  • GENERATE_IMAGE_ENHANCEMENT：啟用後，系統會自動建立強化圖片，例如自動裁剪。(預設為啟用)。
  • GENERATE_IMAGE_EXTRACTION：啟用這項設定後，系統會自動從最終到達網址取得圖片。預設為帳戶層級的動態圖片擴充功能設定。
• 移除最高成效廣告活動的 AssetPerformanceLabel。
• 移除的 Campaign.url_expansion_opt_out 功能現在由 AssetAutomationSetting 中的 AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 設定管理。
• 為最高成效廣告活動新增區隔。這些區隔僅適用於最高成效廣告活動，選取其他廣告活動類型時不會傳回資料。
  • ad_using_product_data：指出廣告是否使用 Google Merchant Center 動態饋給中的產品資料。
  • ad_using_video：指出廣告是否使用影片素材資源。

規劃

• 在 UserListCrmDataSourceType 中，新增了值 THIRD_PARTY_PARTNER_DATA。
  • 新增與合作夥伴目標對象相關的錯誤代碼：
  • PARTNER_AUDIENCE_SOURCE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • COMMERCE_PARTNER_NOT_ALLOWED
  • PARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_MANAGER_ACCOUNT_DISALLOWED
  • PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ADVERTISER_TOS_NOT_ACCEPTED
  • ADVERTISER_PARTNER_LINK_MISSING
  • ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPE
  • INVALID_CAMPAIGN_TYPE_FOR_THIRD_PARTY_PARTNER_DATA_LIST
• 已將 is_active_live_stream_creator 新增至 YouTubeMetrics。這是由 ContentCreatorInsightsService.GenerateCreatorInsights 傳回，表示創作者是否在過去 90 天內發布過直播。

• 新增了包含 UserListCrmDataSourceType 的 PlannableUserListMetadata 訊息 (位於 PlannableUserList 中)。「ReachPlanService.ListPlannableUserLists」會傳回這則訊息，顯示客戶關係管理系統使用者名單資料來源為 FIRST_PARTY 或 THIRD_PARTY_PARTNER_DATA。

• 在 ReachPlanService 中，新增取代 views 欄位的 trueview_views 欄位。

• 在 TrendInsight 中，新增對 related_videos 和 related_creators 的支援。此外，我們也在 YouTubeVideoAttributeMetadata.video_properties 和 YouTubeVideoAttributeMetadata.publish_date 中新增了影片屬性中繼資料和發布日期。

  • AudienceInsightsService.GenerateInsightsFinderReport 現在支援parental_status 和 income_ranges，以及主題和目標對象更複雜的 AND/OR 組合。

報表

• 新增兩種點擊類型：CLICK_TO_MESSAGE_THIRD_PARTY_CLICK 和 CLICK_TO_MESSAGE_LANDING_PAGE_CLICK。
  • AssetGroupAsset 現在可依device、conversion_action、conversion_action_name 和conversion_action_category 區隔。
    • AdGroupAdAssetView 和 AdGroupAdAssetCombinationView 現在完全支援 RESPONSIVE_SEARCH_AD 的成效和轉換指標。先前，這些檢視畫面只會傳回這類廣告的曝光次數。
• 為方便進行智慧出價探索實驗，下列指標現在可依日期欄位 (date、month、quarter、week、year) 區隔：
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
• 新增資源：TargetingExpansionView，用於回報手動指定目標的擴展指標，例如 AI Max 搜尋廣告活動的無關鍵字擴展。

• 為最高成效廣告活動新增區隔。請參閱最高成效廣告活動更新。

  ### 購物

• 修正 ShoppingProduct 資源中指標的廣告活動和廣告群組範圍。

統一目標

• 新增支援顧客留存率目標，可針對重新吸引現有顧客進行最佳化。
  • 使用 CampaignRetentionGoalSettings.target_option 設定指定目標： * TARGET_SPECIFIC：只使用與廣告活動相關聯的使用者名單中的使用者。(目前僅限許可清單中的人員使用)。
    • TARGET_ALL (預設)：指定所有使用者，以提高參與度。

影片

• 重新命名多個與影片觀看次數相關的指標：
  • average_cpv 現已改名為 trueview_average_cpv
  • video_view_rate 現已改名為 video_trueview_view_rate
  • video_views 現已改名為 video_trueview_views
  • video_view_rate_in_feed 現已改名為 video_trueview_view_rate_in_feed
  • video_view_rate_in_stream 現已改名為 video_trueview_view_rate_in_stream
  • video_view_rate_shorts 現已改名為 video_trueview_view_rate_shorts
• 新增影片廣告觀看時間指標：
  • video_watch_time_duration_millis：總觀看時間。
  • average_video_watch_time_duration_millis：單次曝光的平均觀看時間。

v21 (2025-08-06)

如需相關指引，請參閱「升級至最新版本」。

AI Max 搜尋廣告活動

• 您現在可以使用 ai_max_setting.enable_ai_max 欄位，為搜尋廣告活動啟用 AI Max。CampaignAI Max 搜尋廣告活動會透過搜尋字詞比對擴大搜尋廣告活動的觸及範圍，並允許控制項在設定時是否放送指定目標和廣告素材控制項。系統仍會遵守先前版本要求中設定的文字素材資源自動化和品牌清單控管，直到明確切換並停用搜尋廣告活動的 AI Max 為止。您可以使用 Campaign.ai_max_setting.bundling_required，判斷是否必須啟用搜尋廣告活動的 AI Max，才能遵守或修改文字素材資源自動化和品牌清單控管。AdGroup.ai_max_ad_group_setting.disable_search_term_matching可用於停用搜尋字詞比對，前提是上層廣告活動已為搜尋廣告活動啟用 AI Max。請參閱「運用 AI Max 搜尋廣告活動，締造更出色的成效」網誌文章。

• 新增 CampaignError.AI_MAX_MUST_BE_ENABLED，當您選擇啟用FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION，但未在廣告活動中啟用 AI Max 搜尋廣告活動時，系統會針對搜尋廣告活動擲回此錯誤。

• 在 AI Max 搜尋廣告活動中，新增支援在廣告群組層級套用指定目標控制項。您現在可以在廣告群組中加入下列條件：

  • 品牌清單
  • 位置
  • 網頁 (網址規則)

• 新增 ai_max_search_term_ad_combination_view，可針對搜尋字詞、廣告標題和到達網頁的組合，產生成效報表。這個檢視畫面會顯示哪些搜尋查詢觸發了廣告，以及這些特定組合的成效。日後推出的版本將提供額外檢視畫面，其中也會納入最高成效廣告活動資料。如要避免遷移導入作業來取得最高成效廣告活動資料，請考慮等待該版本發布。

• 在 search_term_match_type 區隔中新增 AI_MAX 做為新值。

素材資源

• 在 PromotionAsset 中新增 terms_and_conditions_text、terms_and_conditions_uri、promotion_barcode_info 和 promotion_qr_code_info 欄位。條碼和 QR code 欄位位於 promotion_trigger oneof 中。請參閱說明中心文章「關於宣傳素材資源」。

• 已將 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 新增至 AssetAutomationTypeEnum。透過這項設定，您可以控管系統是否要根據搜尋廣告活動中的最終到達網址，自動產生文字素材資源和到達網頁。

• 新增一項服務 AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset ，可從 Campaign 移除自動建立的素材資源。這項服務僅支援移除最終到達網址擴展素材資源。

• 在 ServedAssetFieldType 列舉中新增 DESCRIPTION_PREFIX。這項修正解決了 ad_group_ad_asset_combination_view 中的 served_asset_field_type 為 UNKNOWN 的問題，該問題會導致素材資源做為說明前置字元時發生錯誤。

廣告活動

• 在 CampaignPrimaryStatusReason 中新增列舉值 MISSING_LOCATION_TARGETING。只有未指定地區指定目標的地區限制廣告活動，才會傳回這項新的狀態原因。如果廣告活動設有地區限制，嘗試在允許區域外新增指定地區，會導致條件錯誤 LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN。

• 在VideoCustomer.third_party_integration_partners和Campaign.third_party_integration_partners層級新增第三方整合合作夥伴支援。請參閱說明中心文章「使用第三方應用程式數據分析追蹤應用程式轉換」。

• 您現在可以為現有的 Campaign 設定 advertising_partner_ids 欄位。以往，這個欄位只能在建立新廣告活動時設定。設定後仍無法變更。

• 廣告主現在可以使用在管理員帳戶層級定義的 TYPE_PLACEMENT_LIST 類型共用清單，透過 CustomerNegativeCriterion 條件，在個別廣告主客戶帳戶中排除刊登位置清單。

• 在 ServedAssetFieldType 列舉中新增 DESCRIPTION_PREFIX。這項修正解決了ad_group_ad_asset_combination_view 中的 served_asset_field_type UNKNOWN 問題，這些資產會做為說明前置字元。

• 在 MaximizeConversionValue 和 TargetRoas 出價策略中，新增了對 target_roas_tolerance_percent_millis 欄位的支援。TargetRoas.target_roas_tolerance_percent_millis 僅適用於組合策略，而組合策略僅適用於搜尋廣告活動。

• 變更 ProductGroup 錯誤代碼。如果要求啟用部分失敗，系統會傳回 LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION，而非 INVALID_LISTING_GROUP_HIERARCHY。

• 新增 LocationInterestView 資源，彙整廣告群組地點興趣條件的成效。

轉換

• 在 conversion_attribution_event_type 區隔中新增 ENGAGED_VIEW 值。

• 顧客將無法再透過 ConversionUploadService 使用 debug_enabled 模式。如果這個欄位設為 TRUE，先前可用於區分CLICK_NOT_FOUND錯誤和SUCCESS，以匯入待開發客戶強化轉換。

需求開發

• 新增錯誤代碼 CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM。 日後，如果嘗試為需求開發廣告活動設定極低的預算金額，系統就會傳回這項錯誤。如要瞭解最低預算規定，請查看新的錯誤詳細資料欄位 budgetDailyMinimumErrorDetails。

歐盟政治廣告異動

v19.2 和 v20.1 版本也已進行這些歐盟政治廣告異動。

• 新增「Campaign.contains_eu_political_advertising」。這個欄位會指出廣告活動是否含有以歐盟為目標對象的政治廣告內容。如果將這個欄位設為 CONTAINS_EU_POLITICAL_ADVERTISING，廣告活動將於 2025 年 9 月 22 日起停止在歐盟放送。如果未設定這個欄位，建立新廣告活動的 API 呼叫會失敗，並顯示 FieldError.REQUIRED 錯誤。

  如要變更現有廣告活動的contains_eu_political_advertising欄位，請先設定該欄位，再嘗試在廣告活動或廣告群組層級變更鄰近地區、地點或地點群組指定目標。如果廣告活動尚未完成自我聲明，API 呼叫將無法為現有廣告活動建立或更新這些廣告活動或廣告群組條件，並會傳回 CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 錯誤。

  對於 v19.x 和 20.x 版，系統目前不會強制設定這個欄位，但日後會強制執行。這項異動將會提前公告。

• 如果實驗廣告活動尚未自行聲明是否含有指定歐盟的政治廣告，則試用和實驗會擲回 ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION。

最高成效

• 對於新的最高成效廣告活動，Campaign.brand_guidelines_enabled 的預設值現在為 true。

• 新增 campaign_search_term_view 報表。這個檢視畫面提供廣告活動層級的匯總搜尋字詞指標。這個檢視畫面也支援最高成效廣告活動的搜尋字詞。

• 在 search_term_match_type 區隔中新增 PERFORMANCE_MAX 值。

規劃

• 新增 ReachPlanService.ListPlannableUserInterests 方法，廣告主可藉此探索 ReachPlanService.GenerateReachForecast 支援的使用者興趣 (親和度和目標市場)。這個方法支援搜尋特定使用者興趣類型，以及查詢名稱和路徑。

• 在 ReachPlanService.ListPlannableUserLists 中新增 AdditionalApplicationInfo 做為選填輸入欄位。

• 新增支援功能，可透過 AudienceInsightsService.ListAudienceInsightsAttributes 擷取提出要求的客戶 ID 適用的第一方使用者名單。

• 新增第一方使用者名單支援，可透過 AudienceInsightsService.GenerateAudienceCompositionInsights 擷取指定使用者名單的目標對象洞察資料。任何以使用者名單為目標的請求只會傳回目標對象索引，且僅適用於下列 AudienceInsightsDimension：AGE_RANGE、GENDER、AFFINITY_USER_INTEREST、IN_MARKET_USER_INTEREST。

• 已將目標對象輸入類型更新為 InsightsAudience，適用於 AudienceInsightsService.GenerateTargetingSuggestionMetrics。新的目標對象輸入功能可讓您以「OR」組合「AND」使用者興趣，並支援潛在觸及指標，以便更自訂目標對象定義。

• 在 TrendInsightMetrics 中新增目標對象分享，取得趨勢的目標對象分享。

• 在 KnowledgeGraphAttributeMetadata 中新增相關類別，使用者可以依類別篩選知識圖譜屬性。

報表

• 現在可為 AssetGroupAsset、ChannelAggregateAssetView 和 CampaignAggregateAssetView 使用多種新指標。此外，對於ChannelAggregateAssetView和CampaignAggregateAssetView，impressions先前在最高成效廣告活動中會歸零，現在則會回報實際值。

• 讓使用者可透過 ChangeStatus 選取 AssetSet 資源，以便在單一查詢中取得 AssetSet 或 CampaignAssetSet 類型資源的更多資訊。

• 使用者現在可以透過 ChangeStatus 選取 CampaignAssetSet 資源，在單一查詢中取得 AssetSet 或 CampaignAssetSet 類型資源的詳細資訊。

• 新增區隔 search_term_targeting_status，可在廣告活動搜尋字詞檢視中選取。

• 新增 final_url_expansion_asset_view。

• 在 AssetGroup 報表中新增指標 value_adjustment 和 all_value_adjustment 的支援。

• 可按AssetGroupAsset區隔ad_network_type。

• 新增可搭配 landing_page_view 資源使用的區隔 landing_page_source。

• 新增區隔 search_term_match_source，可在搜尋字詞和廣告活動搜尋字詞檢視畫面中選取。

• 在關鍵字檢視畫面中新增可選取的區隔 match_type。

• 新增支援獨特查詢意圖叢集的指標，包括：

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

• 在click_view區隔中新增點擊類型 VEHICLE_ASSETS，追蹤及回報與車輛素材資源專屬廣告格式相關的點擊。

搜尋廣告活動採用「目標廣告投資報酬率」出價策略時的智慧出價探索

• 您現在可以為搜尋廣告活動啟用智慧出價探索，方法是在 MaximizeConversionValue 和 TargetRoas 出價策略中，將 target_roas_tolerance_percent_millis 欄位設為介於 10000 (10%) 和 30000 (30%) 之間的值，且該值可除以 1000。MaximizeConversionValue 出價策略也需要設定 target_roas 欄位。TargetRoas.target_roas_tolerance_percent_millis 僅適用於組合策略。請參閱有關智慧出價探索的網誌文章和說明中心文章。

• 現在，系統支援針對不重複的查詢意圖叢集，匯總下列指標的多元性報表。您可以在 Google Ads 使用者介面中，查看按時間區隔的資料。

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

影片

• 新增「YouTubeVideoListAsset」。此外，我們也新增了 Asset#youtube_video_list_asset，可用於在 campaign 和 YouTubeVideoListAsset 類型之間建立連結。請參閱說明中心文章「使用相關影片」。

• 在 YouTubeChannelInsights 和 YouTubeVideoAttributeMetadata 中新增中繼資料欄位。

• 公開新的點擊類型：VIDEO_RELATED_VIDEOS_CLICK、VIDEO_CHANNEL_CLICK 和 PRODUCT_ASSETS。

• 新增 allow_non_skippable_in_stream 欄位至 VideoAdInventoryControl，讓回應式影片廣告可放送為不可略過的串流內廣告。如果廣告活動支援混合使用不可略過廣告格式和其他格式，即可使用這個選項。

• 新增 Campaign.VideoCampaignSettings.video_ad_sequence 和 AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting 欄位 (唯讀)。請參閱說明中心文章「關於影片廣告序列」。

• 在 YouTubeChannelInsights 和 YouTubeVideoAttributeMetadata 中新增中繼資料欄位。

• 在 CampaignCriterion 和 AdGroupCriterion 中新增 VIDEO_LINEUP 條件類型和 video_lineup 欄位。這項功能僅適用於許可清單中的帳戶。詳情請洽詢 Google 業務開發代表。

• 新增詳細資料和群組層級的內容合適度報表。請參閱說明中心文章「關於『內容適當性』報表」。

v20.1 (2025-08-06)

這些歐盟政治廣告異動也已在 v19.2 和 v21 版本中實施。

歐盟政治廣告異動

• 新增「Campaign.contains_eu_political_advertising」。這個欄位會指出廣告活動是否含有以歐盟為目標對象的政治廣告內容。如果將這個欄位設為 CONTAINS_EU_POLITICAL_ADVERTISING，廣告活動將於 2025 年 9 月 22 日起停止在歐盟放送。

  如要變更現有廣告活動的contains_eu_political_advertising欄位，請先設定該欄位，再嘗試在廣告活動或廣告群組層級變更鄰近地區、地點或地點群組指定目標。如果廣告活動尚未完成自我聲明，API 呼叫將無法為現有廣告活動建立或更新這些廣告活動或廣告群組條件，並會傳回 CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 錯誤。

  對於 v19.x 和 20.x 版，系統目前不會強制設定這個欄位，但日後會強制執行。這項異動將會提前公告。

• 如果實驗廣告活動尚未自行聲明是否含有指定歐盟的政治廣告，則試用和實驗會擲回 ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION。

v20 (2025-06-04)

v20 新增了下列功能和更新。

如需相關指引，請參閱「升級至最新版本」。

素材資源

為asset_group報表新增多個指標和區隔資料欄。

指標欄

• new_customer_lifetime_value
• all_new_customer_lifetime_value
• conversions_by_conversion_date
• all_conversions_by_conversion_date
• conversions_value_by_conversion_date
• all_conversions_value_by_conversion_date
• value_per_conversions_by_conversion_date
• value_per_all_conversions_by_conversion_date

區隔資料欄

• ad_network_type
• conversion_action
• conversion_action_name
• conversion_action_category
• external_conversion_source
• conversion_attribution_event_type
• conversion_adjustment
• conversion_lag_bucket
• conversion_or_adjustment_lag_bucket
• new_versus_returning_customers
• device
• slot

廣告活動

• 最高成效廣告活動新增支援新增及更新廣告活動層級排除關鍵字。

轉換

• 您現在可以更新現有客戶的 google_ads_conversion_customer 欄位，選擇採用跨帳戶轉換追蹤，或將現有的轉換追蹤父項變更為其他管理員帳戶。

  注意： 這項功能僅適用於許可清單中的專案。如要使用，請洽詢您的客戶經理。

• 新增 ClickConversion.user_ip_address 欄位。Google Ads 不支援為歐洲經濟區 (EEA)、英國 (UK) 或瑞士 (CH) 的使用者比對 IP 位址。請新增邏輯，有條件地排除來自這些區域的使用者分享 IP 位址。請務必提供清楚詳盡的資訊，讓使用者瞭解網站、應用程式及其他資源的資料收集活動，並根據相關法律或適用的 Google 政策徵得使用者同意。詳情請參閱「關於離線轉換匯入」頁面。

需求開發

• 在 ad_network_type 區隔中新增值，可依管道區隔需求開發廣告活動：
  • MAPS
  • GMAIL
  • DISCOVER
• 新增平台可比性轉換的指標：
  • platform_comparable_conversions_from_interactions_rate
  • platform_comparable_conversions
  • platform_comparable_conversions_value
  • platform_comparable_conversions_value_per_cost
  • platform_comparable_conversions_by_conversion_date
  • platform_comparable_conversions_value_by_conversion_date
  • platform_comparable_conversions_from_interactions_value_per_interaction
    • cost_per_platform_comparable_conversion
  • value_per_platform_comparable_conversion
  • value_per_platform_comparable_conversions_by_conversion_date
  • cost_converted_currency_per_platform_comparable_conversion

建議

• 在使用 GenerateRecommendationsRequest 建立廣告活動時，新增對 ShoppingSetting 的支援。
  • 在 merchant_center_account_id 欄位中新增 GenerateRecommendationsRequest，指出應為零售業生成最佳化建議，而非標準最高成效廣告活動。

規劃

• 新增 AudienceInsightsDimension.YOUTUBE_LINEUP，取代 AudienceInsightsService 和 ContentCreatorInsightsService 中的 AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP。這個新維度可讓您擷取 YouTube Select (YTS) 首選頻道的洞察資料和中繼資料。為配合 Google Ads 全面移除動態節目表，我們已替換與 YOUTUBE_DYNAMIC_LINEUP 相關聯的物件，例如 DynamicLineupAttributeMetadata 和 AudienceInsightsDynamicLineup。這項功能僅適用於許可清單中的帳戶。
• 已在 AudienceInsightsService、ContentCreatorInsightsService 和 ReachPlanService 中新增 AdditionalApplicationInfo 和 ApplicationInstance。這項功能僅適用於許可清單中的帳戶。
• 更新 AudienceInsightsService 和 ContentCreatorInsightsService，提供更詳細的洞察資料。現在，您可以在這兩項服務中，使用新的 AudienceInsightsDimension.DEVICE 和 AudienceInsightsAttribute.device，依裝置區隔內容建立者資料。這項功能僅適用於許可清單中的帳戶。
• 在 GenerateCreatorInsightsResponse 中新增其他匯總影片指標，方便內容創作者進行更全面的分析：engagement_rate、average_views_per_video、average_likes_per_video、average_shares_per_video、average_comments_per_video、shorts_views_count、shorts_video_count 和 is_brand_connect_creator。這項功能僅適用於許可清單中的帳戶。
• 已將 sub_country_locations 新增至 GenerateCreatorInsightsRequest，適用於 ContentCreatorInsightsService。這樣就能指定國家/地區內的地理位置，進一步篩選創作者洞察資料。只有在 criteria 欄位中使用 search_attributes oneof 時，系統才會支援 sub_country_locations 欄位。如果 sub_country_locations 與其他條件類型一起提供，要求將無效。這項功能可讓內容創作者洞察資料的地理位置目標對象和分析更加精細。這項功能僅適用於許可清單中的帳戶。
• 新增 ReachPlanService.ListPlannableUserLists，可傳回顧客擁有的第一方使用者名單，並在 GenerateReachForecastRequest 的目標對象指定選項中新增 UserListInfo。這樣一來，您就能為特定客戶擷取可規劃的使用者名單，然後為指定這些特定目標對象的廣告活動產生觸及預測。 這些強化功能可直接將第一方目標對象資料納入預測，進而提升量身打造的觸及規劃。觸及率預測僅適用於許可帳戶。

影片

• 在電視螢幕上放送的AdFormatType.PAUSE廣告已加入報表。這類廣告會直接顯示在暫停畫面上的靜態影片影格旁。這不包括顯示在暫停的自然影片下方或上方的廣告面板中，並在 AdFormatType.INFEED 下回報的「需求開發」影片廣告。

封存的版本資訊

如需封存的版本資訊，請參閱「已淘汰版本」。