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_VIDEOSGENERATE_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_resultsreturn_summary_rowreturn_total_results_count
- 新增以下指標,用於追蹤一般無效點擊 (例如機器人或檢索器產生的點擊,以及具有不規則模式的點擊)。您可以使用
campaign報表查詢這些項目。 - 在
QuotaError中新增下列值:EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTIONEXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
v17.1.0 (2024-08-07)
以下新功能和更新項目已在 v17_1 中新增。
素材資源
目標對象
UserListCustomerTypeCategory中的新列舉值:LOYALTY_TIER_1_MEMBERSLOYALTY_TIER_2_MEMBERSLOYALTY_TIER_3_MEMBERSLOYALTY_TIER_4_MEMBERSLOYALTY_TIER_5_MEMBERSLOYALTY_TIER_6_MEMBERSLOYALTY_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_statusprimary_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_timelocal_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_FAMILIESBRAND_SUITABILITY_GAMES_FIGHTINGBRAND_SUITABILITY_GAMES_MATUREBRAND_SUITABILITY_HEALTH_SENSITIVEBRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINEDBRAND_SUITABILITY_NEWS_RECENTBRAND_SUITABILITY_NEWS_SENSITIVEBRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATUREDBRAND_SUITABILITY_POLITICSBRAND_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_COUNTERINVALID_EVENT_NAME
條件
BrandInfo中的新欄位:display_nameprimary_urlrejection_reasonstatus
- 新列舉:
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_statusprimary_status_reasons
- 新增至下列欄位,以便在
AdGroupAd中顯示廣告群組廣告是否放送,或未放送的原因:primary_statusprimary_status_reasons
- 在
AdGroupError中新增下列值:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPEINVALID_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_ALLOWEDDUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUPFILTER_EXCLUSION_NOT_ALLOWEDLISTING_SOURCE_NOT_ALLOWEDMULTIPLE_LISTING_SOURCESMULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWEDMULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUPPAGE_FEED_FILTER_HAS_PARENT
生命週期目標
- 將
update新增至CustomerLifecycleGoalOperation和CampaignLifecycleGoalOperation,以便這些作業類型與 API 中的其他作業類型保持一致。
封存的版本資訊
如要查看封存的版本資訊,請參閱停用的版本。