版本資訊

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_KEYWORDSMULTI_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」。

一般

• 每個要求最多只能包含 10,000 項作業。AddBatchJobOperations
• 已更新 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 天內發布直播。

• 新增了 PlannableUserListMetadata 訊息，其中包含 PlannableUserList 中的 UserListCrmDataSourceType。「ReachPlanService.ListPlannableUserLists」會傳回這則訊息，指出 CRM 使用者名單資料來源是 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 搜尋廣告活動

• 您現在可以使用 Campaign 的 ai_max_setting.enable_ai_max 欄位，啟用 AI Max 搜尋廣告活動。AI 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先前在最高成效廣告活動中會歸零，現在則會回報實際值。

• 使用 AssetSet 資源可選取 ChangeStatus，讓使用者在一個查詢中取得 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_source 區隔，可與 landing_page_view 資源搭配使用。

• 新增區隔 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 不支援歐洲經濟區、英國或瑞士使用者的 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 的支援。
• 在 GenerateRecommendationsRequest 中新增 merchant_center_account_id 欄位，指出何時應為零售廣告活動 (而非標準最高成效廣告活動) 產生最佳化建議。

規劃

• 新增 AudienceInsightsDimension.YOUTUBE_LINEUP，取代 AudienceInsightsService 和 ContentCreatorInsightsService 中的 AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP。這個新維度可讓您擷取 YouTube Select (YTS) 首選頻道的洞察資料和中繼資料。已移除與 YOUTUBE_DYNAMIC_LINEUP 相關聯的物件，例如 DynamicLineupAttributeMetadata 和 AudienceInsightsDynamicLineup，以配合 Google Ads 全面移除動態組合。這項功能僅適用於許可清單中的帳戶。
• 已在 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。您可以擷取特定客戶的可規劃使用者名單，然後針對指定這些特定目標對象的廣告活動，產生觸及預測資料。這些強化功能會直接將第一方目標對象資料納入預測，進而改善量身打造的觸及規劃。觸及率預測功能僅適用於已加入許可清單的帳戶。

影片

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

v19.2 (2025-08-06)

我們也在 v20.1 和 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。

v19.1 (2025-04-16)

v19.1 新增了下列功能和異動。

素材資源

• 新增 asset_coverage 欄位，用於傳回AssetGroup素材資源群組中缺少的素材資源。
  • 包含子欄位 ad_strength_action_items 傳回廣告主可採取的動作清單，以提升素材資源群組的廣告優異度。

廣告活動

• 您現在可以在在地生活服務廣告活動中，為待開發客戶評分或提供意見回饋。
  這項異動也包括：
  • 新增名為「LocalServicesLeadService」的服務。您可以使用 ProvideLeadFeedback 方法，上傳待開發客戶的評分和意見回饋。
  • 在 LocalServicesLead 中新增名為 lead_feedback_submitted 的欄位，協助判斷是否已將意見回饋提交給待開發客戶。
• 應用程式廣告活動新增了指標資料欄 biddable_cohort_app_post_install_conversions 。

需求開發

• 「規劃服務」中新增了其他方法，以支援需求開發廣告活動。

• 新增對廣告群組層級需求開發廣告活動管道控制選項的支援。您可以選取預先定義的頻道一般分組，也可以使用 demand_gen_ad_group_settings 欄位選取部分頻道。目前版本支援下列管道：

  • YouTube 串流內廣告
  • YouTube 動態內廣告
  • YouTube Shorts
  • 探索
  • Gmail
  • 多媒體

• 公開 TALL_PORTRAIT_MARKETING_IMAGE 的新資產類型。這項素材資源類型與需求開發多重素材資源廣告格式的tall_portrait_marketing_images 欄位相關。

變更記錄

• 在 ChangeStatusResourceType 中新增對三種資源類型的支援：
  • CAMPAIGN_BUDGET
  • ASSET_SET
  • CAMPAIGN_ASSET_SET
• 您可以從 change_status 報表擷取這三種更精細的類型。

轉換

• 您現在可以使用 Google Ads API 建立新客戶時，設定 google_ads_conversion_customer 欄位。這個欄位先前為唯讀。

  注意：這項功能僅限許可清單中的人員使用。如要使用，請與客戶經理聯絡。

• 上傳離線轉換資料時，您現在可以指定與轉換相關聯的顧客類型。

• 我們為 ClickConversion 導入了新的 session_attributes 欄位。

在地生活服務廣告

• 新增 RPC ProvideLeadFeedback 至 LocalServicesLeadService，以提供有關 LocalServicesLead 品質的意見回饋。
• 在 LocalServicesLead 資源中新增 lead_feedback_submitted 欄位，確認是否已為特定資源提供意見回饋。

規劃服務

• 在ReachPlanService.GenerateReachForecast中新增支援，可預測每月目標頻率。
  • 開發人員可以使用 TARGET_FREQUENCY 可規劃產品代碼，設定 TargetFrequencyTimeUnit.MONTHLYTargetFrequencySettings，產生目標頻率每月觸及預測。
• 新增方法 ReachPlanService.GenerateConversionRates，廣告主可藉此要求取得支援的規劃產品建議轉換率。
• 在以下位置進行需求預測： ReachPlanService.GenerateReachForecast：
  • 開發人員現在可以為需求開發廣告活動索取觸及預測。 開發人員可以使用新的 DEMAND_GEN_MAX_CONVERSIONS 可規劃產品代碼，產生需求開發廣告的觸及預測。
  • 新增 conversion_rate 欄位，讓要求需求開發廣告活動觸及預測的開發人員提供轉換率。您可以使用新的 ReachPlanService.GenerateConversionRates 方法擷取建議的轉換率。這是需求開發預測要求的必填欄位。其他可規劃產品不支援這項功能。
  • 在傳回的預測中新增 conversions 欄位。這個欄位包含到達率曲線中特定點的轉換次數。轉換資料僅適用於DEMAND_GEN_MAX_CONVERSIONS可規劃產品。

建議

• 新的 ad_strength 欄位適用於 ImprovePerformanceMaxAdStrengthRecommendation，可傳回與建議相關聯的素材資源群組目前廣告優異度分數。

  購物

• 您現在可以為最高成效廣告活動中的購物廣告，覆寫品牌排除條件。這項功能會透過廣告活動層級的新 pmax_campaign_settings 欄位公開，且僅適用於零售最高成效廣告活動。如果嘗試為不相容的廣告活動類型設定這個欄位，系統會擲回新的 CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED 錯誤。

影片

• 新增音訊廣告的唯讀支援。如要瞭解這項功能，請參閱 Google Ads 說明中心。這項異動會公開：
  • 名為 YOUTUBE_AUDIO 的新 AdvertisingChannelSubType。
  • 名為 YOUTUBE_AUDIO 的新 AdGroupType。
  • 名為 YOUTUBE_AUDIO_AD 的新廣告格式列舉，以及對應的 YouTubeAudioAdInfo 欄位。
• 在查詢觸及指標中新增指標和區隔，並進行目標對象調整。在本次異動中，
  • 系統新增了兩個指標資料欄，分別名為 coviewed_impressions 和 primary_impressions。
  • 我們推出了兩個新區隔，分別是 adjusted_age_range 和 adjusted_gender。
  • 如果選取任一新區隔，並搭配觸及指標欄位 (coviewed_impressions、primary_impressions、unique_users 或 average_impression_frequency_per_user)，則必須同時選取另一個區隔，才能擷取這些資料欄的有效統計資料。
  • 這項功能目前僅適用於許可清單中的客戶。

v19 (2025-02-26)

v19 新增了下列功能和異動。

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

帳戶管理

• 在 CustomerError 中新增下列值，因應即將推出的異動：
  • CREATION_DENIED_FOR_POLICY_VIOLATION
  • CREATION_DENIED_INELIGIBLE_MCC

廣告

• 新增DemandGenMultiAssetAdInfo.tall_portrait_marketing_images，支援需求開發廣告中長寬比為 9:16 的直向圖像素材資源。

素材資源

• (僅限已加入許可清單的帳戶) 新增支援透過 Asset.business_message_asset、BusinessMessageAsset 和下列列舉和錯誤，使用訊息素材資源。
  • 列舉：
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • 錯誤：
    • AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
    • ResourceLimitType
      • BUSINESS_MESSAGE_ASSET_LINKS_PER_CUSTOMER
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_CAMPAIGN
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_AD_GROUP
• 新增 AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW，支援自動產生到達網頁預覽畫面。
• AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS 現在預設會為需求開發影片回應式廣告啟用。
• (僅適用於已列入許可清單的帳戶；許可清單目前已關閉) 新增 Asset.app_deep_link_asset 和 AppDeepLinkAsset。

轉換

• 轉換目標
  • LifecycleGoalValueSettings.high_lifetime_value 已通過測試階段，現在可變動。
  • 新增 CustomerLifecycleGoal.owner_customer ，顯示擁有顧客生命週期目標的顧客資源名稱。
• 已淘汰 ConversionActionType.SALESFORCE。

動態饋給

• 移除所有動態消息相關實體，例如 Feed、FeedMapping、FeedService、AdGroupFeed、feed_placeholder_view 等。使用者現在應使用 assets 達成相同目的。

飯店和旅遊

• 將 min_days 和 max_days 設為 ValueRuleItineraryAdvanceBookingWindow optional 欄位，允許指定 0 做為值。這項功能支援指定今天發生的旅遊搜尋。

最高成效

• (僅適用於已加入許可清單的帳戶) 品牌宣傳指南
  • 只能在建立最高成效廣告活動時變更。Campaign.brand_guidelines_enabled
  • 這項功能不適用於旅遊目標專用的最高成效廣告活動。
  • 如要為現有最高成效廣告活動啟用品牌宣傳指南，請使用新加入的CampaignService.EnablePMaxBrandGuidelines。系統不支援停用品牌宣傳指南。
  • 新增 Campaign.brand_guidelines 和 BrandGuidelines，可設定品牌顏色和字型系列。
  • 新錯誤值：
    • BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
    • BrandGuidelinesMigrationError
    • BRAND_GUIDELINES_ALREADY_ENABLED
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
    • BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
    • CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
    • AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
    • TOO_MANY_ENABLE_OPERATIONS
  • CampaignError
  • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
  • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
  • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
  • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
  • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
  • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
  • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
• 新增AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS，支援為最高成效廣告活動自動產生加強型影片素材資源。

規劃

• (僅限已加入許可清單的帳戶) 新增 ContentCreatorInsightsService.GenerateTrendingInsights 使用者可根據指定的目標對象定義，查看 YouTube 上的熱門內容主題。
• 新增 GenerateCreatorInsightsRequest.country_locations[] 指定要搜尋符合條件的國家/地區
• 新增 GenerateCreatorInsightsRequest.search_brand，指定要搜尋的創作者品牌
• 在 YouTubeChannelInsights 中新增欄位，為 search_channels 要求提供額外的管道資訊：
  • channel_url
  • channel_description
  • top_videos
• 在 AudienceInsightsAttributeMetadata 中新增中繼資料欄位：
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

影片

• DataLinkService.CreateDataLink 發布後，我們新增了下列方法，可變更先前建立的資料連結：
  • RemoveDataLink，從 Google Ads 帳戶中移除資料連結
  • UpdateDataLink，瞭解如何在 Google Ads 帳戶中接受、拒絕及撤銷資料連結
• 已從下列列舉中移除 VIDEO_OUTSTREAM 的支援：
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

封存的版本資訊

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