版本資訊

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

建議

• 將 merchant_center_account_id 欄位新增至 GenerateRecommendationsRequest，以便指出何時應為零售商店產生最佳化建議，而非標準最高成效廣告活動。

規劃

• 新增 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。這項功能僅適用於許可清單中的帳戶。
• 為 ContentCreatorInsightsService 將 sub_country_locations 新增至 GenerateCreatorInsightsRequest。這樣一來，您就能指定子國家/地區的地理位置，藉此精進創作者洞察資料的搜尋結果。只有在 criteria 欄位中使用 search_attributes oneof 時，系統才支援 sub_country_locations 欄位。如果 sub_country_locations 提供其他條件類型，請求將無效。這可讓內容創作者深入瞭解自身的數據洞察，並進行更精細的地理區域指定和分析。這項功能僅適用於許可清單中的帳戶。
• 新增 ReachPlanService.ListPlannableUserLists，用於傳回客戶擁有的第一方使用者名單，並在 GenerateReachForecastRequest 中將 UserListInfo 新增至目標對象指定選項。這可讓您為特定客戶擷取可規劃的使用者名單，然後針對鎖定這些特定目標對象的廣告活動產生觸及數預測資料。這些強化功能可直接將第一方目標對象資料納入預測，進而改善量身打造的觸及規劃。觸及數預測功能僅適用於已核准的帳戶。

影片

• 新增在電視螢幕上放送原生 YouTube 影片的 AdFormatType.PAUSE 廣告，並納入報表。這些廣告會直接顯示在暫停畫面上靜態影片框架旁邊。這項指標不包含在暫停的自然影片下方或上方，顯示在廣告面板上的需求開發影片廣告，這類廣告會在 AdFormatType.INFEED 下方回報。

v19.1 (2025-04-16)

以下功能和變更已在 19.1 版中新增。

素材資源

• 為 AssetGroup 新增 asset_coverage 欄位，用於傳回素材資源群組中的空白區域相關資訊。
  • 包含子欄位 ad_strength_action_items，可傳回廣告客戶可採取的動作清單，以改善素材資源群組的廣告優異度。

廣告活動

• 您現在可以在在地生活服務廣告活動中為待開發客戶評分或提供意見回饋。這項變更的一部分，是 19.1 版
  • 已新增名為 LocalServicesLeadService 的新服務。您可以使用 ProvideLeadFeedback 方法，上傳待開發客戶的評分和意見回饋。
  • 已將名為 lead_feedback_submitted 的新欄位新增至 LocalServicesLead，協助判斷是否已將意見回饋提交給待開發客戶。
• 為應用程式廣告活動新增指標資料欄 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 產品代碼產生目標頻率月觸及數預測時，在 TargetFrequencySettings 中設定 TargetFrequencyTimeUnit.MONTHLY。
• 新增方法 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 說明中心，進一步瞭解這項功能。這項變更會公開：
  • 新的 AdvertisingChannelSubType，名稱為 YOUTUBE_AUDIO。
  • 新的 AdGroupType，名稱為 YOUTUBE_AUDIO。
  • 新的廣告格式列舉 (名稱為 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 來達成相同目的。如需所有已移除實體的清單，請參閱遷移附註。

飯店與旅遊

• 將 ValueRuleItineraryAdvanceBookingWindow 的 min_days 和 max_days 設為 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

在地生活服務

• 如果指定的 Local Services 待開發客戶對話沒有通話錄音，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 的資源，才能將廣告活動連結至field_type 和LOGO。只有在廣告活動的素材資源群組中含有連結的素材資源時，最高成效廣告活動 (含有產品動態饋給的線上銷售專用) 才需要符合這項規定。
  • 將下列值新增至 AssetLinkError：
  • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL，在品牌指南未啟用的最高成效廣告活動中，嘗試將品牌素材資源連結至廣告活動做為 CampaignAsset 資源，而非 AssetGroupAsset 資源時，會擲回此例外狀況。
  • 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 現在可用於在廣告活動建立期間，產生最佳化預算建議的最佳化建議，方法是將 CAMPAIGN_BUDGET 最佳化建議類型納入 GenerateRecommendationsRequest.recommendation_types[]。這項功能適用於最高成效廣告活動和搜尋廣告活動。

報表

• 將 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

封存的版本資訊

如要查看封存的版本資訊，請參閱「停用的版本」。