版本資訊

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 中新增 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.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

封存的版本資訊

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