16.1.0 版 (2024 年 4 月 24 日)
v16.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 功能。- 以
MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
的形式新增CustomerSkAdNetworkConversionValueSchemaService
的警告支援。設為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)
第 16 版新增了下列功能和異動。
帳戶管理
- 已將
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
,方便廣告主擷取他們新增的員工資訊。
規劃
- 將
score
從AudienceInsightsAttributeMetadata
中移除。
推薦做法
- 新增
RecommendationService.GenerateRecommendations()
,可根據指定的設定 (例如建議類型和廣告管道類型) 傳回建議。這在廣告活動建立期間特別實用。 - 已新增
RecommendationMetrics.conversions_value
。 - 未設定關鍵字比對類型的建議關鍵字,現已設為
UNSPECIFIED
,而非UNKNOWN
。recommended_match_type
- 新增了下列類型的建議:
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 中的其他作業類型一致。
v15 (2023-10-18)
第 15 版推出下列新功能和更新。
帳戶管理
- 如果帳戶因未經授權的帳戶活動而遭到停權,
customer.status
和customer_client.status
現在會傳回SUSPENDED
。先前會傳回ENABLED
。 - 新增及移除 Google Ads 帳戶和 Merchant Center 帳戶之間的連結:
- 新增
ProductLinkInvitationService
和ProductLinkInvitation
,以支援更新透過其他產品傳送的連結邀請 (適用於 Hotel Center 和 Merchant Center 帳戶)。 - 移除了
MerchantCenterLinkService
。- 如要將 Google Ads 帳戶連結至 Merchant Center 帳戶,請使用
ProductLinkInvitationService
和ProductLinkService
。
- 如要將 Google Ads 帳戶連結至 Merchant Center 帳戶,請使用
- 移除了
AccountLink.hotel_center
,並且支援使用AccountLinkService
從 Hotel Center 帳戶更新連結邀請。- 如要透過 Hotel Center 帳戶更新連結邀請,請使用
ProductLinkInvitationService
。
- 如要透過 Hotel Center 帳戶更新連結邀請,請使用
資產
- 將
ImageAdInfo.media_file
替換為ImageAdInfo.image_asset
,以支援使用素材資源新增及移除圖片。因此,我們也移除了不再需要的MediaFileService
。 - 新增
ListingGroupFilterDimension.webpage
,支援根據自訂標籤和網址子字串建立商家資訊群組篩選器。- 同時將
AssetGroupListingGroupFilter.vertical
替換為AssetGroupListingGroupFilter.listing_source
和ListingGroupFilterListingSource
- 同時將
- 加入
asset_group_asset.source
,顯示素材資源群組素材資源的來源。 - 新增
ad_group_ad_asset_view.source
,顯示廣告群組廣告素材資源的來源。
目標對象
- 針對目標顧客比對,新增了
CustomerMatchUserListMetadata.consent
以支援提供同意聲明。自 2024 年 3 月 6 日起,如果歐洲經濟區境內使用者未取得同意聲明,系統會將同意聲明值視為不同意。未經歐洲經濟區境內使用者同意,系統不會處理這些使用者的資料,也無法透過目標顧客比對使用這類資料放送個人化廣告。詳情請參閱目標客戶比對指南。 - 針對商店銷售,新增
UserData.consent
以支援提供同意聲明。詳情請參閱商店銷售指南。如果您搭配商店銷售使用目標顧客比對功能,請參閱常見問題以瞭解詳情。 - 新增
UserList.lookalike_user_list
以支援建立類似區隔,根據現有的種子目標對象建立目標對象。類似區隔只能在需求開發廣告活動中使用。
廣告活動
最高成效廣告活動更新:
AssetGroupSignal
現在支援兩種信號類型,可附加至素材資源群組,用於強化指定目標:AssetGroupSignal.audience
- 新增
Audience.scope
和Audience.asset_group
,將目標對象限制在特定素材資源群組。只有在Audience.scope
為ASSET_GROUP
時,才能設定Audience.asset_group
。
- 新增
AssetGroupSignal.search_theme
- 新增
CriterionType.SEARCH_THEME
,支援新的條件類型。這個新的條件類型只能用於最高成效廣告活動建立AssetGroupSignal
,方法是在AssetGroupSignal.search_theme
中填入SearchThemeInfo
條件。
- 新增
- 新增
AssetGroupSignalOperation.exempt_policy_violation_keys
,支援在新增素材資源群組信號時請求豁免。 - 新增
asset_group_top_combination_view
,回報素材資源群組層級成效最佳的素材資源。 - 您現在可以使用指標欄位查詢
asset_group
,支援擷取最高成效廣告活動的成效。 - 在
PerformanceMaxUpgradeStatus
中,將UPGRADE_ELIGIBLE
重新命名為UPGRADE_ELIGIBLE
。
對於需求開發和探索的目標單次轉換出價廣告活動,廣告活動層級的目標單次轉換出價模擬作業 (
campaign_simulation.target_cpa_point_list.points
) 現在會傳回TargetCpaSimulationPoint.interactions
,而非TargetCpaSimulationPoint.clicks
。新增
BrandSuggestionService
,可根據提供的品牌前置字串和排除品牌清單來建議品牌。這些品牌可用來建立BRAND
條件、加進BRANDS
共用組合,然後再建立CampaignCriterion
並將brand_list
設為共用組合,藉此與廣告活動附加。廣告活動條件可在搜尋廣告活動中指定,並分別從最高成效廣告活動中排除。新增
Campaign.asset_automation_settings[]
,顯示每種素材資源類型的自動化狀態。已將下列值新增至
CampaignPrimaryStatusReason
列舉:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
轉換
- 新增
CallConversion.consent
和ClickConversion.consent
以支援提供同意聲明。詳情請參閱來電轉換指南和點擊轉換指南。 - 新增下列與 SKAdNetwork 轉換相關的欄位,可在使用
customer
或campaign
查詢轉換時使用: metrics.sk_ad_network_conversions
已由metrics.sk_ad_network_installs
取代。- 新增診斷離線轉換上傳作業的支援功能
- 已將
offline_conversion_upload_client_summary
從customer
資源中的欄位移至頂層報表。這份報表可用來取得轉換上傳狀態的實用詳細資料,例如成功的事件數、成功率和錯誤百分比。- 警告:已上傳但產生的
ConversionUploadError.CLICK_NOT_FOUND
錯誤轉換仍會計為成功,但也會標示為OfflineConversionAlert
。
- 警告:已上傳但產生的
- 新增了
job_id
做為下列要求類型的選用參數,方便您按照邏輯將多個上傳要求歸入單一概念工作: - 已在下列錯誤中新增
INVALID_JOB_ID
: - 在下列錯誤中,將
INVALID_CONVERSION_ACTION
替換成NO_CONVERSION_ACTION_FOUND
和INVALID_CONVERSION_ACTION_TYPE
:
- 已將
- 新增三份報表,以支援 Android Privacy Sandbox 跨聯播網歸因 (不含重新導向):
android_privacy_shared_key_google_campaign
,包含shared_campaign_key
及一些有助於對鍵編碼的欄位。android_privacy_shared_key_google_ad_group
,包含shared_ad_group_key
及一些有助於對鍵編碼的欄位。android_privacy_shared_key_google_network_type
,包含shared_network_type_key
及一些有助於對鍵編碼的欄位。
- 已新增
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
。ConversionActionOperation
嘗試使用其中一個已淘汰的規則導向歸因模式,現在會導致錯誤發生。先前作業將會失敗,並顯示UNKNOWN
錯誤。
飯店與旅遊
- 在
travel_activity_group_view
和travel_activity_performance_view
中新增對下列欄位的支援功能:- 區隔:
- 指標:
metrics.search_absolute_top_impression_share
metrics.search_budget_lost_absolute_top_impression_share
metrics.search_budget_lost_impression_share
metrics.search_budget_lost_top_impression_share
metrics.search_impression_share
metrics.search_rank_lost_absolute_top_impression_share
metrics.search_rank_lost_impression_share
metrics.search_rank_lost_top_impression_share
metrics.search_top_impression_share
在地生活服務廣告
- 在
customer
報表中加入LocalServicesSettings
及其欄位,以便傳回在地生活服務廣告主的詳細執照和保險狀態。 - 新增下列有關在地生活服務的報表:
local_services_lead
包含在地生活服務廣告待開發客戶的所有詳細資料,例如lead_charged
、lead_type
、lead_status
。- 列舉:
local_services_lead_conversation
包含訊息和電話對話詳細資料,例如conversation_channel
、call_duration_millis
、call_recording_url
。- 電話電話錄音網址已通過目標客戶帳戶及其管理員帳戶驗證。
local_services_verification_artifact
會傳回在地生活服務廣告主的成果,例如背景調查、商家執照和商業保險資料。任何與執照和保險相關的文件,都可以透過網址存取。
規劃
- 開始支援為
ReachPlanService.ListPlannableProducts
的適用產品類型傳回Forecast.views
和PlannedProductForecast.views
。 - 新增針對
ReachPlanService.ListPlannableProducts
傳回PlannableTargeting.surface_targeting
的支援功能,用於描述產品的可用途徑。 - 已新增
ReachPlanSurface
列舉。 - 新增使用
AdvancedProductTargeting.target_frequency_settings
指定目標頻率的功能,其會傳回PlannedProductForecast.average_frequency
。 - 新增
AudienceInsightsService.GenerateSuggestedTargetingInsights
以傳回建議的可指定目標對象。 - 已將下列值新增至
ReachPlanError
:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
推薦做法
- 新增管理推薦訂閱的
RecommendationSubscriptionService
: - 新增了下列類型的建議:
FORECASTING_SET_TARGET_CPA
建議在預計會增加流量的季節性事件之前,為尚未指定的廣告活動設定目標單次轉換出價。SET_TARGET_CPA
,針對未指定目標單次轉換出價的廣告活動,建議設定目標單次轉換出價。SET_TARGET_ROAS
,建議您為未指定目標廣告投資報酬率的廣告活動設定目標廣告投資報酬率。
報告
- 新增下列新指標,您可以使用
campaign
(適用於多媒體、影片、探索和應用程式廣告活動) 和segments.device
進行查詢:
購物廣告活動
- 已移除
ShoppingSetting.sales_country
,其值現在會傳回ShoppingSetting.feed_label
。- 您可以繼續為廣告活動使用特定的 Merchant Center 動態饋給,只要使用
ShoppingSetting.feed_label
欄位即可。這個項目應設為動態饋給標籤值,或是先前用於ShoppingSetting.sales_country
的雙字母國家/地區代碼。詳情請參閱動態饋給標籤的支援文章。
- 您可以繼續為廣告活動使用特定的 Merchant Center 動態饋給,只要使用
- 移除報表中與國家/地區代碼相關的產品類別。
支援的類別 ID 組合並未變更。
- 已替換
shopping_performance_view
中使用的下列欄位:segments.product_bidding_category_level1
搭配segments.product_category_level1
segments.product_bidding_category_level2
搭配segments.product_category_level2
segments.product_bidding_category_level3
搭配segments.product_category_level3
segments.product_bidding_category_level4
搭配segments.product_category_level4
segments.product_bidding_category_level5
搭配segments.product_category_level5
- 將
product_bidding_category_constant
替換為product_category_constant
,以在重複欄位中傳回某類別的所有可用本地化內容。 ListingDimensionInfo.product_bidding_category
已由ListingDimensionInfo.product_category
取代。ListingGroupFilterDimension.product_bidding_category
已由ListingGroupFilterDimension.product_category
取代。
- 已替換
- 不再支援在搜尋廣告活動中加入
Campaign.shopping_setting
。現在,嘗試使用Campaign.shopping_setting
建立搜尋廣告活動,或將Campaign.shopping_setting
加入現有搜尋廣告活動後,會導致OPERATION_NOT_PERMITTED_FOR_CONTEXT
。 - 已停止支援在搜尋廣告活動中加入
CampaignCriterion.listing_scope
的功能。現在,嘗試在現有搜尋廣告活動中加入CampaignCriterion.listing_scope
,會導致OPERATION_NOT_PERMITTED_FOR_CONTEXT
。 - 新增下列透過購物車資料回報的轉換指標:
metrics.orders
metrics.average_order_value_micros
metrics.average_cart_size
metrics.cost_of_goods_sold_micros
metrics.gross_profit_micros
metrics.gross_profit_margin
metrics.revenue_micros
metrics.units_sold
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
- 下列報表都可以選取這些指標:
統一的目標
- 新增
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
,可在客戶層級設定獲取新客目標。 - 新增
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
,可在廣告活動層級設定獲取新客目標。 - 已新增
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
。 - 已將下列值新增至
ConversionGoalCampaignConfigError
:EMPTY_CONVERSION_GOALS
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
影片
- 新增在廣告活動層級指定 Google TV 的功能:
- 新增在廣告活動層級指定 YouTube 的支援功能:
- 已新增
NetworkSettings.target_youtube
- 在
AdNetworkType
中,將YOUTUBE_WATCH
和YOUTUBE_SEARCH
合併為YOUTUBE
。 - 已新增
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
。
- 已新增
14.1.0 版 (2023 年 8 月 9 日)
第 14.1 版推出下列新功能和更新。
帳戶管理
Customer.customer_agreement_setting
,顯示客戶是否已接受待開發客戶表單服務條款
資產
AssetGroup
中的新欄位可顯示素材資源群組是否正常放送,或是無法放送的原因:primary_status
primary_status_reasons
AssetGroupAsset
中的新欄位,可顯示素材資源群組素材資源是否能放送,或無法放送的原因:primary_status
primary_status_details
primary_status_reasons
CallToActionType
列舉中的新值:BUY_NOW
DONATE_NOW
ORDER_NOW
PLAY_NOW
SEE_MORE
START_NOW
VISIT_SITE
WATCH_NOW
AssetLinkError
列舉中的新值:CUSTOMER_NOT_VERIFIED
UNSUPPORTED_CALL_TO_ACTION
PAGE_FEED_INVALID_LABEL_TEXT
帳單
Invoice
和AccountSummary
中的新欄位:export_charge_subtotal_amount_micros
export_charge_tax_amount_micros
export_charge_total_amount_micros
廣告活動
CampaignPrimaryStatusReason
列舉中的新值:HAS_ASSET_GROUPS_DISAPPROVED
HAS_ASSET_GROUPS_LIMITED_BY_POLICY
MOST_ASSET_GROUPS_UNDER_REVIEW
(僅限許可清單中的帳戶)
DiscoveryCampaignSettings
搭配upgraded_targeting
:- 如果將
upgraded_targeting
設為true
,您可以加入地點和語言做為廣告群組條件
- 如果將
條件
(僅限許可清單中的帳戶) 支援將
LanguageInfo
和LocationInfo
新增為AdGroupCriterion
:- 這項功能僅適用於啟用升級版指定目標的探索廣告活動
實驗
ExperimentError
列舉中的新值:DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
CANNOT_REMOVE_IN_CREATION_EXPERIMENT
CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES
推薦做法
- 新的建議類型:
PerformanceMaxOptInRecommendation
,建議在帳戶中建立第一個最高成效廣告活動ImprovePerformanceMaxAdStrengthRecommendation
,表示建議改善最高成效廣告活動的素材資源群組優異度MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
,建議將動態搜尋廣告活動遷移至最高成效廣告活動
報告
- 新客戶與回訪客戶的全新指標和區隔:
- 新的
customer_search_term_insight
和campaign_search_term_insight
檢視表:metrics.search_volume
會顯示搜尋字詞洞察類別的搜尋量範圍
購物廣告活動
- 商家資訊群組的新欄位:
- 新欄位:
ShoppingSetting.advertising_partner_ids
CampaignError
列舉中的新值:NOT_LINKED_ADVERTISING_PARTNER
INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS
影片
- (僅限許可清單中的帳戶)
AdType.DISCOVERY_VIDEO_RESPONSIVE_AD
和對應的DiscoveryVideoResponsiveAdInfo
v14 (2023-06-07)
第 14 版推出下列新功能和更新。
廣告活動
轉換
新增辨識 Google Analytics (分析) 轉換,以及判斷轉換是從通用 Analytics (分析) 還是 GA4 資源匯入的支援功能:
- 已將下列值新增至
ConversionActionType
:UNIVERSAL_ANALYTICS_GOAL
UNIVERSAL_ANALYTICS_TRANSACTION
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
- 已新增「
ConversionAction.google_analytics_4_settings
」
- 已將下列值新增至
新增
Customer.offline_conversion_client_summaries
,用於總結客戶離線轉換上傳和調整項的狀態和診斷資訊。- 列舉
OfflineEventUploadClient
:GOOGLE_ADS_API
GOOGLE_ADS_WEB_CLIENT
ADS_DATA_CONNECTOR
OfflineConversionDiagnosticStatus
:EXCELLENT
GOOD
NEEDS_ATTENTION
NO_RECENT_UPLOAD
- 列舉
在
ConversionAdjustmentUploadService.UploadConversionAdjustments
和ConversionUploadService.UploadClickConversions
傳回的回應中新增job_id
,以便與OfflineConversionUploadSummary.job_id
建立關聯。
條件
新增對擷取、建立及更新帳戶層級排除關鍵字的支援功能:
- 欄位:
- 列舉:
CriterionType.NEGATIVE_KEYWORD_LIST
SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ResourceLimitType
SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
- 錯誤:
CriterionError
NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE
飯店廣告
SuggestTravelAssetsRequest.place_id
已重新命名為SuggestTravelAssetsRequest.place_ids
。
規劃
- 已從
KeywordPlanService
中移除下列方法:GenerateForecastCurve
GenerateForecastMetrics
GenerateForecastTimeSeries
GenerateHistoricalMetrics
- 新增
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
支援產生關鍵字廣告活動預測指標,不必先建立關鍵字企劃書。 - 停止支援擷取「
campaign_criterion_simulation
」報表 - 新增對
YOUTUBE_DYNAMIC_LINEUP
的支援,做為AudienceInsightsService.ListAudienceInsightsAttributes
中的維度。 - 新增
DynamicLineupAttributeMetadata.sample_channels
,用於GenerateAudienceCompositionInsights
回應,在首選頻道中提供範例管道。
推薦做法
- 新增
DynamicImageExtensionOptInRecommendation
,建議在帳戶中啟用動態圖片額外資訊 - 新增
LowerTargetRoasRecommendation
,可降低目標廣告投資報酬率 - 新增
RaiseTargetCpaRecommendation
,會建議提高目標單次轉換出價 - 已新增「
ResponsiveSearchAdAssetRecommendation.current_ad
」
報告
- 已將下列值新增至
ServedAssetFieldType
,可從ad_group_ad_asset_view.pinned_field
取得:SITELINK
CALL
MOBILE_APP
CALLOUT
STRUCTURED_SNIPPET
PRICE
PROMOTION
AD_IMAGE
LEAD_FORM
BUSINESS_LOGO
封存的版本資訊
如需封存的版本資訊,請參閱未設定的版本。