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
報表新增下列區隔,讓您可以依據飯店和搜尋廣告活動的特定目的地 (城市、國家/地區和區域) 區隔成效資料:
在地生活服務
- 如果指定的 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
,可使用生成式 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_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
v17.1.0 (2024-08-07)
以下新功能和更新項目已在 v17_1 中新增。
素材資源
目標對象
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
,可在轉換動作層級顯示轉換上傳診斷資訊。- 下列指標會新增至離線診斷報表,用於顯示仍在處理中上傳的轉換次數:
規劃
AudienceInsights.GenerateAudienceOverlapInsights()
可接受輸入的主要屬性和目標對象屬性集合,並傳回主要屬性和目標對象屬性之間,潛在 YouTube 觸及率重疊的估計值。
報表
- 支援根據
segments.date
區隔per_store_view
影片
- 支援使用報表擷取與下列標準出價策略相關的資訊,例如
ad_group
、campaign
:Campaign.fixed_cpm
(固定千次曝光出價)Campaign.target_cpv
(目標單次收視出價)
Campaign.video_campaign_settings
,可讓您使用下列報表欄位,決定影片廣告可顯示的廣告空間:segments.ad_format_type
,可讓您根據影片廣告格式類型區隔下列報表:
v17 (2024-06-05)
以下功能和變更已在 v17 中新增。
廣告
- 已移除
AdService.getAd
。這可讓AdService
與 Google Ads API 中的其他服務保持一致。如要瞭解擷取廣告和其他資源類型的建議方式,請參閱「擷取物件」。 - 針對
ImageAdInfo.image_asset
新增了更多驗證維度和格式。如果圖片無效,系統可能會擲回下列錯誤:
素材資源
- 新增列舉:
ClickType.AD_IMAGE
- 新增下列報表,其中包含最高成效和搜尋廣告活動的新指標:
目標對象
批次工作
- 新增
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
。
- 已將
- 下列指標現在會隨回應傳回,即使值為零也一樣。這可與其他指標保持一致。
條件
- 已新增至下列欄位,以便在
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
可變動。
v16.1.0 (2024-04-24)
以下功能和變更已在 16.1 版中新增。
帳戶管理
CustomerNegativeCriterion.ip_block
,可在客戶層級新增 IP 做為排除條件。- 新列舉值:
ProductLinkError.LINK_EXISTS
。 - 新列舉值:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
。
素材資源
- 支援與需求開發相關的素材資源,可用於
ad_group_ad_asset_view
和asset_field_type_view
。 - 新列舉值:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
。
目標對象
- 新列舉值:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
,可將客戶可擁有的相似目標對象使用者清單數量限制在 1000 個。
廣告活動
- 使用
campaign_simulation
報表,為應用程式廣告活動提供目標廣告投資報酬率廣告活動出價模擬結果。 - 新列舉值:
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
。 - 新列舉值:
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
。 - 新列舉值:
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
。
轉換
SkAdNetworkConversionValueSchema.postback_mappings
,支援 SKAdNetwork 4.0 功能。- 新增對
CustomerSkAdNetworkConversionValueSchemaService
警告的支援,做為MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
。設為true
時,系統會以MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
的形式傳回與作業失敗相關的非阻斷錯誤。 CustomerSkAdNetworkConversionValueSchemaError
中的新列舉值:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
條件
BrandInfo
中的新欄位:display_name
primary_url
rejection_reason
status
- 新列舉:
BrandRequestRejectionReason
。 - 新列舉值:
CriterionType.LIFE_EVENT
。
實驗
在地生活服務
local_services_lead.credit_details.credit_state
和local_services_lead.credit_details.credit_state_last_update_date_time
分別會傳回信用狀態和信用狀態更新時的時間戳記。local_services_lead_conversation.message_details.attachment_urls
,會傳回可用來下載附件內容的網址。
影片
customer.video_brand_safety_suitability
和BrandSafetySuitability
,可在客戶層級擷取影片品牌安全合適度。- 新列舉值:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
。
v16 (2024-02-21)
以下功能和變更已在 v16 中新增。
帳戶管理
- 已將
advertising_partner
從AccountLink
遷移至ProductLink
和ProductLinkInvitation
。 - 已從
AccountLink
中移除data_partner
和google_ads
。 - 新增
IdentityVerificationService
,用於管理廣告主身分驗證。StartIdentityVerification()
可用於使用提供的verification_program
啟動驗證工作階段。此方法會建立新的驗證工作階段,並針對成功建立的驗證作業傳回空白回應。GetIdentityVerification()
可用於擷取驗證資訊,並傳回多個IdentityVerification
物件。每個IdentityVerification
都包含:verification_program
,這是身分驗證計畫類型identity_verification_requirement
,其中包含廣告主應在何時完成驗證的詳細資料verification_progress
,其中包含驗證工作階段的詳細資料,包括:program_status
代表此驗證工作階段的目前狀態action_url
會將客戶導向網址,以便完成驗證。invitation_link_expiration_time
代表action_url
的到期日
- 列舉:
- 錯誤:
- 已新增
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
。
素材資源
asset_group
的變更:- 新增對時間相關區隔的支援,例如
segments.year
和segments.month
。 - 將
campaign
設為屬性資源,而非區隔資源。
- 新增對時間相關區隔的支援,例如
廣告活動
- 需求開發廣告活動的變更:
- 新增支援功能,可將
Campaign.shopping_setting
設為現有需求開發廣告活動。 - 新增
ShoppingSetting.disable_product_feed
,用於停用需求開發廣告活動的選用產品動態饋給。 - 新增
Ad.demand_gen_product_ad
和對應的DemandGenProductAdInfo
,適用於具有非空值Campaign.shopping_setting
的需求開發廣告活動。
- 新增支援功能,可將
- 已新增至下列欄位,以便在
AdGroup
中顯示廣告群組是否放送,或未放送的原因:primary_status
primary_status_reasons
- 新增至下列欄位,以便在
AdGroupAd
中顯示廣告群組廣告是否放送,或未放送的原因:primary_status
primary_status_reasons
- 在
AdGroupError
中新增下列值:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
實驗
- 新增
Experiment.sync_enabled
,用於指定是否要在實驗中啟用同步處理功能。啟用同步處理功能後,系統會在實驗執行期間,自動將對原始廣告活動所做的變更複製到實驗廣告活動。 - 已新增
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
。 - 已新增
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
。
飯店和旅遊
- 為景點廣告的
ListingDimensionInfo
新增下列欄位,以便根據可提供旅遊活動的州和城市建立商家資訊群組: travel_activity_performance_view
新增了對下列區段的支援:
在地生活服務
- 新增
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
和BusinessRegistrationCheckArtifact
,方便廣告主監控商家註冊驗證程序的進度。 - 新增資源
local_services_employee
,讓廣告客戶能夠擷取所新增的員工資訊。
規劃
- 已從
AudienceInsightsAttributeMetadata
中移除score
。
建議
- 新增
RecommendationService.GenerateRecommendations()
,可根據指定設定 (例如推薦類型和廣告管道類型) 傳回推薦內容。這在廣告活動建構期間特別實用。 - 已新增
RecommendationMetrics.conversions_value
。 - 建議關鍵字的關鍵字比對類型未設定時,
recommended_match_type
會設為UNSPECIFIED
,而非UNKNOWN
。 - 新增下列類型的最佳化建議:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
,建議您採用盡量提高轉換價值出價策略IMPROVE_GOOGLE_TAG_COVERAGE
,建議您在更多網頁上部署 Google 代碼PERFORMANCE_MAX_FINAL_URL_OPT_IN
,建議您為最高成效廣告活動開啟最終到達網址擴展功能REFRESH_CUSTOMER_MATCH_LIST
,建議更新過去 90 天未更新的客戶名單CUSTOM_AUDIENCE_OPT_IN
,建議您建立自訂目標對象LEAD_FORM_ASSET
,建議您在廣告活動或客戶層級新增待開發客戶表單素材資源IMPROVE_DEMAND_GEN_AD_STRENGTH
,建議您改善需求開發廣告活動的廣告優異度
購物
- 新增
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
和CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
,為連結至 Comparison Shopping Service Center 帳戶的購物廣告活動提供更詳細的錯誤資訊。 - 在
AssetGroupListingGroupFilterError
中新增下列值:DIMENSION_TYPE_NOT_ALLOWED
DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
FILTER_EXCLUSION_NOT_ALLOWED
LISTING_SOURCE_NOT_ALLOWED
MULTIPLE_LISTING_SOURCES
MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
PAGE_FEED_FILTER_HAS_PARENT
生命週期目標
- 將
update
新增至CustomerLifecycleGoalOperation
和CampaignLifecycleGoalOperation
,以便讓這些作業類型與 API 中的其他作業類型保持一致。
封存的版本資訊
如要查看封存的版本資訊,請參閱停用的版本。