Thông báo về phiên bản 24 của API Google Ads

Thứ Tư, ngày 22 tháng 4 năm 2026

Hôm nay, chúng tôi xin thông báo về việc phát hành phiên bản 24 của Google Ads API. Để sử dụng các tính năng mới của phiên bản 24, bạn phải nâng cấp thư viện ứng dụng và mã ứng dụng. Tất cả thư viện ứng dụng và mã ví dụ mới nhất đều đã được xuất bản.

Hãy tham gia cùng chúng tôi để xem hướng dẫn trực tiếp về bản phát hành này trong sự kiện "Điểm nổi bật của bản phát hành Google Ads API" trên Discord, sự kiện YouTube Live dành cho nhà phát triển Google Ads hoặc sự kiện LinkedIn Live vào ngày mai (ngày 23 tháng 4 lúc 10:00 theo giờ miền Đông). Sự kiện này cũng sẽ được ghi lại và đăng lên YouTube cho những người không thể tham gia trực tiếp. Nếu bạn có câu hỏi hoặc muốn thảo luận về bài đăng này, hãy liên hệ với chúng tôi qua kênh #ads-api trên Discord.

Tính năng mới

Hỗ trợ cho tính năng Lượt chuyển đổi có dữ liệu giỏ hàng: Lượt chuyển đổi có dữ liệu giỏ hàng là một tiện ích cho tính năng theo dõi lượt chuyển đổi trên trang web hoặc ứng dụng của bạn. Khi sử dụng tính năng lượt chuyển đổi có dữ liệu giỏ hàng, bạn có thể cung cấp thông tin chi tiết về những sản phẩm đã bán được trong mỗi giao dịch. Nhờ đó, bạn có thể xem báo cáo và thông tin chi tiết nâng cao về doanh số bán hàng, lợi nhuận cho tài khoản Google Ads cũng như chiến dịch của mình, chẳng hạn như số đơn đặt hàng, số sản phẩm trung bình mỗi đơn hàng, doanh thu và lợi nhuận gộp.

Google Ads API phiên bản 24 bổ sung tính năng hỗ trợ cho tính năng này như sau:

  • Thêm tài nguyên mới CartDataSalesView cho phép phân đoạn chỉ số lượt chuyển đổi không chỉ theo lượt nhấp vào sản phẩm mà còn theo sản phẩm được bán, với các phân đoạn như product_sold_brand. Nhờ đó, nhà quảng cáo có thể xem số liệu thống kê về những sản phẩm mà khách hàng thực sự đã mua sau khi nhấp vào quảng cáo, ngay cả khi quảng cáo đó là về một sản phẩm khác.
  • Thêm một số chỉ số không thể đặt giá thầu "tất cả", là những chỉ số cũng bao gồm các lượt chuyển đổi mà chiến dịch của bạn không chủ động tối ưu hoá, ví dụ: all_cost_of_goods_sold_micros. Các chỉ số mới được thêm vào tất cả tài nguyên hỗ trợ các chỉ số có thể đặt giá thầu tương ứng.
  • Thêm phân đoạn conversion_attribution_event_type vào tài nguyên ShoppingPerformanceView, giúp bạn có thể chọn phân đoạn này cùng với dữ liệu giỏ hàng và các chỉ số lượt chuyển đổi khác. Phân khúc này cho biết lượt chuyển đổi được phân bổ cho một lượt nhấp hay một lượt xem, đồng thời giúp bạn nhận biết số liệu thống kê về dữ liệu giỏ hàng do lượt chuyển đổi từ lượt xem hết tạo ra.

Tính năng mới cập nhật

Phiên bản v24 giới thiệu các bản cập nhật cho các tính năng hiện có, yêu cầu thay đổi mã khi nâng cấp. Chúng tôi đề cập đến những thay đổi quan trọng nhất tại đây; hãy xem ghi chú phát hành để biết danh sách đầy đủ các thay đổi.

Chế độ cài đặt loại trừ nội dung video trong chiến dịch: Chúng tôi đã đơn giản hoá khả năng đặt chế độ cài đặt loại trừ nội dung video cho từng chiến dịch. Chế độ cài đặt này có ở cấp khách hàng và áp dụng cho tất cả chiến dịch. Các chế độ cài đặt loại trừ nội dung này giúp bạn có thêm quyền kiểm soát và loại trừ những loại nội dung có thể không phù hợp với thương hiệu hoặc doanh nghiệp của bạn, mặc dù chúng vẫn tuân thủ chính sách của Google. Hãy xem https://support.google.com/google-ads/answer/7515513 để tìm hiểu thêm về chế độ cài đặt loại trừ nội dung video.

Thay đổi đối với AudienceInsightsService: Trong quá trình tái cấu trúc mã, chúng tôi đã chuyển trường yêu cầu InsightsAudience.topic_audience_combinations vào không gian tên common. Bạn có thể cần cập nhật các lệnh nhập trong một số ngôn ngữ lập trình.

Thay đổi đối với ReachPlanService: Trong quá trình tái cấu trúc mã, chúng tôi đã chuyển trường youtube_select_lineups khỏi dịch vụ ReachPlanService.ListPlannableProducts. Nhóm nội dung hiện có trong trường youtube_select_lineup_targeting. Nhóm kênh YouTube Select là sản phẩm đặt trước dành cho những khách hàng đủ điều kiện nhắm đến các kênh thuộc top 1% kênh phổ biến nhất trên YouTube, có lượng đối tượng đặc biệt quan tâm trong một thị trường nhất định. Tìm hiểu thêm.

Thay đổi đối với ContentCreatorInsightsService: Trong quá trình tái cấu trúc mã, chúng tôi đã xoá trường is_brand_connect_creator khỏi dịch vụ ContentCreatorInsightsService.GenerateCreatorInsights và ContentCreatorInsightsService.GenerateTrendingInsights.
Thay vào đó, người dùng nên tìm một nhà sáng tạo có lựa chọn CREATOR_PARTNERSHIPS trong partnership_opportunities. Hợp tác với nhà sáng tạo trên YouTube trong Google Ads là nơi bạn có thể tìm thấy nhà sáng tạo trên YouTube để hợp tác sản xuất nội dung được tài trợ, đồng thời giúp bạn quản lý hiệu quả các mối quan hệ đối tác với nhà sáng tạo. Tìm hiểu thêm.

Thay đổi đối với KeywordPlanIdeaService: Để mang đến trải nghiệm hợp lý và đáng tin cậy hơn, chúng tôi đã hợp nhất cơ sở hạ tầng dự báo. Google Ads API phiên bản 24 ra mắt một phương thức GenerateKeywordForecastMetrics mới giúp đơn giản hoá quy trình lập kế hoạch bằng cách tập trung vào những chỉ số có tác động trực tiếp nhất đến hiệu suất của bạn. Chúng tôi sẽ chia sẻ một bài đăng chi tiết hơn trên blog về thay đổi này trong những ngày tới.

Thay đổi đối với tài nguyên campaign_budget: Chúng tôi đã xoá phân đoạn ad_sub_network_type cho tài nguyên campaign_budget vì phân đoạn này không tương thích với chế độ xem này.

Thay đổi đối với chế độ xem thành phần: Chúng tôi đã xoá phân đoạn click_type khỏi các chế độ xem ad_group_asset, campaign_asset và customer_asset. Thay đổi này phù hợp với một thay đổi gần đây về sản phẩm, theo đó phân khúc này đã bị xoá khỏi Google Ads để tránh trình bày sai dữ liệu. Bạn có thể sử dụng tính năng phân đoạn click_type từ tài nguyên ad_group_ad để xem thông tin chi tiết về hiệu suất quảng cáo và thành phần được phân phát cùng với quảng cáo đó.

Các thay đổi đối với quảng cáo thích ứng dạng video: VideoResponsiveAdInfo hiện có thể tắt tiếng. Trong lần thay đổi này, chúng tôi đã đánh dấu videos, business_name và logo_images là các trường bắt buộc trong cả đối tượng DemandGenVideoResponsiveAdInfo và VideoResponsiveAdInfo.

Thay đổi đối với ShareablePreviewService: Cập nhật ShareablePreviewService.GenerateShareablePreviews để không còn sử dụng lỗi một phần nữa. Yêu cầu sẽ gửi thông báo lỗi nếu không thành công đối với bất kỳ mã nhận dạng nào. Tìm hiểu thêm.

Các tài nguyên sau đây có thể giúp bạn bắt đầu:

Đối với các vấn đề hỗ trợ kỹ thuật, hãy liên hệ theo địa chỉ https://support.google.com/google-ads/contact/google_ads_api

Chân dung tác giả – , Nhóm phụ trách Google Ads API

Nhãn: google-ads-api, release