Những thay đổi để hỗ trợ Quy định của Liên minh Châu Âu về quảng cáo chính trị trong Google Ads API và tập lệnh Google Ads

Thứ Năm, ngày 7 tháng 8 năm 2025

Điều gì sẽ thay đổi?

Như đã thông báo vào năm ngoái, Google sẽ ngừng phân phát quảng cáo chính trị ở Liên minh Châu Âu trước khi một quy định mới có hiệu lực vào tháng 10 năm 2025. Từ ngày 3 tháng 9 năm 2025, Google Ads API và tập lệnh Google Ads sẽ triển khai các biện pháp thực thi liên quan đến thay đổi này. Nếu sử dụng một trong hai sản phẩm này để tạo hoặc quản lý chiến dịch, bạn có thể cần cập nhật ứng dụng của mình để xử lý các biện pháp thực thi này trước ngày 3 tháng 9 năm 2025.

Hỗ trợ API cho việc tự khai báo quảng cáo chính trị ở Liên minh Châu Âu

Google Ads API và tập lệnh Google Ads đã bổ sung tính năng hỗ trợ tự khai báo xem chiến dịch có quảng cáo chính trị ở Liên minh Châu Âu hay không. Tìm hiểu cách xác định quảng cáo chính trị ở Liên minh Châu Âu tại đây. Các phiên bản v19.2, v20.1 và v21 của API chứa một trường mới có tên là contains_eu_political_advertising trong đối tượng Campaign. Các giá trị có thể có và ý nghĩa của các giá trị đó được trình bày trong bảng dưới đây.

Giá trị	Ý nghĩa
CONTAINS_EU_POLITICAL_ADVERTISING	Chiến dịch này có quảng cáo chính trị ở Liên minh Châu Âu.
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING	Chiến dịch này không có quảng cáo chính trị ở Liên minh Châu Âu.
UNSPECIFIED	Chiến dịch này thiếu thông tin tự khai báo về quảng cáo chính trị ở Liên minh Châu Âu.

Bạn có thể truy xuất trạng thái tự khai báo của một chiến dịch trong Google Ads API bằng cách chạy truy vấn sau đây thông qua phương thức Search hoặc SearchStream của GoogleAdsService. Đối với Tập lệnh Google Ads, hãy sử dụng phương thức AdsApp.search hoặc AdsApp.report.

select campaign.id, campaign.contains_eu_political_advertising from campaign

Nếu sử dụng thư viện ứng dụng Google Ads API, bạn có thể cần tải phiên bản thư viện mới nhất xuống để sử dụng chức năng này trong phiên bản 19 và 20 của API.

Thay đổi về việc xác thực và thực thi API

Kể từ ngày 3 tháng 9 năm 2025, Google Ads API và tập lệnh Google Ads sẽ bắt đầu thực thi các quy trình kiểm tra sau đây trong phiên bản v19 và v20 của API.

• Tất cả chiến dịch mới được tạo thông qua Google Ads API hoặc tập lệnh Google Ads đều phải đặt trường contains_eu_political_advertising. Lệnh gọi API để tạo chiến dịch mới bằng CampaignService.MutateCampaigns sẽ không thành công và trả về lỗi FieldError.REQUIRED nếu bạn không đặt trường này. Tập lệnh Google Ads sẽ thực thi các quy trình kiểm tra này khi tạo chiến dịch bằng phương thức AdsApp.mutate hoặc AdsApp.mutateAll.
• Tất cả chiến dịch hiện có phải đặt trường contains_eu_political_advertising trước khi cố gắng thay đổi proximity, location, hoặc location_group tiêu chí nhắm mục tiêu ở cấp chiến dịch hoặc cấp nhóm quảng cáo. Lệnh gọi API để tạo hoặc cập nhật các tiêu chí này của chiến dịch bằng phương thức CampaignCriterionService.MutateCampaignCriteria cho các chiến dịch hiện có sẽ không thành công và trả về lỗi CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION nếu chiến dịch chưa hoàn tất quy trình tự khai báo. Lệnh gọi API để tạo hoặc cập nhật các tiêu chí nhóm quảng cáo này bằng AdGroupCriterionService.MutateAdGroupCriteria cũng sẽ không thành công theo cách tương tự nếu chiến dịch chưa hoàn tất quy trình tự khai báo. Tập lệnh Google Ads sẽ thực thi các quy trình kiểm tra này khi cố gắng thay đổi tiêu chí nhắm mục tiêu bằng các phương thức AdsApp.mutate, AdsApp.mutateAll, AdsApp.Campaign.addProximity và AdsApp.Campaign.addLocation.
• Các biện pháp thực thi này cũng áp dụng cho những cơ chế khác mà bạn có thể sử dụng để tạo chiến dịch, chẳng hạn như chạy Công việc theo lô và sử dụng phương thức GoogleAdsService.Mutate để tạo và cập nhật thực thể.
• Nếu bạn cố gắng lên lịch cho một thử nghiệm mới bằng phương thức ExperimentService.ScheduleExperiment, thì hệ thống sẽ báo ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION lỗi nếu thiếu contains_eu_political_advertising declaration trong các chiến dịch thử nghiệm nháp.
• Nếu bạn sử dụng tính năng tải lên hàng loạt trong tập lệnh Google Ads, hãy xem tài liệu về sản phẩm để tìm hiểu thêm về những thay đổi đối với mẫu bảng tính cần thiết trong quá trình thay đổi này.

Các quy trình kiểm tra này đã được thực thi trong phiên bản v21 của Google Ads API.

Việc này sẽ ảnh hưởng như thế nào đến hoạt động phân phát chiến dịch của tôi?

Bất kỳ chiến dịch nào đã khai báo quảng cáo chính trị ở Liên minh Châu Âu bằng cách đặt contains_eu_political_advertising thành true sẽ ngừng phân phát quảng cáo ở Liên minh Châu Âu kể từ ngày 22 tháng 9 năm 2025. Hãy tham khảo Trung tâm trợ giúp của chúng tôi để tìm hiểu thêm.

Các chiến dịch hiện tại chưa có nội dung khai báo sẽ tạm thời không bị ảnh hưởng. Bạn nên cập nhật các chiến dịch hiện có trong tài khoản của mình bằng một nội dung khai báo phù hợp càng sớm càng tốt. Bạn có thể truy xuất các chiến dịch không có nội dung khai báo bằng cách sử dụng truy vấn GAQL sau đây thông qua phương thức Search hoặc SearchStream của GoogleAdsService.

select campaign.id, campaign.contains_eu_political_advertising
  from
    campaign
  where
    campaign.contains_eu_political_advertising NOT IN
    (
       'CONTAINS_EU_POLITICAL_ADVERTISING',
       'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING'
    )

Tôi cần phải làm gì?

Nếu ứng dụng của bạn sử dụng Google Ads API hoặc tập lệnh Google Ads để tạo hoặc quản lý chiến dịch, hãy nhớ cập nhật ứng dụng để xử lý các biện pháp thực thi này trước ngày 3 tháng 9 năm 2025.

Làm cách nào để được trợ giúp?

Hãy liên hệ với kênh Hỗ trợ Google Ads API hoặc Hỗ trợ tập lệnh Google Ads nếu bạn có thêm câu hỏi về thay đổi này.

 – Anash P. Oommen, Nhóm phụ trách Google Ads API

Nhãn: campaign, google-ads-api, google-ads-scripts