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.MONTHLY
TargetFrequencySettings
,產生目標頻率每月觸及預測。
- 開發人員可以使用
- 新增方法
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
和下列列舉和錯誤,使用訊息素材資源。- 列舉:
- 新增
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
的支援:
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.results_conversions_purchase
,可傳回廣告活動統一目標結果的轉換購買次數。 - 已將
DemandGenCampaignSettings.upgraded_targeting
的預設值從false
變更為true
。
條件
- 新增
content_criterion_view
,可傳回指定內容的成效指標,例如多媒體、需求開發和影片廣告活動的關鍵字、刊登位置和主題。
飯店和旅遊
- 支援搜尋廣告旅遊動態饋給
- 新增
ClickType.TRAVEL_ASSETS
,可區隔搜尋廣告旅遊動態饋給的指標。 - 新增
AssetSetType.TRAVEL_FEED
可用於選擇是否使用搜尋廣告旅遊動態饋給。
- 新增
- (僅限已加入許可清單的帳戶) 新增旅遊行程做為新的轉換價值規則,並提供下列新欄位和值:
- 為
campaign
和ad_group
報表新增下列區隔,方便您根據飯店和搜尋廣告活動的特定目的地 (城市、國家/地區和區域) 區隔成效資料:
在地生活服務
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
報表查詢。 - 在
QuotaError
中新增下列值:EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
封存的版本資訊
如需封存的版本資訊,請參閱「已淘汰版本」。