版本資訊

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 中指定 lead_type 設為 LeadType.MESSAGE 的 LocalServicesLead。
• 已將新的列舉值新增至 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。

實驗

• 新的列舉值：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。
• 已從 AccountLink 中移除 data_partner 和 google_ads。
• 已新增「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，以支援更新來自其他產品的連結邀請 (適用於 Hotel Center 和 Merchant Center 帳戶)。
• 移除了 MerchantCenterLinkService。
  • 如要連結 Google Ads 帳戶與 Merchant Center 帳戶，請使用 ProductLinkInvitationService 和 ProductLinkService。
• 已移除 AccountLink.hotel_center，並支援使用 AccountLinkService 從 Hotel Center 帳戶更新連結邀請。
  • 如要從 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.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 設為共用組合，附加至廣告活動。廣告活動條件可在搜尋廣告活動中指定，並分別在最高成效廣告活動中排除。

  • 欄位：
    • 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

在地生活服務廣告

• 在 customer 報表中加入 LocalServicesSettings 及其欄位，以便傳回在地生活服務廣告客戶的詳細執照和保險狀態。
• 為在地生活服務新增了下列報表：
  • local_services_lead 包含與在地生活服務廣告待開發客戶相關的所有詳細資料，例如 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
• 新增對 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：
  • 資源：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。
  • 您可以使用 ShoppingSetting.feed_label 欄位，繼續為廣告活動使用特定的 Merchant Center 動態饋給。應設為動態饋給標籤值，或是先前用於 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。

封存的版本資訊

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