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 20 (04/06/2025)

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 20.

Thành phần

Thêm một số chỉ số và cột phân đoạn mới cho báo cáo asset_group.

Cột chỉ số

Cột phân đoạn

Chiến dịch

Hỗ trợ thêm tính năng thêm và cập nhật từ khoá phủ định ở cấp chiến dịch cho chiến dịch Tối đa hoá hiệu suất.

Lượt chuyển đổi

Giờ đây, bạn có thể cập nhật trường google_ads_conversion_customer trên một khách hàng hiện tại để chọn sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản hoặc thay đổi tài khoản mẹ theo dõi lượt chuyển đổi hiện tại thành một tài khoản người quản lý khác.
Thêm trường ClickConversion.user_ip_address. Google Ads không hỗ trợ tính năng so khớp địa chỉ IP cho người dùng cuối ở Khu vực kinh tế Châu Âu (EEA), Vương quốc Anh (UK) hoặc Thuỵ Sĩ (CH). Vui lòng thêm logic để loại trừ có điều kiện việc chia sẻ địa chỉ IP của người dùng ở những khu vực này. Hãy nhớ cung cấp cho người dùng thông tin rõ ràng và đầy đủ về dữ liệu mà bạn thu thập trên các trang web, ứng dụng và tài sản khác của mình, đồng thời nhận được sự đồng ý của người dùng khi pháp luật hoặc bất kỳ chính sách nào hiện hành của Google yêu cầu. Hãy xem trang Giới thiệu về tính năng nhập lượt chuyển đổi ngoại tuyến để biết thêm thông tin chi tiết.

Tạo nhu cầu

Thêm các giá trị mới vào phân khúc ad_network_type cho phép phân đoạn chiến dịch Tạo nhu cầu theo kênh:
- MAPS
- GMAIL
- DISCOVER
Thêm các chỉ số cho lượt chuyển đổi có thể so sánh trên nhiều nền tảng:

Đề xuất

Thêm trường merchant_center_account_id vào GenerateRecommendationsRequest để cho biết thời điểm tạo đề xuất cho hoạt động bán lẻ, thay vì chiến dịch Tối đa hoá hiệu suất thông thường.

Lập kế hoạch

Thêm AudienceInsightsDimension.YOUTUBE_LINEUP để thay thế AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP trong AudienceInsightsService và ContentCreatorInsightsService. Phương diện mới này cho phép bạn truy xuất thông tin chi tiết và siêu dữ liệu cho Nhóm YouTube Chọn lọc (YTS). Thay thế các đối tượng liên kết với YOUTUBE_DYNAMIC_LINEUP như DynamicLineupAttributeMetadata và AudienceInsightsDynamicLineup để phù hợp với việc xoá rộng hơn các Nhóm quảng cáo động trên Google Ads. Tính năng này chỉ dành cho các tài khoản có trong danh sách cho phép.
Thêm AdditionalApplicationInfo và ApplicationInstance vào AudienceInsightsService, ContentCreatorInsightsService, và ReachPlanService. Tính năng này chỉ dành cho các tài khoản có trong danh sách cho phép.
Cập nhật AudienceInsightsService và ContentCreatorInsightsService để cung cấp thông tin chi tiết hơn. Giờ đây, bạn có thể phân đoạn dữ liệu về nhà sáng tạo nội dung theo thiết bị bằng cách sử dụng AudienceInsightsDimension.DEVICE và AudienceInsightsAttribute.device mới trong cả hai dịch vụ. Tính năng này chỉ dành cho các tài khoản có trong danh sách cho phép.
Thêm các chỉ số video tổng hợp khác vào GenerateCreatorInsightsResponse để nhà sáng tạo nội dung có thể phân tích một cách toàn diện hơn: engagement_rate, average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video, shorts_views_count, shorts_video_count và is_brand_connect_creator. Tính năng này chỉ dành cho các tài khoản có trong danh sách cho phép.
Thêm sub_country_locations vào GenerateCreatorInsightsRequest cho ContentCreatorInsightsService. Điều này cho phép chỉ định vị trí địa lý theo tiểu bang để tinh chỉnh nội dung tìm kiếm về thông tin chi tiết về nhà sáng tạo. Trường sub_country_locations chỉ được hỗ trợ khi sử dụng search_attributes oneof trong trường criteria. Nếu sub_country_locations được cung cấp cùng với các loại tiêu chí khác, thì yêu cầu sẽ không hợp lệ. Điều này cho phép tính năng nhắm mục tiêu theo vị trí địa lý và phân tích chi tiết hơn về thông tin chi tiết dành cho nhà sáng tạo nội dung. Tính năng này chỉ dành cho các tài khoản có trong danh sách cho phép.
Thêm ReachPlanService.ListPlannableUserLists, trả về danh sách người dùng bên thứ nhất do khách hàng sở hữu và thêm UserListInfo vào các lựa chọn nhắm mục tiêu theo đối tượng trong GenerateReachForecastRequest. Điều này cho phép bạn truy xuất danh sách người dùng có thể lập kế hoạch cho một khách hàng nhất định, sau đó tạo thông tin dự báo về phạm vi tiếp cận cho những chiến dịch nhắm đến những đối tượng cụ thể đó. Những điểm cải tiến này giúp cải thiện tính năng lập kế hoạch phạm vi tiếp cận phù hợp bằng cách trực tiếp kết hợp dữ liệu đối tượng của bên thứ nhất vào thông tin dự đoán. Tính năng dự đoán phạm vi tiếp cận chỉ dành cho các tài khoản có trong danh sách cho phép.

Video

Thêm quảng cáo AdFormatType.PAUSE được phân phát trên các video không phải trả tiền trên YouTube trên màn hình TV. Loại quảng cáo này được đưa vào báo cáo. Những quảng cáo này hiển thị ngay bên cạnh khung video tĩnh trên màn hình tạm dừng. Chỉ số này không bao gồm quảng cáo Tạo nhu cầu dạng video hiển thị trên bảng quảng cáo bên dưới hoặc phía trên một video tự nhiên đang tạm dừng. Những quảng cáo này được báo cáo trong mục AdFormatType.INFEED.

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 hiển thị:
- 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 cụm 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 sử dụng hoặc không sử dụng tính năng tạo thành phần tự động cho quảng cáo.
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 sử 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 bản ghi cuộc gọi không tồn tạ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ã 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