- TCF phiên bản 2.1: Chúng tôi sẽ tiếp tục chấp nhận các chuỗi theo TCF phiên bản 2.1 và 2.2 được tạo trước ngày 28 tháng 2 năm 2026, theo chính sách TCF của IAB.
- Các giải pháp quản lý sự đồng ý của Google: Các giải pháp quản lý sự đồng ý của Google (có trong thẻ Quyền riêng tư và thông báo của Ad Manager, AdSense và AdMob) hỗ trợ TCF phiên bản 2.3 cho các thông báo theo quy định của Châu Âu, phù hợp với các yêu cầu mới nhất của IAB dành cho các CMP.
Để giúp nhà xuất bản quản lý các lỗi và lỗi cấu hình sai liên quan đến việc triển khai Khuôn khổ về tính minh bạch và sự đồng ý phiên bản 2.2 và 2.3 của IAB ở Châu Âu, chúng tôi cung cấp một báo cáo về các lỗi mà chúng tôi đã phát hiện thấy.
Trong bài viết này, bạn sẽ tìm thấy nhiều thông tin hơn về cách giải quyết các lỗi khi triển khai Khuôn khổ về tính minh bạch và sự đồng ý (TCF) phiên bản 2.2 và 2.3, bao gồm:
Hướng dẫn mới
Cách khắc phục các lỗi thường gặp
Bạn có thể khắc phục một số lỗi thường gặp nhất trên Ad Manager, AdSense và AdMob bằng cách làm những việc sau:
Cân nhắc việc yêu cầu người dùng đồng ý lại bằng cách dùng các chuỗi về sự minh bạch và sự đồng ý không dùng để kiếm tiền(Lỗi 1.1, 3.1, 4.1, 5.1, 5.2 và 6.1)
(Các) lỗi liên quan
Hướng dẫn mới
Cân nhắc việc yêu cầu lại sự đồng ý của người dùng.
Lý do
Nhà xuất bản sẽ hưởng lợi từ việc yêu cầu lại sự đồng ý nếu trước đó họ đã sử dụng chuỗi ngoài phạm vi, chuỗi phạm vi toàn cầu, mã Nền tảng quản lý sự đồng ý (CMP) không hợp lệ (từ thử nghiệm), mã Danh sách nhà cung cấp toàn cầu (GVL) không hợp lệ (từ thử nghiệm) hoặc không có nhà cung cấp là Google để lấy sự đồng ý phù hợp tại một thời điểm nào đó trong quá trình triển khai.
Lỗi 1.1, 1.2, 1.3: Điều quan trọng là bạn phải kiểm tra xem các lỗi này có đại diện cho một khối lượng lưu lượng truy cập đáng kể hay không. Nếu có, hãy cân nhắc khả năng có vấn đề từ phía CMP và đảm bảo rằng Google được cấp sự đồng ý cho những mục đích cần thiết cũng như xuất hiện trong danh sách nhà cung cấp được cấp sự đồng ý VÀ lợi ích chính đáng (mã nhà cung cấp 755).
Quy cách của IAB
Theo quy cách của IAB, CMP có thể lưu chuỗi về sự đồng ý vào bộ nhớ đệm trong 13 tháng.
addEventListener trong thời gian 500 mili giây(Lỗi 2.1a và 2.1b)
(Các) lỗi liên quan
Lỗi 2.1a. Hướng dẫn này cũng có thể được áp dụng cho lỗi 2.1b.
Hướng dẫn mới
Mặc dù không còn yêu cầu về thời gian chờ, nhưng các CMP vẫn nên xem xét kỹ quy trình triển khai để đảm bảo trả về các lệnh gọi cho addEventListener ngay lập tức.
Nếu một CMP không phản hồi, nhà xuất bản có thể không kiếm tiền được từ yêu cầu quảng cáo đó.
Lý do
Google tuân thủ quy cách của Cục Quảng cáo tương tác (IAB), trong đó nêu rõ rằng CMP cần phải phản hồi hàm AddEventListener ngay lập tức. Nếu một CMP không phản hồi ngay lập tức, nhà xuất bản có thể không kiếm tiền được từ yêu cầu quảng cáo đó.
Ngoài ra, các phản hồi của CMP là một phần của chuỗi sự kiện ảnh hưởng đến việc yêu cầu quảng cáo có được gửi sớm hay không. Việc rút ngắn thời gian từ lúc tải trang đến lúc có kết quả yêu cầu quảng cáo sẽ giúp nhà xuất bản mất ít lượt hiển thị hơn.
Quy cách của IAB
Quy cách hiện hành của IAB: Quy cách addEventListener của IAB (trên GitHub)
addEventListener cần phải được thực hiện ngay khi đăng ký với dữ liệu hiện có về sự minh bạch và sự đồng ý (TC), ngay cả khi trạng thái của CMP là loading và CMP có dữ liệu TC không đầy đủ. Điều này cho phép tập lệnh gọi truy cập vào listenerId đã đăng ký. Ngoài ra, mỗi khi chuỗi về sự minh bạch và sự đồng ý thay đổi, lệnh gọi lại cần phải được thực hiện trừ phi bị xoá bằng removeEventListener.Trung tâm chính sách
Trung tâm chính sách sẽ thông báo cho nhà xuất bản nếu một ứng dụng hoặc trang web không tuân thủ các yêu cầu về việc quản lý sự đồng ý của Google.
Báo cáo lỗi
Chúng tôi sẽ thông báo cho nhà xuất bản trong giao diện người dùng của sản phẩm nếu phát hiện có vấn đề với chuỗi về sự minh bạch và sự đồng ý có liên quan đến một hoặc nhiều trang web hoặc ứng dụng của họ. Trên trang "Sự đồng ý của người dùng ở Liên minh Châu Âu" trong tài khoản của mình, nhà xuất bản gặp lỗi có thể nhấp vào Tải báo cáo lỗi TCF xuống để tải xuống báo cáo chi tiết về những lỗi đã được phát hiện trong 7 ngày qua.
- Ad Manager: Nhấp vào Quản trị, rồi nhấp vào Sự đồng ý của người dùng ở Liên minh Châu Âu.
- AdMob: Nhấp vào Chế độ chặn, rồi nhấp vào Quản lý quy định của Châu Âu.
- AdSense: Nhấp vào Sự an toàn cho thương hiệu. Nhấp vào Nội dung, Chế độ chặn, rồi nhấp vào Quản lý quy định của Châu Âu.
Báo cáo sẽ chứa những thông tin sau về từng lỗi đã phát hiện được:
- Miền/MobileAppID: Trang web hoặc ứng dụng di động bị định cấu hình sai.
- Đường dẫn của đơn vị quảng cáo: Đơn vị quảng cáo liên quan đến lỗi.
- Mã lỗi: Mã được gán cho lỗi.
- Số lỗi: Số lượng truy vấn có chứa lỗi đã quan sát được trong tuần trước.
- Ngày phát hiện gần nhất: Ngày gần đây nhất mà lỗi được phát hiện.
Nhà xuất bản có thể sử dụng các mã lỗi được liệt kê trong báo cáo để tìm các hành động nên làm trong bảng khắc phục sự cố dưới đây và sửa lỗi.
Khắc phục sự cố
Để giúp nhà xuất bản khắc phục các thành phần tích hợp TCF của IAB bị định cấu hình sai, chúng tôi đã tập hợp các bảng sau (gồm có những loại lỗi phổ biến nhất về chuỗi về sự minh bạch và sự đồng ý cùng các đề xuất tương ứng để khắc phục sự cố).
Hãy sử dụng các bảng sau để tìm hiểu các sự cố xảy ra ở cấp yêu cầu quảng cáo, cũng như hành vi tương ứng của hệ thống.
Trường hợp có sự đồng ý nhưng có giới hạn
Hệ thống luôn ưu tiên khắc phục cả 3 trường hợp này so với lỗi cấu hình sai, ngay cả khi một yêu cầu cụ thể có nhiều lỗi.
| Trường hợp | Nội dung mô tả | Việc nên làm |
|---|---|---|
| 1.1 | Với vai trò là nhà cung cấp, Google không được phép theo sự đồng ý hoặc lợi ích chính đáng. | Xác nhận xem liệu người dùng có cố ý từ chối Google với tư cách là nhà cung cấp, đã xảy ra lỗi triển khai CMP hoặc có các quy định hạn chế dành cho nhà xuất bản hay không. |
| 1.2 | Không có sự đồng ý cho Mục đích 1 đối với các quốc gia ở Khu vực kinh tế Châu Âu (EEA), Vương quốc Anh và Thuỵ Sĩ. |
Xác nhận xem liệu người dùng có cố ý không cho phép Mục đích 1 hay không, hoặc điều này có phải là do lỗi triển khai CMP hay không. Các nhà xuất bản ở Thuỵ Sĩ phải đảm bảo rằng họ sẽ đặt các trường
PublisherCC và PurposeOneTreatment đúng cách nếu không yêu cầu người dùng đồng ý. Kể từ tháng 12 năm 2021, chúng tôi sẽ không còn kiểm tra biện pháp xử lý |
| 1.3 | Có sự đồng ý cho Mục đích 1, nhưng thiếu cơ sở pháp lý cho Quảng cáo cơ bản. |
Xác nhận xem liệu người dùng có cố ý từ chối lợi ích chính đáng vì các mục đích khác hay không, hoặc có phải là do lỗi triển khai CMP hay không. |
| 1.4 | Phần "Nhà cung cấp được công bố" bắt buộc đối với tất cả các chuỗi Khuôn khổ về tính minh bạch và sự đồng ý (TCF) phiên bản 2.3 bị thiếu, bị sai định dạng hoặc không có Google. |
Google không thể xử lý yêu cầu này, có thể là do Google không được liệt kê trong phân đoạn nhà cung cấp được công bố, phân đoạn nhà cung cấp được công bố bị thiếu đối với chuỗi phiên bản 2.3 hoặc chúng tôi không thể xử lý phân đoạn nhà cung cấp được công bố. Xác nhận rằng chế độ thiết lập CMP của bạn hỗ trợ quy cách TCF phiên bản 2.3 và bạn đã định cấu hình CMP để thêm sản phẩm quảng cáo của Google (mã nhận dạng 755) vào cấu hình nhà cung cấp của CMP. Việc tuân thủ TCF phiên bản 2.3 là bắt buộc đối với tất cả các chuỗi về sự minh bạch và sự đồng ý được tạo vào hoặc sau ngày 1 tháng 3 năm 2026. |
Định cấu hình sai
Khi các vấn đề này xảy ra, Google sẽ cố gắng phân phát quảng cáo bị hạn chế.
| Lỗi | Nội dung mô tả | Việc nên làm |
|---|---|---|
| 2.1a | Thẻ hoặc SDK không nhận được chuỗi về sự minh bạch và sự đồng ý do trạng thái của CMP đang là stub, loading hoặc error. |
Nếu bạn đang gọi hàm yêu cầu quảng cáo theo cách thủ công, hãy đảm bảo phản hồi cho Nếu bạn không gọi thủ công hàm yêu cầu quảng cáo, hãy làm việc với CMP của bạn để đảm bảo CMP triển khai quy trình hỗ trợ addEventListener và trả về |
| 2.1b |
Cả hai điều kiện đều được đáp ứng:
|
Yêu cầu CMP của bạn đảm bảo rằng họ đã triển khai API đúng cách dựa trên thông số kỹ thuật TCF của IAB. |
| 2.2a |
Chuỗi về sự minh bạch và sự đồng ý không phân tích cú pháp được vì chuỗi này không được mã hoá base64. Ví dụ: |
CMP (hoặc nhà xuất bản) chỉ nên gửi dữ liệu được mã hoá base64 trong các thông số gdpr_consent=. |
| 2.2b |
Chuỗi về sự minh bạch và sự đồng ý không phân tích cú pháp được do lỗi giải mã. Ví dụ: Bao gồm số lượng bit không chính xác |
CMP phải khắc phục lỗi triển khai chuỗi về sự minh bạch và sự đồng ý. |
| 2.2c |
Chuỗi về sự minh bạch và sự đồng ý không phân tích cú pháp được do lỗi dữ liệu. Ví dụ: Dấu thời gian không chính xác, mã nhà cung cấp quá lớn |
CMP phải khắc phục lỗi triển khai chuỗi về sự minh bạch và sự đồng ý. |
Vấn đề với chuỗi về sự minh bạch và sự đồng ý
Vấn đề đối với chuỗi về sự minh bạch và sự đồng ý có liên quan đến yêu cầu quảng cáo. Khi các vấn đề này xảy ra, Google sẽ cố gắng phân phát quảng cáo bị hạn chế.
| Lỗi | Nội dung mô tả | Việc nên làm |
|---|---|---|
| 3.1 | Mã CMP không hợp lệ. |
Đảm bảo bạn đang sử dụng một CMP đã được IAB xác thực và đặt đúng mã CMP trong các chuỗi về sự minh bạch và sự đồng ý. Nếu một CMP hợp lệ khi chuỗi về sự minh bạch và sự đồng ý được tạo, nhưng sau đó lại bị IAB xoá, thì bạn cần phải lấy lại sự đồng ý bằng cách sử dụng một CMP hợp lệ. |
Cần phải lấy lại sự đồng ý
Cần phải nhận được sự đồng ý của người dùng. Nếu đang sử dụng phiên bản GVL mà Google chưa có tên trong đó, thì bạn phải lấy lại sự đồng ý của người dùng. Nếu không, Google sẽ cố gắng phân phát quảng cáo bị hạn chế.
| Lỗi | Nội dung mô tả | Việc nên làm |
|---|---|---|
| 4.1 | Chuỗi về sự minh bạch và sự đồng ý được tạo dựa trên phiên bản GVL mà Google chưa có tên trong đó. | Lấy lại sự đồng ý dựa trên phiên bản GVL hiện tại. |
Phạm vi trên toàn cầu và ngoài phạm vi
Sau đây là những vấn đề liên quan đến phạm vi trên toàn cầu và ngoài phạm vi (Ad Manager, AdMob, AdSense). Khi các vấn đề này xảy ra, Google sẽ cố gắng phân phát quảng cáo bị hạn chế.
| Lỗi | Nội dung mô tả | Việc nên làm |
|---|---|---|
| 5.1 | Chuỗi về sự minh bạch và sự đồng ý cho phép sự đồng ý ngoài phạm vi. | Hướng dẫn CMP của bạn xoá các tín hiệu ngoài phạm vi khỏi các chuỗi về sự minh bạch và sự đồng ý. |
| 5.2 | Chuỗi về sự minh bạch và sự đồng ý trong phạm vi trên toàn cầu. | Hướng dẫn CMP của bạn cập nhật các chuỗi về sự minh bạch và sự đồng ý dành riêng cho từng dịch vụ. |
Phiên bản TCF đang sử dụng đã lỗi thời
Khi các vấn đề này xảy ra, Google sẽ cố gắng phân phát quảng cáo bị hạn chế.
| Lỗi | Nội dung mô tả | Việc nên làm |
|---|---|---|
| 6.1 | Phiên bản chuỗi về sự minh bạch và sự đồng ý là 1 hoặc 1.1 (chuỗi phiên bản 1.0). |
CMP phải gửi chuỗi TCF phiên bản 2.2 hoặc 2.3. |
Google sẽ xử lý các vấn đề
Khi các vấn đề này xảy ra, Google sẽ tự khắc phục sự cố (khi cần thiết) và tiến hành xử lý TCF như thông thường.
| Lỗi | Nội dung mô tả | Việc nên làm |
|---|---|---|
| 7.7 | Mã ngôn ngữ không hợp lệ. | CMP phải khắc phục lỗi triển khai chuỗi về sự minh bạch và sự đồng ý. |
| 7.8 | Trường phiên bản chuỗi về sự minh bạch và sự đồng ý không phải là 1 hoặc 2. |
CMP phải khắc phục lỗi triển khai chuỗi về sự minh bạch và sự đồng ý bằng cách yêu cầu sự đồng ý mới nếu phát hiện thấy một chuỗi về sự minh bạch và sự đồng ý không hợp lệ. Nếu bạn sử dụng các giải pháp quản lý sự đồng ý của Google và UMP SDK trong ứng dụng của mình, hãy xác nhận rằng UMP SDK đã được triển khai đúng cách và |
| 7.9 | Phiên bản chuỗi sự đồng ý bổ sung không phải là 1 hoặc 2. |
CMP phải đặt phiên bản chuỗi sự đồng ý bổ sung thành 1 hoặc 2. |
Các vấn đề về chuỗi sự đồng ý bổ sung
Khi những vấn đề này xảy ra, Google sẽ coi chuỗi Sự đồng ý bổ sung (AC) là không hợp lệ và sẽ không xem xét thêm nhà cung cấp nào ngoài chuỗi về sự minh bạch và sự đồng ý đó.
| Lỗi | Nội dung mô tả | Việc nên làm |
|---|---|---|
| 8.1 | Chuỗi sự đồng ý bổ sung không sử dụng dấu phân cách phiên bản (~). |
CMP phải sử dụng "~" làm ký tự thứ hai của chuỗi sự đồng ý bổ sung để phân cách số phiên bản của danh sách nhà cung cấp đã nhận được sự đồng ý. |
| 8.2 | Chuỗi sự đồng ý bổ sung chứa danh sách nhà cung cấp không tuân theo định dạng dự kiến (danh sách int64s được phân cách bằng dấu ".") | CMP phải khắc phục lỗi triển khai chuỗi sự đồng ý bổ sung. |
Chứng nhận CMP
Khi các vấn đề này xảy ra, Google sẽ cố gắng phân phát quảng cáo không được cá nhân hoá.
| Lỗi | Nội dung mô tả | Việc nên làm |
|---|---|---|
| 9.1 | CMP theo TCF có trong yêu cầu này chưa được Google chứng nhận. | CMP phải được Google chứng nhận. |
Không có tín hiệu TCF nào trong yêu cầu quảng cáo
Khi các vấn đề này xảy ra, Google sẽ cố gắng phân phát quảng cáo bị hạn chế.
| Lỗi | Nội dung mô tả | Việc nên làm |
|---|---|---|
| 10.1 | Yêu cầu đến từ EEA, Vương quốc Anh hoặc Thuỵ Sĩ hoặc đã được gắn thẻ theo cách thủ công để thực thi Quy định chung về việc bảo vệ dữ liệu (GDPR) thông qua tham số gdpr=1, nhưng yêu cầu này thiếu tín hiệu TCF. |
Nhà xuất bản nên hợp tác với một CMP có tích hợp TCF và được Google chứng nhận và/hoặc đảm bảo rằng tham số gdpr=1 chỉ được đặt cho những người dùng thuộc phạm vi thực thi GDPR. |