版本資訊

17.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 位元組時，就會擲回。
• 新增設定 MutateOperation.asset_group_operation 的支援功能 搭配 BatchJobService 使用。這樣一來， 請使用批次處理功能 管理整個最高成效廣告活動請參閱我們全新的專屬指南。

廣告活動

• 在所有欄位、列舉和錯誤中，所有欄位、列舉和錯誤都將「探索」重新命名為「需求開發」 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
• 新增對 metrics.search_impression_share 的支援 適用於 gender_view
• 新增對 metrics.phone_calls 的支援 適用於 keyword_view

在地生活服務

• 已新增「LocalServicesLeadService.AppendLeadConversation()」 就能將新的 LocalServicesLeadConversation 至 LocalServicesLead，後者會將 則會根據通訊方式和簡訊等適當的管道 已建立待開發客戶。
  • AppendLeadConversationRequest.conversations 的規模有限 1,000 人
  • 只有LocalServicesLead： lead_type 已設為 LeadType.MESSAGE 可指定為 Conversation.local_services_lead。
• 已將新的列舉值新增至 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 使用者介面的「產品」頁面對應。支援傳回 與 Google Merchant Center 產品目前狀態相關的資料 帳戶。
  • 您可以篩選下列指標： shopping_product 報表，使用： segments.date (使用中) GoogleAdsService.Search 或 GoogleAdsService.SearchStream。 不允許按日期劃分，但會傳回 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 個相似使用者名單的數量。

廣告活動

• 支援傳回 Target 廣告投資報酬率廣告活動出價模擬結果： 應用程式廣告活動 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。

實驗

• 新的列舉值：ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT。

在地生活服務

• 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。
• 已將 data_partner 和 google_ads 從以下位置移除： AccountLink。
• 已新增 IdentityVerificationService 到 管理廣告主身分驗證程序。
  • StartIdentityVerification() 用於啟動驗證工作階段 verification_program。 這個外掛程式會建立新的驗證工作階段，並針對 已成功建立驗證作業。
    • 已新增 IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION。
  • GetIdentityVerification() 可用於擷取驗證資訊， IdentityVerification 的多個物件。 每個 IdentityVerification 都包含：
    • verification_program 這是身分驗證計畫類型
    • identity_verification_requirement 其中包含了 廣告主應完成驗證
    • verification_progress ，其中包含驗證工作階段的相關詳細資料，包括：
      • program_status 代表這個項目的目前狀態 驗證工作階段
      • action_url 會將客戶導向要完成 驗證。
      • invitation_link_expiration_time 代表到期日 適用於action_url
  • 列舉：
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • 錯誤：
    • IdentityVerificationError
• 已新增 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 廣告可以根據地理位置和城市建立商家資訊群組 可用的旅遊活動：
  • activity_state
  • activity_city
• 新增對下列區隔的支援 travel_activity_performance_view：
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

在地生活服務

• 已新增 LocalServicesVerificationArtifact.business_registration_check_verification_artifact 和 BusinessRegistrationCheckArtifact 能讓廣告客戶監控商業登記進度 驗證程序。
• 已新增資源 local_services_employee 允許 廣告客戶擷取他們加入的員工資訊

規劃

• 已將score從以下位置移除： AudienceInsightsAttributeMetadata。

建議

• 已新增 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 ，為連結到產品的購物廣告活動提供更詳細的錯誤資訊 購物比較服務中心 帳戶。
• 將下列值新增至 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 帳戶：
  • 已新增 ProductLink.merchant_center 和 MerchantCenterIdentifier。
  • 已新增 LinkedProductType.MERCHANT_CENTER。
• 已新增 ProductLinkInvitationService 和 贊助 ProductLinkInvitation 更新其他產品傳送的連結邀請 (適用於飯店) Center 與 Merchant 中心帳戶。
• 移除了 MerchantCenterLinkService。
  • 如要連結 Google Ads 帳戶與 Merchant Center 帳戶，請使用 ProductLinkInvitationService 和 ProductLinkService。
• 已移除 AccountLink.hotel_center，並支援更新連結邀請的更新功能 從 Hotel Center 帳戶 AccountLinkService。
  • 如要從 Hotel Center 帳戶更新連結邀請，請使用 ProductLinkInvitationService。

素材資源

• 已將「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.asset_group」 只有在 Audience.scope 是 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 已設為共用組合。 廣告活動條件可在搜尋廣告活動中指定，也可以排除在 最高成效廣告活動。

  • 欄位：
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • 列舉：
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• 已新增 Campaign.asset_automation_settings[] 即可顯示各素材資源類型的自動化狀態。

• 將下列值新增至 CampaignPrimaryStatusReason 列舉：

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

轉換

• 已新增 CallConversion.consent 和 贊助 ClickConversion.consent 提供同意聲明。請參閱我們的 來電轉換指南 以及點擊轉換指南瞭解詳情 詳細資料。
• 已新增下列與 SKAdNetwork 轉換，只要利用 customer 或 campaign：
  • 區隔：
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • 指標：
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• 已將「metrics.sk_ad_network_conversions」替換成 metrics.sk_ad_network_installs。
• 新增診斷離線轉換上傳的支援功能
  • 移動了 offline_conversion_upload_client_summary 從 customer 資源中的欄位轉換為頂層報表。使用這份草稿 報表來取得轉換上傳狀態的實用詳細資料，例如 成功事件計數、成功率和錯誤百分比
    • 注意：這是指已上傳但產生了 ConversionUploadError.CLICK_NOT_FOUND 錯誤仍會視為成功，但也會標記為 OfflineConversionAlert。
  • 將 job_id 新增為下列要求類型的選用參數，因此 您就能以邏輯方式將多個上傳要求歸類為單一概念 工作：
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • 已將 INVALID_JOB_ID 新增至下列錯誤：
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • 已將 INVALID_CONVERSION_ACTION 替換成 NO_CONVERSION_ACTION_FOUND 和 發生下列錯誤：INVALID_CONVERSION_ACTION_TYPE：
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• 新增三份報表，支援 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：
  • 區隔：
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • 指標：
    • 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

在地生活服務廣告

• 已新增 LocalServicesSettings 及其 欄位加入 customer 報表，以便傳回本地資訊 服務廣告主精細執照和保險狀態。
• 添加了以下本機報表 服務：
  • local_services_lead 包含所有 與在地生活服務相關的詳細資料 Google Ads 待開發客戶 (例如 lead_charged)、 lead_type，lead_status。
    • 列舉：
      • LeadStatus
      • LeadType
  • local_services_lead_conversation 包含訊息和電話對話詳細資料，例如 conversation_channel，call_duration_millis，call_recording_url。
    • 電話錄音網址已經過驗證目標客戶驗證 和管理員帳戶
  • local_services_verification_artifact 會傳回「在地生活服務」廣告客戶的構件，例如背景調查 營業執照和商業保險資料。任何相關聯的文件 取得執照和保險資訊可透過網址存取。
    • 列舉：
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

規劃

• 新增傳回 Forecast.views 和 PlannedProductForecast.views： ReachPlanService.ListPlannableProducts 適用的產品類型
• 新增支援服務 PlannableTargeting.surface_targeting 的 ReachPlanService.ListPlannableProducts, 此屬性說明產品可用的平台。
• 新增了 ReachPlanSurface 列舉
• 新增指定目標 頻率 AdvancedProductTargeting.target_frequency_settings, 並傳回 PlannedProductForecast.average_frequency。
• 已新增 AudienceInsightsService.GenerateSuggestedTargetingInsights 傳回建議的可指定目標對象
• 將下列值新增至 ReachPlanError：
  • NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
  • NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

建議

• 已新增 RecommendationSubscriptionService 管理推薦訂閱項目的方式如下：
  • 資源： RecommendationSubscription
  • 欄位： MutateOperation.recommendation_subscription_operation
  • 列舉： ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • 錯誤：
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• 新增了下列建議類型：
  • FORECASTING_SET_TARGET_CPA 這樣對於沒有設定目標單次轉換出價的廣告活動，就會建議設定目標單次轉換出價 來到預計將會增加的季節性事件之前 流量
  • SET_TARGET_CPA 這樣對於沒有設定目標單次轉換出價的廣告活動，就會建議設定目標單次轉換出價 。
  • SET_TARGET_ROAS 這樣對於沒有目標廣告投資報酬率的廣告活動，建議您設定目標廣告投資報酬率 。

報表

• 新增了下列指標，可供查詢 campaign (適用於多媒體、影片、探索和探索廣告活動) 應用程式廣告活動) 和 segments.device：
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

購物

• 移除 ShoppingSetting.sales_country，其值現在傳回為 ShoppingSetting.feed_label。
  • 你可以繼續使用特定的 Merchant Center 這個 ShoppingSetting.feed_label ] 欄位。應設為動態饋給標籤值或雙字母國家/地區 程式碼先前為 ShoppingSetting.sales_country 所使用的程式碼。詳情 請參閱動態饋給的支援文章 標籤。
• 已移除報表中國家/地區代碼對產品類別的依賴。 支援的類別 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
  • 這些指標全都能在下列報表中選取：
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

統一的目標

• 已新增 CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals 在客戶層級設定獲取新客目標。
  • 檢舉：customer_lifecycle_goal
• 已新增 CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals 在廣告活動層級設定獲取新客目標。
  • 檢舉：campaign_lifecycle_goal
• 已新增 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 的功能：
  • 已新增 NetworkSettings.target_google_tv_network
  • 已新增 AdNetworkType.GOOGLE_TV。
• 新增在廣告活動層級指定 YouTube 的功能：
  • 已新增 NetworkSettings.target_youtube
  • 在 AdNetworkType 中，已合併 由 YOUTUBE_WATCH 和 YOUTUBE_SEARCH 成 YOUTUBE。
  • 已新增 CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE。

封存的版本資訊

如需封存的版本資訊，請參閱尚未設定的版本。