版本資訊

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，可針對搜尋字詞、廣告標題和到達網頁的組合回報成效。這個檢視畫面會顯示哪些搜尋查詢觸發了您的廣告，以及這些特定組合的成效。日後推出的版本將提供額外檢視畫面，其中也會包含最高成效資料。如果不想遷移導入項目來取得最高成效廣告活動資料，建議等待該版本發布。

• 已將 AI_MAX 新增為 search_term_match_type 區隔的新值。

素材資源

• 已在 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 欄位。過去，這個欄位只能在建立新廣告活動時設定。

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

• 在 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資源，可匯總廣告群組指定地區興趣條件的成效。

轉換

• 已將 ENGAGED_VIEW 新增為 conversion_attribution_event_type 區隔的新值。

• 顧客將無法再透過 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 報表。這個檢視畫面提供廣告活動層級的匯總搜尋字詞指標。這個檢視畫面也支援最高成效廣告活動的搜尋字詞。

• 已將 PERFORMANCE_MAX 新增為 search_term_match_type 區隔的新值。

規劃

• 新增方法 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_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

v18 (2024-10-16)

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

帳戶管理

• (僅限已加入許可清單的帳戶) 新增 DataLinkService.CreateDataLink，可將 Google Ads 帳戶連結至創作者 YouTube 頻道代管的創作者影片。影片連結可讓 Google Ads 帳戶使用創作者影片放送合作夥伴廣告。

廣告群組

• 新增 AdGroup.exclude_demographic_expansion，可讓您在 optimized_targeting_enabled 為 true 時，排除擴展客層，這項功能先前僅支援需求開發廣告活動。

廣告

• 新增 AdGroupAd.ad_group_ad_asset_automation_settings，可選擇是否讓系統自動產生廣告素材資源。
• 在 AssetAutomationType 中加入下列值：
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
• 新增 AdNetworkType.GOOGLE_OWNED_CHANNELS，用於在 Google 擁有的管道 (例如 YouTube、Gmail 和探索動態消息) 上放送的廣告。

素材資源

• 「AssetType.DISCOVERY_CAROUSEL_CARD」已重新命名為「AssetType.DEMAND_GEN_CAROUSEL_CARD」。

廣告活動

• 新增 metrics.store_visits_last_click_model_attributed_conversions，可傳回廣告活動最終點擊模式歸因的親臨門市次數。
• 為廣告活動新增下列影片觀看相關指標：
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• 新增 metrics.results_conversions_purchase，可傳回廣告活動統一目標結果的轉換購買次數。
• 已將 DemandGenCampaignSettings.upgraded_targeting 的預設值從 false 變更為 true。

條件

• 新增 content_criterion_view，可傳回指定內容的成效指標，例如多媒體、需求開發和影片廣告活動的關鍵字、刊登位置和主題。

飯店和旅遊

• 支援搜尋廣告旅遊動態饋給
  • 新增 ClickType.TRAVEL_ASSETS，可區隔搜尋廣告旅遊動態饋給的指標。
  • 新增 AssetSetType.TRAVEL_FEED 可用於選擇是否使用搜尋廣告旅遊動態饋給。
• (僅限已加入許可清單的帳戶) 新增旅遊行程做為新的轉換價值規則，並提供下列新欄位和值：
  • ConversionValueRule.itinerary_condition 搭配 ValueRuleItineraryCondition，可指定提前預訂期、行程長度和旅程開始日期
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• 為campaign和ad_group報表新增下列區隔，方便您根據飯店和搜尋廣告活動的特定目的地 (城市、國家/地區和區域) 區隔成效資料：
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

在地生活服務

• PhoneCallDetails.call_recording_url 會是空白，而不是提供無效的網址 (如果指定區域服務待開發客戶對話沒有通話錄音)。
• 新增 CategoryBid.target_cpa_bid_micro，可透過 Campaign.local_services_campaign_settings 設定類別的目標單次動作出價。

最高成效

• 支援品牌宣傳指南
  • 已新增「已新增」 Campaign.brand_guidelines_enabled，顯示特定最高成效廣告活動是否已啟用品牌宣傳指南。如果啟用這項功能，則必須將 field_type 設為 BUSINESS_NAME、LOGO 或 LANDSCAPE_LOGO 的資產連結為 CampaignAsset 資源，而非 AssetGroupAsset 資源。
  • 新增CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED和CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED錯誤，表示已啟用品牌宣傳指南的最高成效廣告活動，未連結至廣告活動所需的CampaignAsset資源。
  • 啟用品牌宣傳指南後，至少須將一個field_type設為BUSINESS_NAME，並將至少一個LOGO連結至廣告活動做為CampaignAsset資源。如果最高成效廣告活動 (適用於線上銷售，並使用產品動態饋給) 的素材資源群組已連結素材資源，就必須符合這項規定。
  • 在 AssetLinkError 中新增下列值：
  • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL， 嘗試將品牌資產連結至廣告活動時，系統會擲回這個錯誤，因為在未啟用品牌宣傳指南的最高成效廣告活動中，品牌資產是AssetGroupAsset資源，而不是CampaignAsset資源。
  • BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL嘗試將品牌素材資源連結至廣告活動時，系統會擲回錯誤，因為這些素材資源是 AssetGroupAsset 資源，而不是CampaignAsset 資源，且最高成效廣告活動已啟用品牌宣傳指南。
• 新增 performance_max_placement_view， 可傳回最高成效廣告放送的刊登位置曝光次數。
• 已新增 AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

規劃

• (僅限已加入許可清單的帳戶) 新增了 ContentCreatorInsightsService.GenerateCreatorInsights 方法，使用者可藉此探索頂尖 YouTube 創作者的洞察資料。客戶可根據目標對象指定和內容指定組合搜尋創作者，或根據 YouTube 頻道 ID 清單搜尋創作者洞察資料。
• 「AudienceInsightsService.GenerateSuggestedTargetingInsights」的更新：
  • 已將 audience、baseline_audience 和 data_month 移至 audience_definition。
  • 新增audience_description功能，可使用生成式 AI，根據任意形式的文字說明生成目標對象建議。
• 新增 AudienceInsightsService.GenerateTargetingSuggestionMetrics，可針對指定的目標對象組合傳回潛在觸及指標。

建議

• RecommendationService.GenerateRecommendations 現在可用於在建立廣告活動時，透過在 GenerateRecommendationsRequest.recommendation_types[] 中加入 CAMPAIGN_BUDGET 建議類型，產生有關最佳化預算建議的建議。 這項功能適用於最高成效和搜尋廣告活動。

報表

• 取代 SearchGoogleAdsRequest 的 summary_row_setting 和 return_total_results_count 欄位，改用 search_settings 欄位，其類型為 SearchSettings，包含下列欄位：
  • omit_results
  • return_summary_row
  • return_total_results_count
• 新增一般無效點擊的相關指標，例如由機器人或檢索器產生的點擊，以及具有反常模式的點擊。可使用 campaign 報表查詢。
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• 在 QuotaError 中新增下列值：
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

封存的版本資訊

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