版本資訊

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 等。使用者現在應使用資產來達成相同目的。如需所有已移除實體的清單，請參閱遷移附註。

飯店和旅遊

• 將 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 資源。只有在廣告活動的素材資源群組中連結了素材資源時，最高成效廣告活動 (含有產品動態饋給的線上銷售專用) 才需要符合這項規定。
  • 在 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，可使用 Gen 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_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

v17.1.0 (2024-08-07)

以下新功能和更新項目已在 v17_1 中新增。

素材資源

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() 可讓您移除與回應式搜尋廣告連結的特定自動建立的素材資源。

目標對象

• UserListCustomerTypeCategory 中的新列舉值：
  • LOYALTY_TIER_1_MEMBERS
  • LOYALTY_TIER_2_MEMBERS
  • LOYALTY_TIER_3_MEMBERS
  • LOYALTY_TIER_4_MEMBERS
  • LOYALTY_TIER_5_MEMBERS
  • LOYALTY_TIER_6_MEMBERS
  • LOYALTY_TIER_7_MEMBERS

廣告活動

• ShareablePreviewService.GenerateShareablePreviews() 會為已啟用和暫停的素材資源群組產生可分享廣告預覽的網址 (在回應中為 shareable_preview_url)。
  • expiration_date_time 欄位會指出回應中網址的到期日。
  • 如果發生錯誤，方法會傳回 partial_failure_error，而不是網址。

變更記錄

• 新的變更狀態資源類型：ASSET_GROUP。

轉換

• SKAdNetwork 版本的新區隔欄位：segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary，可在轉換動作層級顯示轉換上傳診斷資訊。
• 下列指標會新增至離線診斷報表，用於顯示仍在處理中上傳的轉換次數：
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary：
    • pending_count

規劃

• AudienceInsights.GenerateAudienceOverlapInsights() 可接受輸入的主要屬性和目標對象屬性集合，並傳回主要屬性和目標對象屬性之間，潛在 YouTube 觸及率重疊的估計值。

報表

• 支援根據 segments.date 區隔 per_store_view

影片

• 支援使用報表擷取與下列標準出價策略相關的資訊，例如 ad_group、campaign：
  • Campaign.fixed_cpm (固定千次曝光出價)
  • Campaign.target_cpv (目標單次收視出價)
• Campaign.video_campaign_settings，可讓您使用下列報表欄位，決定影片廣告可顯示的廣告空間：
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type，可讓您根據影片廣告格式類型區隔下列報表：
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

v17 (2024-06-05)

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

廣告

• 已移除 AdService.getAd。這可讓 AdService 與 Google Ads API 中的其他服務保持一致。如要瞭解擷取廣告和其他資源類型的建議方式，請參閱「擷取物件」一文。
• 針對 ImageAdInfo.image_asset 新增了更多驗證維度和格式。如果圖片無效，系統可能會擲回下列錯誤：
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

素材資源

• 新增列舉：ClickType.AD_IMAGE
• 新增下列報表，其中包含最高成效和搜尋廣告活動的新指標：
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

目標對象

• 已新增 OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

批次工作

• 新增 BatchJobError.REQUEST_TOO_LARGE，當提交的 AddBatchJobOperationsRequest 大於 10484504 個位元組時，系統會擲回此例外狀況。
• 新增支援使用 BatchJobService 時設定 MutateOperation.asset_group_operation。這樣一來，您就能使用批次處理功能建立及管理整個最高成效廣告活動。請參閱新的專屬指南。

廣告活動

• 在 Google Ads API 的所有資源 (例如廣告活動、廣告和素材資源) 的所有欄位、列舉、錯誤中，將「探索」重新命名為「需求開發」。例如，AdvertisingChannelType.DISCOVERY 現為 AdvertisingChannelType.DEMAND_GEN。
• 新增 Campaign.keyword_match_type，讓您為廣告活動中的所有關鍵字設定關鍵字比對類型。

轉換

• 針對 SKAdNetwork 轉換，
  • 已將 segments.sk_ad_network_conversion_value 重新命名為 segments.sk_ad_network_fine_conversion_value。
  • 新增 segments.sk_ad_network_redistributed_fine_conversion_value。
• 下列指標現在會隨回應傳回，即使值為零也一樣。這可與其他指標保持一致。
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

條件

• 已新增至下列欄位，以便在 AdGroupCriterion 中顯示廣告群組條件是否正在放送，或未放送的原因：
  • primary_status
  • primary_status_reasons
• 新增對 gender_view 的 metrics.search_impression_share 支援
• 新增對 keyword_view 的 metrics.phone_calls 支援

在地生活服務

• 新增 LocalServicesLeadService.AppendLeadConversation()，用於將新的 LocalServicesLeadConversation 附加至 LocalServicesLead，並根據待開發客戶的建立方式，透過簡訊等適當管道將訊息傳送給使用者。
  • AppendLeadConversationRequest.conversations 的大小上限為 1,000。
  • Conversation.local_services_lead 中只能指定 LocalServicesLead，且 lead_type 必須設為 LeadType.MESSAGE。
• 已將新的列舉值新增至 ConversationType：
  • WHATSAPP 代表透過 WhatsApp 引入的對話。
  • ADS_API 代表使用新 LocalServicesLeadService.AppendLeadConversation() 方法引入的對話。
• 在 local_services_verification_artifact 中新增下列欄位：
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

報表

• 您現在可以只選取與一個 已連結產品相關的欄位，來查詢 product_link。選取多個已連結產品的多個欄位時，系統會擲回 QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE。舉例來說，您無法在同一個查詢中選取 product_link.advertising_partner.customer 和 product_link.data_partner.data_partner_id。
• 將 page_size 傳遞至 GoogleAdsService.Search 會導致 RequestError.PAGE_SIZE_NOT_SUPPORTED 錯誤。

購物

• 新增報表 shopping_product，對應至 Google Ads UI 的「產品」頁面。這項作業可從已連結至 Google Ads 帳戶的 Google Merchant Center 帳戶，傳回與產品目前狀態相關的資料。
  • 使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 時，您可以使用 segments.date 篩選 shopping_product 報表中的指標。系統不允許依日期進行區隔，因此會傳回 ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION 錯誤。

統一目標

• 新增 UserListCustomerTypeService.MutateUserListCustomerTypes()，用於設定目標對象客戶類型。
• 移除了 CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings。如要設定顧客生命週期目標的目標對象設定，請改用 UserListCustomerTypeService.MutateUserListCustomerTypes()。
  • 您可以將UserListCustomerType.customer_type_category 設為 UserListCustomerTypeCategory.PURCHASERS，分別將使用者名單納入或排除現有顧客生命週期目標的定義，藉此附加或取消附加使用者名單。詳情請參閱「區隔目標對象」。

影片

• 將下列值新增至 ContentLabelType。您可以在客戶層級排除這些 ContentLabelTypes：
  • BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
  • BRAND_SUITABILITY_GAMES_FIGHTING
  • BRAND_SUITABILITY_GAMES_MATURE
  • BRAND_SUITABILITY_HEALTH_SENSITIVE
  • BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
  • BRAND_SUITABILITY_NEWS_RECENT
  • BRAND_SUITABILITY_NEWS_SENSITIVE
  • BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
  • BRAND_SUITABILITY_POLITICS
  • BRAND_SUITABILITY_RELIGION
• 新增 AdVideoAsset.ad_video_asset_info，在建立 DemandGenVideoResponsiveAdInfo 時支援影片素材資源偏好設定。
• (僅限許可清單帳戶) 讓 Campaign.video_brand_safety_suitability 可變動。

封存的版本資訊

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