Bạn muốn chia sẻ ý kiến phản hồi về API Google Ads? Đăng ký để được mời tham gia nghiên cứu người dùng!

Trang này được dịch bởi Cloud Translation API.

Ghi chú phát hành

Phiên bản 19.1 (16/4/2025)

Các tính năng và thay đổi sau đây đã được thêm vào phiên bản 19.1.

Thành phần

Thêm trường asset_coverage cho AssetGroup để trả về thông tin về các khoảng trống trong nhóm thành phần.
- Chứa một trường phụ ad_strength_action_items trả về danh sách các hành động mà nhà quảng cáo có thể thực hiện để cải thiện độ mạnh của quảng cáo trong một nhóm thành phần.

Chiến dịch

Giờ đây, bạn có thể đánh giá hoặc đưa ra ý kiến phản hồi cho khách hàng tiềm năng trong Chiến dịch dịch vụ địa phương. Trong quá trình thay đổi này, phiên bản 19.1
- Thêm một dịch vụ mới có tên là LocalServicesLeadService. Bạn có thể sử dụng phương thức ProvideLeadFeedback để tải điểm xếp hạng và ý kiến phản hồi lên cho khách hàng tiềm năng.
- Thêm trường mới có tên lead_feedback_submitted vào LocalServicesLead để giúp xác định xem ý kiến phản hồi có được gửi đến khách hàng tiềm năng hay không.
Thêm cột chỉ số mới biddable_cohort_app_post_install_conversions cho chiến dịch Quảng cáo ứng dụng.

Tạo nhu cầu

Các phương thức bổ sung đã được giới thiệu trong Dịch vụ lập kế hoạch để hỗ trợ tính năng Tạo nhu cầu.
Thêm tính năng hỗ trợ cho Tính năng kiểm soát kênh cho chiến dịch Tạo nhu cầu ở cấp Nhóm quảng cáo. Bạn có thể chọn một nhóm kênh chung được xác định trước hoặc một nhóm nhỏ kênh bằng cách sử dụng trường demand_gen_ad_group_settings. Các kênh sau được hỗ trợ trong bản phát hành hiện tại:
- Trong luồng phát trên YouTube
- Trong nguồn cấp dữ liệu trên YouTube
- YouTube Shorts
- Khám phá
- Gmail
- Màn hình
Hiển thị một loại tài sản mới cho TALL_PORTRAIT_MARKETING_IMAGE. Loại thành phần này liên quan đến trường tall_portrait_marketing_images của Định dạng quảng cáo nhiều thành phần tạo nhu cầu.

Lịch sử thay đổi

Thêm tính năng hỗ trợ cho 3 loại tài nguyên khác vào ChangeStatusResourceType:
- CAMPAIGN_BUDGET
- ASSET_SET
- CAMPAIGN_ASSET_SET
Bạn có thể truy xuất 3 loại chi tiết hơn này từ báo cáo change_status.

Lượt chuyển đổi

Giờ đây, bạn có thể đặt trường google_ads_conversion_customer trong khi tạo khách hàng mới bằng API Google Ads. Trước đây, đây là trường chỉ có thể đọc.
Giờ đây, bạn có thể chỉ định loại khách hàng liên kết với lượt chuyển đổi khi tải lượt chuyển đổi ngoại tuyến lên.
Giới thiệu trường session_attributes mới cho ClickConversion.

Quảng cáo dịch vụ địa phương

Thêm RPC mới ProvideLeadFeedback vào LocalServicesLeadService để cung cấp ý kiến phản hồi về chất lượng của LocalServicesLead.
Thêm trường lead_feedback_submitted mới vào tài nguyên LocalServicesLead để xác nhận xem có cung cấp ý kiến phản hồi cho một tài nguyên cụ thể hay không.

Dịch vụ lập kế hoạch

Thêm tính năng hỗ trợ cho thông tin dự đoán hằng tháng về Tần suất mục tiêu trong ReachPlanService.GenerateReachForecast.
- Nhà phát triển có thể đặt TargetFrequencyTimeUnit.MONTHLY trong TargetFrequencySettings khi sử dụng mã sản phẩm có thể lập kế hoạch TARGET_FREQUENCY để tạo dự báo phạm vi tiếp cận hằng tháng theo Tần suất mục tiêu.
Thêm một phương thức mới ReachPlanService.GenerateConversionRates, cho phép nhà quảng cáo yêu cầu tỷ lệ chuyển đổi được đề xuất cho các sản phẩm có thể lập kế hoạch được hỗ trợ.
Thông tin dự đoán về chiến dịch Tạo nhu cầu trong ReachPlanService.GenerateReachForecast:
- Giờ đây, nhà phát triển có thể yêu cầu thông tin dự đoán về phạm vi tiếp cận cho chiến dịch Tạo nhu cầu. Nhà phát triển có thể sử dụng mã sản phẩm có thể lập kế hoạch DEMAND_GEN_MAX_CONVERSIONS mới để tạo thông tin dự báo về phạm vi tiếp cận của chiến dịch Tạo nhu cầu.
- Thêm trường conversion_rate mới cho phép nhà phát triển yêu cầu thông tin dự đoán về phạm vi tiếp cận của chiến dịch Tạo nhu cầu cung cấp tỷ lệ chuyển đổi. Bạn có thể truy xuất tỷ lệ chuyển đổi được đề xuất bằng cách sử dụng phương thức ReachPlanService.GenerateConversionRates mới. Đây là trường bắt buộc đối với các yêu cầu dự đoán về chiến dịch Tạo nhu cầu. Tính năng này không được hỗ trợ cho các sản phẩm có thể lập kế hoạch khác.
- Thêm trường conversions mới vào dự báo được trả về. Trường này chứa số lượt chuyển đổi tại một điểm nhất định trên đường cong phạm vi tiếp cận. Lượt chuyển đổi chỉ được hỗ trợ cho sản phẩm có thể lập kế hoạch DEMAND_GEN_MAX_CONVERSIONS.

Đề xuất

Trường ad_strength mới có sẵn cho ImprovePerformanceMaxAdStrengthRecommendation. Trường này trả về điểm độ mạnh hiện tại của quảng cáo trong nhóm thành phần được liên kết với đề xuất.

Mua sắm

Giờ đây, bạn có thể ghi đè tiêu chí loại trừ thương hiệu cho quảng cáo Mua sắm trong chiến dịch Tối đa hoá hiệu suất. Thông tin này được hiển thị thông qua trường pmax_campaign_settings mới ở cấp chiến dịch và chỉ hoạt động đối với chiến dịch Tối đa hoá hiệu suất cho ngành Bán lẻ. Hệ thống sẽ gửi một lỗi CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED mới nếu bạn cố gắng đặt trường này cho một loại chiến dịch không tương thích.

Video

Thêm tính năng hỗ trợ chỉ có thể đọc cho Quảng cáo âm thanh. Hãy xem Trung tâm trợ giúp của Google Ads để tìm hiểu về tính năng này. Thay đổi này cho thấy:
- Một AdvertisingChannelSubType mới có tên là YOUTUBE_AUDIO.
- Một AdGroupType mới có tên là YOUTUBE_AUDIO.
- Một enum định dạng quảng cáo mới có tên là YOUTUBE_AUDIO_AD và các trường YouTubeAudioAdInfo tương ứng.
Thêm các chỉ số và phân khúc mới vào chỉ số phạm vi tiếp cận của truy vấn bằng cách điều chỉnh bản minh hoạ. Trong quá trình thay đổi này,
- Ra mắt hai cột chỉ số mới có tên là coviewed_impressions và primary_impressions.
- Giới thiệu hai phân đoạn mới có tên là adjusted_age_range và adjusted_gender.
- Nếu bạn chọn một trong hai phân khúc mới cùng với trường chỉ số phạm vi tiếp cận (coviewed_impressions, primary_impressions, unique_users hoặc average_impression_frequency_per_user), thì bạn cũng phải chọn phân khúc còn lại để truy xuất số liệu thống kê hợp lệ cho các cột này.
- Tính năng này hiện chỉ dành cho những khách hàng có trong danh sách cho phép.

Phiên bản 19 (26/2/2025)

Các tính năng và thay đổi sau đây đã được thêm vào phiên bản 19.

Quản lý tài khoản

Thêm các giá trị sau vào CustomerError để tính đến các thay đổi sắp tới:
- CREATION_DENIED_FOR_POLICY_VIOLATION
- CREATION_DENIED_INELIGIBLE_MCC

Quảng cáo

Thêm DemandGenMultiAssetAdInfo.tall_portrait_marketing_images để hỗ trợ các thành phần hình ảnh dọc có tỷ lệ khung hình 9:16 trong quảng cáo Tạo nhu cầu.

Thành phần

(Chỉ dành cho tài khoản có trong danh sách cho phép) Thêm tính năng hỗ trợ cho thành phần thông báo thông qua Asset.business_message_asset, BusinessMessageAsset và các enum và lỗi sau.
- Enums:
- Lỗi:
  - AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
  - ResourceLimitType
Thêm AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW để hỗ trợ tự động tạo bản xem trước trang đích.
AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS hiện được chọn theo mặc định cho quảng cáo Tạo nhu cầu dạng video thích ứng.
(Chỉ dành cho tài khoản có trong danh sách cho phép; danh sách cho phép hiện đã đóng) Thêm Asset.app_deep_link_asset và AppDeepLinkAsset.

Lượt chuyển đổi

Mục tiêu lượt chuyển đổi
- LifecycleGoalValueSettings.high_lifetime_value đã kết thúc giai đoạn thử nghiệm và hiện có thể thay đổi.
- Thêm CustomerLifecycleGoal.owner_customer để hiển thị tên tài nguyên của khách hàng sở hữu mục tiêu vòng đời khách hàng.
Ngừng sử dụng ConversionActionType.SALESFORCE.

Nguồn cấp dữ liệu

Xoá tất cả các thực thể liên quan đến nguồn cấp dữ liệu, chẳng hạn như Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view, v.v. Giờ đây, người dùng nên sử dụng assets để đạt được cùng một mục đích. Truy cập vào Ghi chú di chuyển để xem danh sách tất cả các thực thể đã bị xoá.

Khách sạn và du lịch

Đặt min_days và max_days của ValueRuleItineraryAdvanceBookingWindow thành trường optional để cho phép chỉ định 0 làm giá trị. Điều này hỗ trợ tính năng nhắm mục tiêu cho các lượt tìm kiếm về du lịch diễn ra vào hôm nay.

Tối đa hoá hiệu suất

(Chỉ dành cho tài khoản có trong danh sách cho phép) Nguyên tắc sử dụng thương hiệu
- Chỉ cho phép thay đổi Campaign.brand_guidelines_enabled khi tạo chiến dịch Tối đa hoá hiệu suất.
- Chiến dịch này không tương thích với chiến dịch Tối đa hoá hiệu suất cho mục tiêu về du lịch.
- Để bật nguyên tắc sử dụng thương hiệu cho các chiến dịch Tối đa hoá hiệu suất hiện có, hãy sử dụng CampaignService.EnablePMaxBrandGuidelines mới thêm. Không hỗ trợ việc tắt nguyên tắc sử dụng thương hiệu.
- Thêm Campaign.brand_guidelines và BrandGuidelines để cho phép thiết lập màu sắc và bộ phông chữ của thương hiệu.
- Giá trị lỗi mới:
  - BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
  - BrandGuidelinesMigrationError
- CampaignError
  - BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
  - BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
  - BRAND_GUIDELINES_COLOR_INVALID_FORMAT
  - BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
  - BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
  - CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
  - CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
Thêm AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS để hỗ trợ tự động tạo thành phần video nâng cao cho chiến dịch Tối đa hoá hiệu suất.

Lập kế hoạch

(Chỉ dành cho tài khoản có trong danh sách cho phép) Thêm ContentCreatorInsightsService.GenerateTrendingInsights để cho phép người dùng xem các chủ đề nội dung thịnh hành trên YouTube theo định nghĩa đối tượng nhất định.
Thêm GenerateCreatorInsightsRequest.country_locations[] để chỉ định quốc gia cần tìm theo tiêu chí đã cho
Thêm GenerateCreatorInsightsRequest.search_brand để chỉ định một thương hiệu cần tìm nhà sáng tạo
Thêm các trường mới vào YouTubeChannelInsights để cung cấp thêm thông tin về kênh cho các yêu cầu search_channels:
- channel_url
- channel_description
- top_videos
Thêm các trường siêu dữ liệu mới vào AudienceInsightsAttributeMetadata:
- youtube_video_metadata
- user_interest_attribute_metadata
- knowledge_graph_attribute_metadata

Video

Sau khi phát hành DataLinkService.CreateDataLink, chúng tôi đã thêm các phương thức sau để cho phép thay đổi các đường liên kết dữ liệu đã tạo trước đó:
- RemoveDataLink để xoá đường liên kết dữ liệu trong tài khoản Google Ads
- UpdateDataLink để chấp nhận, từ chối và thu hồi các đường liên kết dữ liệu trong tài khoản Google Ads
Xoá tính năng hỗ trợ VIDEO_OUTSTREAM khỏi các enum sau:

Phiên bản 18 (16/10/2024)

Các tính năng và nội dung cập nhật mới sau đây đã được thêm vào phiên bản 18.

Quản lý tài khoản

(Chỉ dành cho tài khoản có trong danh sách cho phép) Thêm DataLinkService.CreateDataLink để cho phép liên kết tài khoản Google Ads với video của nhà sáng tạo được lưu trữ trên kênh YouTube của nhà sáng tạo đó. Tính năng liên kết video cho phép tài khoản Google Ads chạy quảng cáo liên kết bằng video của nhà sáng tạo.

Nhóm quảng cáo

Thêm AdGroup.exclude_demographic_expansion để cho phép bạn loại trừ thông tin nhân khẩu học khỏi việc mở rộng khi optimized_targeting_enabled là true. Đây là tính năng trước đây chỉ được hỗ trợ cho chiến dịch Tạo nhu cầu.

Quảng cáo

Thêm AdGroupAd.ad_group_ad_asset_automation_settings để cho phép chọn quảng cáo tham gia hoặc không tham gia tính năng tạo thành phần tự động.
Thêm các giá trị sau vào AssetAutomationType:
- GENERATE_VERTICAL_YOUTUBE_VIDEOS
- GENERATE_SHORTER_YOUTUBE_VIDEOS
Thêm AdNetworkType.GOOGLE_OWNED_CHANNELS. Thành phần này được dùng cho quảng cáo phân phát trên các kênh thuộc sở hữu của Google như YouTube, Gmail và trang Khám phá.

Thành phần

Đổi tên AssetType.DISCOVERY_CAROUSEL_CARD thành AssetType.DEMAND_GEN_CAROUSEL_CARD.

Chiến dịch

Thêm metrics.store_visits_last_click_model_attributed_conversions. Hàm này trả về số lượt ghé thăm cửa hàng thực tế được phân bổ theo mô hình lượt nhấp cuối cùng của một chiến dịch.
Thêm các chỉ số sau đây liên quan đến lượt xem video cho một chiến dịch:
Thêm metrics.results_conversions_purchase. Hàm này trả về lượt chuyển đổi mua hàng cho kết quả mục tiêu hợp nhất của một chiến dịch.
Thay đổi giá trị mặc định của DemandGenCampaignSettings.upgraded_targeting từ false thành true.

Tiêu chí

Thêm content_criterion_view. Phương thức này trả về các chỉ số hiệu suất của nội dung được nhắm mục tiêu, chẳng hạn như từ khoá, vị trí và chủ đề, cho chiến dịch Hiển thị, chiến dịch Tạo nhu cầu và chiến dịch Video.

Khách sạn và du lịch

Hỗ trợ Nguồn cấp dữ liệu du lịch trong quảng cáo Tìm kiếm
- Thêm ClickType.TRAVEL_ASSETS để cho phép phân đoạn các chỉ số của Nguồn cấp dữ liệu du lịch trong quảng cáo Tìm kiếm.
- Thêm AssetSetType.TRAVEL_FEED để chọn sử dụng và chọn không sử dụng Nguồn cấp dữ liệu du lịch trong quảng cáo Tìm kiếm.
(Chỉ dành cho những tài khoản có trong danh sách cho phép) Thêm hành trình du lịch làm một quy tắc về giá trị lượt chuyển đổi mới với các trường và giá trị mới sau:
- ConversionValueRule.itinerary_condition với ValueRuleItineraryCondition cho phép chỉ định thời hạn đặt trước, thời lượng hành trình và ngày bắt đầu chuyến đi trong tuần
- ConversionValueRulePrimaryDimensionEnum.ITINERARY
- ValueRuleSetDimension.ITINERARY
Thêm các phân khúc sau đây cho báo cáo campaign và ad_group để cho phép phân đoạn dữ liệu hiệu suất dựa trên các điểm đến cụ thể (thành phố, quốc gia và khu vực) cho chiến dịch Khách sạn và chiến dịch Tìm kiếm:

Dịch vụ địa phương

PhoneCallDetails.call_recording_url sẽ trống thay vì cung cấp URL không hợp lệ nếu không có bản ghi cuộc gọi cho cuộc trò chuyện với khách hàng tiềm năng về Dịch vụ địa phương nhất định.
Thêm CategoryBid.target_cpa_bid_micro để cho phép đặt CPA mục tiêu cho một danh mục thông qua Campaign.local_services_campaign_settings.

Tối đa hoá hiệu suất

Hỗ trợ về nguyên tắc sử dụng thương hiệu
- Thêm Campaign.brand_guidelines_enabled để cho biết liệu nguyên tắc trình bày thương hiệu có được bật cho một chiến dịch Tối đa hoá hiệu suất cụ thể hay không. Nếu được bật, các thành phần có field_type được đặt thành BUSINESS_NAME, LOGO, LANDSCAPE_LOGO phải được liên kết dưới dạng tài nguyên CampaignAsset thay vì tài nguyên AssetGroupAsset.
- Thêm lỗi CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED và CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, cho biết rằng những chiến dịch Tối đa hoá hiệu suất đã bật nguyên tắc thương hiệu không có tài nguyên CampaignAsset bắt buộc được liên kết với chiến dịch.
- Khi bạn bật nguyên tắc thương hiệu, ít nhất một thành phần có field_type được đặt thành BUSINESS_NAME và ít nhất một thành phần có LOGO phải được liên kết với chiến dịch dưới dạng tài nguyên CampaignAsset. Chiến dịch Tối đa hoá hiệu suất để thúc đẩy lượt bán hàng trên mạng bằng nguồn cấp dữ liệu sản phẩm chỉ phải đáp ứng yêu cầu này khi có các thành phần được liên kết với nhóm thành phần của chiến dịch.
- Thêm các giá trị sau vào AssetLinkError:
  - BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, được gửi khi cố gắng liên kết các thành phần thương hiệu với chiến dịch dưới dạng tài nguyên CampaignAsset thay vì tài nguyên AssetGroupAsset trong chiến dịch Tối đa hoá hiệu suất có nguyên tắc về thương hiệu không được bật.
  - Lỗi BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL được gửi khi cố gắng liên kết thành phần thương hiệu với chiến dịch dưới dạng tài nguyên AssetGroupAsset thay vì tài nguyên CampaignAsset trong chiến dịch Tối đa hoá hiệu suất đã bật nguyên tắc trình bày thương hiệu.
Thêm performance_max_placement_view. Phương thức này trả về số lượt hiển thị của những vị trí mà quảng cáo Tối đa hoá hiệu suất đã phân phát.
Thêm AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

Lập kế hoạch

(Chỉ dành cho tài khoản có trong danh sách cho phép) Thêm một dịch vụ mới bằng phương thức ContentCreatorInsightsService.GenerateCreatorInsights, cho phép người dùng khám phá thông tin chi tiết về các nhà sáng tạo hàng đầu trên YouTube. Nhờ đó, khách hàng có thể tìm kiếm nhà sáng tạo dựa trên tổ hợp tiêu chí nhắm mục tiêu theo đối tượng và tiêu chí nhắm mục tiêu theo nội dung hoặc thông tin chi tiết về nhà sáng tạo dựa trên danh sách mã nhận dạng kênh YouTube.
Nội dung cập nhật đối với AudienceInsightsService.GenerateSuggestedTargetingInsights:
- Di chuyển audience, baseline_audience và data_month vào audience_definition.
- Thêm audience_description để tạo đề xuất nhắm mục tiêu từ nội dung mô tả dạng văn bản tự do bằng AI tạo sinh.
Thêm AudienceInsightsService.GenerateTargetingSuggestionMetrics. Phương thức này trả về các chỉ số về phạm vi tiếp cận tiềm năng cho các tổ hợp tiêu chí nhắm mục tiêu theo đối tượng nhất định.

Đề xuất

Giờ đây, bạn có thể sử dụng RecommendationService.GenerateRecommendations để tạo đề xuất về ngân sách được tối ưu hoá trong quá trình tạo chiến dịch, bằng cách thêm loại đề xuất CAMPAIGN_BUDGET vào GenerateRecommendationsRequest.recommendation_types[]. Cách này áp dụng cho chiến dịch Tối đa hoá hiệu suất và chiến dịch Tìm kiếm.

Báo cáo

Thay thế các trường summary_row_setting và return_total_results_count của SearchGoogleAdsRequest bằng trường search_settings có loại là SearchSettings với các trường sau:
- omit_results
- return_summary_row
- return_total_results_count
Thêm các chỉ số mới sau đây về lượt nhấp không hợp lệ chung, chẳng hạn như lượt nhấp do bot hoặc trình thu thập thông tin tạo ra, những lượt nhấp có mẫu bất thường. Bạn có thể truy vấn các giá trị này bằng báo cáo campaign.
- metrics.general_invalid_clicks
- metrics.general_invalid_click_rate
Thêm các giá trị sau vào QuotaError:
- EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

Phiên bản 17.1.0 (07/08/2024)

Các tính năng và bản cập nhật mới sau đây đã được thêm vào phiên bản v17_1.

Thành phần

AdGroupAdService.RemoveAutomaticallyCreatedAssets() cho phép bạn xoá thành phần được tạo tự động đã chỉ định được liên kết với Quảng cáo tìm kiếm thích ứng.

Đối tượng

Các giá trị enum mới trong 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

Chiến dịch

ShareablePreviewService.GenerateShareablePreviews() tạo các URL shareable_preview_url trong phản hồi cho bản xem trước quảng cáo có thể chia sẻ cho các nhóm thành phần đã bật và tạm dừng.
- Trường expiration_date_time cho biết ngày hết hạn của các URL trong phản hồi.
- Nếu xảy ra lỗi, phương thức này sẽ trả về partial_failure_error thay vì URL.

Lịch sử thay đổi

Loại tài nguyên trạng thái thay đổi mới: ASSET_GROUP.

Lượt chuyển đổi

Trường phân khúc mới cho phiên bản SKAdNetwork: segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary, cho thấy thông tin chẩn đoán về lượt tải lượt chuyển đổi lên ở cấp hành động chuyển đổi.
Các chỉ số sau đây được thêm vào báo cáo chẩn đoán ngoại tuyến để cho biết số lượt chuyển đổi đã tải lên nhưng vẫn đang được xử lý:
- offline_conversion_upload_client_summary
  - pending_event_count
  - pending_rate
- offline_conversion_upload_conversion_action_summary:
  - pending_count

Lập kế hoạch

AudienceInsights.GenerateAudienceOverlapInsights(), chấp nhận một thuộc tính chính đầu vào và một tập hợp các thuộc tính đối tượng, đồng thời trả về số liệu ước tính về mức độ trùng lặp của phạm vi tiếp cận tiềm năng trên YouTube giữa thuộc tính chính và các thuộc tính đối tượng.

Báo cáo

Hỗ trợ phân đoạn per_store_view dựa trên segments.date

Video

Hỗ trợ truy xuất thông tin liên quan đến các chiến lược đặt giá thầu chuẩn sau đây cho chiến dịch video bằng các báo cáo, chẳng hạn như ad_group, campaign:
- Campaign.fixed_cpm (CPM cố định (chi phí mỗi nghìn lượt hiển thị))
- Campaign.target_cpv (CPV mục tiêu (chi phí mỗi lượt xem))
Campaign.video_campaign_settings cho phép bạn xác định khoảng không quảng cáo mà quảng cáo dạng video có thể hiển thị, bằng cách sử dụng các trường báo cáo sau:
segments.ad_format_type cho phép bạn phân đoạn các báo cáo sau đây dựa trên loại định dạng quảng cáo dạng video:

Phiên bản 17 (05/06/2024)

Các tính năng và thay đổi sau đây đã được thêm vào phiên bản 17.

Quảng cáo

Đã xoá AdService.getAd. Điều này giúp AdService phù hợp với các dịch vụ khác trong API Google Ads. Hãy xem phần Truy xuất đối tượng để biết cách đề xuất tìm nạp quảng cáo và các loại tài nguyên khác.
Thêm các quy trình xác thực khác cho ImageAdInfo.image_asset liên quan đến kích thước và định dạng. Các lỗi sau đây có thể xảy ra nếu hình ảnh không hợp lệ:
- ImageError.UNEXPECTED_SIZE
- ImageError.FORMAT_NOT_ALLOWED

Thành phần

Thêm enum mới: ClickType.AD_IMAGE
Bổ sung các báo cáo mới sau đây với các chỉ số mới cho chiến dịch Tối đa hoá hiệu suất và chiến dịch Tìm kiếm:
- campaign_aggregate_asset_view
- channel_aggregate_asset_view

Đối tượng

Thêm OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

Công việc theo lô

Thêm BatchJobError.REQUEST_TOO_LARGE. Lỗi này sẽ được gửi khi AddBatchJobOperationsRequest đã gửi lớn hơn 10484504 byte.
Thêm tính năng hỗ trợ để đặt MutateOperation.asset_group_operation khi sử dụng BatchJobService. Nhờ đó, bạn có thể sử dụng tính năng xử lý hàng loạt để tạo và quản lý toàn bộ chiến dịch Tối đa hoá hiệu suất. Hãy xem hướng dẫn chuyên biệt mới của chúng tôi.

Chiến dịch

Đổi tên chiến dịch Khám phá thành chiến dịch Tạo nhu cầu trong tất cả các trường, enum, lỗi của tất cả tài nguyên trên API Google Ads, chẳng hạn như chiến dịch, quảng cáo và thành phần. Ví dụ: AdvertisingChannelType.DISCOVERY hiện là AdvertisingChannelType.DEMAND_GEN.
Thêm Campaign.keyword_match_type để cho phép bạn đặt kiểu khớp từ khoá cho tất cả từ khoá trong một chiến dịch.

Lượt chuyển đổi

Đối với lượt chuyển đổi SKAdNetwork,
- Đổi tên segments.sk_ad_network_conversion_value thành segments.sk_ad_network_fine_conversion_value.
- Thêm segments.sk_ad_network_redistributed_fine_conversion_value.
Các chỉ số sau đây hiện được trả về cùng với phản hồi ngay cả khi các chỉ số đó bằng 0. Điều này giúp các chỉ số này nhất quán với các chỉ số khác.

Tiêu chí

Thêm vào các trường sau đây trong AdGroupCriterion để cho biết tiêu chí của nhóm quảng cáo có đang phân phát hay không hoặc lý do tiêu chí đó không phân phát:
- primary_status
- primary_status_reasons
Thêm tính năng hỗ trợ cho metrics.search_impression_share cho gender_view
Thêm tính năng hỗ trợ cho metrics.phone_calls cho keyword_view

Dịch vụ địa phương

Thêm LocalServicesLeadService.AppendLeadConversation() dùng để thêm LocalServicesLeadConversation mới vào LocalServicesLead. Thao tác này sẽ gửi thông báo đến người dùng thông qua các kênh thích hợp như SMS, tuỳ thuộc vào cách tạo khách hàng tiềm năng.
- Kích thước của AppendLeadConversationRequest.conversations bị giới hạn ở mức 1.000.
- Bạn chỉ có thể chỉ định LocalServicesLead với lead_type được đặt thành LeadType.MESSAGE trong Conversation.local_services_lead.
Thêm các giá trị enum mới vào ConversationType:
- WHATSAPP để biểu thị một cuộc trò chuyện được giới thiệu thông qua WhatsApp.
- ADS_API để biểu thị một cuộc trò chuyện được giới thiệu bằng phương thức LocalServicesLeadService.AppendLeadConversation() mới.
Thêm các trường mới sau đây vào local_services_verification_artifact:
- local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
- local_services_verification_artifact.license_verification_artifact.expiration_date_time

Báo cáo

Giờ đây, bạn chỉ có thể chọn các trường liên quan đến một sản phẩm được liên kết khi truy vấn product_link. Việc chọn nhiều trường của một số sản phẩm được liên kết sẽ gửi QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Ví dụ: bạn không thể chọn product_link.advertising_partner.customer và product_link.data_partner.data_partner_id trong cùng một truy vấn.
Việc truyền page_size đến GoogleAdsService.Search sẽ dẫn đến lỗi RequestError.PAGE_SIZE_NOT_SUPPORTED.

Mua sắm

Thêm một báo cáo mới shopping_product tương ứng với trang Sản phẩm trong giao diện người dùng Google Ads. Phương thức này hỗ trợ trả về dữ liệu liên quan đến trạng thái hiện tại của sản phẩm từ các tài khoản Google Merchant Center được liên kết với một tài khoản Google Ads.
- Bạn có thể lọc các chỉ số trong báo cáo shopping_product bằng cách sử dụng segments.date khi sử dụng GoogleAdsService.Search hoặc GoogleAdsService.SearchStream. Không được phép phân đoạn theo ngày và sẽ trả về lỗi ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

Mục tiêu hợp nhất

Thêm UserListCustomerTypeService.MutateUserListCustomerTypes() để định cấu hình các loại khách hàng đối tượng.
Đã xoá CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. Để định cấu hình chế độ cài đặt đối tượng của mục tiêu trong vòng đời của khách hàng, hãy sử dụng UserListCustomerTypeService.MutateUserListCustomerTypes().
- Đính kèm hoặc huỷ đính kèm danh sách người dùng bằng cách đặt UserListCustomerType.customer_type_category thành UserListCustomerTypeCategory.PURCHASERS để lần lượt đưa danh sách đó vào hoặc loại trừ danh sách đó khỏi định nghĩa khách hàng hiện có cho mục tiêu vòng đời của khách hàng. Hãy truy cập bài viết phân khúc đối tượng để biết thêm thông tin chi tiết.

Video

Thêm các giá trị sau vào ContentLabelType. Bạn có thể loại trừ các ContentLabelTypes này ở cấp khách hàng:
- 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
Thêm AdVideoAsset.ad_video_asset_info để hỗ trợ lựa chọn ưu tiên về khoảng không quảng cáo cho thành phần video khi tạo DemandGenVideoResponsiveAdInfo.
(Chỉ áp dụng cho tài khoản có trong danh sách cho phép) Đặt Campaign.video_brand_safety_suitability thành có thể thay đổi.

Ghi chú phát hành đã lưu trữ

Hãy xem phần Phiên bản ngừng hoạt động để biết ghi chú phát hành đã lưu trữ.