- 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, nhưng khuyến khích các Nền tảng quản lý sự đồng ý (CMP) tuân theo TCF phiên bản 2.2 hướng dẫn của IAB về các mốc triển khai khi toàn ngành chuyển sang TCF phiên bản 2.2.
- 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.2 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 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, bao gồm:
Hướng dẫn mới
Thông tin mới
- Lời nhắc về yêu cầu của Khuôn khổ về tính minh bạch và sự đồng ý (TCF) liên quan đến việc lấy lại sự đồng ý 13 tháng một lần:
Theo chính sách Khuôn khổ về tính minh bạch và sự đồng ý (TCF) của Cục Quảng cáo tương tác (IAB), bạn phải nhắc người dùng về các lựa chọn đồng ý của họ ít nhất 13 tháng (390 ngày) một lần. Nếu quyết định đồng ý của người dùng đã quá 13 tháng, thì chuỗi TC (chuỗi về sự minh bạch và sự đồng ý) sẽ không còn được Google coi là hợp lệ và Google sẽ không phân phát quảng cáo đến người dùng đó nữa. Bạn nên làm việc với Nền tảng quản lý sự đồng ý (CMP) của mình để nhắc người dùng về các lựa chọn đồng ý của họ trước khi đạt đến giới hạn 13 tháng.
- Chúng tôi đã loại bỏ loại lỗi 3.2. Các chuỗi về sự minh bạch và sự đồng ý được cập nhật trong 13 tháng qua sẽ vẫn có hiệu lực.
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 số điểm 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.
AddEventHandler
trong khoảng 500 mili giây(Lỗi 2.1a, 2.1b, 2.0a, 2.0b và 2.0c)
(Các) lỗi liên quan
Lỗi 2.1a. Hướng dẫn này cũng có thể áp dụng cho lỗi 2.1b, 2.0a, 2.0b và 2.0c.
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ỹ việc triển khai của họ để đảm bảo họ có thể trả về ngay lập tức các lệnh gọi tới AddEventListener getTCData
.
Nếu một CMP không phản hồi, yêu cầu có thể không dùng để kiếm tiền được.
Lý do
Google tuân thủ thông số kỹ thuật của IAB, trong đó nhấn mạnh rằng CMP nên trả lời ngay lập tức cho hàm AddEventListener
. Nếu một CMP không phản hồi ngay lập tức, yêu cầu có thể không dùng để kiếm tiền được.
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
sẽ được gọi ngay khi đăng ký bằng 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 chưa hoàn chỉnh về TC. Đ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 sẽ được gọi 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 và AdSense: Nhấp vào Chế độ chặn, rồi nhấp vào Sự đồng ý của người dùng ở Liên minh 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 tính năng tích hợp TCF phiên bản 2.2 của IAB bị định cấu hình không chính xác, chúng tôi đã tập hợp các bảng sau (gồm những loại lỗi phổ biến nhất đối với chuỗi về sự minh bạch và sự đồng ý, cũng như các đề xuất để khắc phục sự cố tương ứng).
Hãy sử dụng các bảng sau để tìm hiểu các vấn đề 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à Vương quốc Anh. |
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. |
Định cấu hình sai
Yêu cầu quảng cáo sẽ không được thực hiện nếu đang có lỗi cấu hình sai.
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 nhớ phản hồi các mã Nếu bạn không gọi hàm yêu cầu quảng cáo theo cách thủ công, hãy làm việc với CMP của bạn để đảm bảo họ hỗ trợ triển khai |
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ã hóa 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 một yêu cầu quảng cáo. Yêu cầu quảng cáo sẽ bị loại bỏ và không được thực hiện.
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ệ. |
3.2 | Không còn được sử dụng. | Không có. Ý nghĩa trước đó: Chuỗi về sự minh bạch và sự đồng ý đã được tạo cách đây hơn 13 tháng. |
Cần phải lấy lại sự đồng ý
Bạn cần phải nhận được sự đồng ý của người dùng. Nếu đã nhận được sự đồng ý của người dùng cách đây hơn 13 tháng hoặc 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, yêu cầu quảng cáo sẽ bị loại bỏ và quảng cáo sẽ không hiển thị.
Lỗi | Nội dung mô tả | Việc nên làm |
---|---|---|
3.3 | Chuỗi về sự minh bạch và sự đồng ý được cập nhật lần gần nhất cách đây hơn 13 tháng. |
CMP phải xoá chuỗi về sự minh bạch và sự đồng ý cũ, rồi lấy lại sự đồng ý. Theo dự kiến, một số ít lỗi này có thể xảy ra nếu yêu cầu quảng cáo được gửi kèm theo chuỗi về sự minh bạch và sự đồng ý đã hết hạn trước khi CMP hết hiệu lực và lấy lại sự đồng ý của người dùng. 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à |
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). Quảng cáo sẽ không được phân phát nếu chuỗi về sự minh bạch và sự đồng ý có trạng thái "ngoài phạm vi" hoặc "phạm vi trên toàn cầu".
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ụ. |
Bị giới hạn phân phát quảng cáo
Quảng cáo bị hạn chế sẽ được phân phát.
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. |
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.1 | gdprApplies không xác định hoặc được đặt thành giá trị không hợp lệ hoặc không thể đọc được, nhưng có chuỗi về sự minh bạch và sự đồng ý hợp lệ. |
Không áp dụng |
7.2 | Chuỗi về sự minh bạch và sự đồng ý được tạo bằng phiên bản GVL mới hơn phiên bản hiện tại mà công nghệ phân phát quảng cáo của Google xác định. | Không áp dụng |
7.3 | Một số mục đích, tính năng và/hoặc nhà cung cấp nằm ngoài phạm vi (không xác định). | Không áp dụng |
7.4 | Chuỗi về sự minh bạch và sự đồng ý có tcf_policy_version cũ hơn GVL mới nhất. |
CMP phải xoá chuỗi về sự minh bạch và sự đồng ý cũ, rồi lấy lại sự đồng ý dựa trên phiên bản GVL mới nhất. |
7.5 |
Yêu cầu có |
Không áp dụng |
7.6 | Mã quốc gia của nhà xuất bản không hợp lệ, nhưng có sự đồng ý cho Mục đích 1. | CMP phải khắc phục lỗi triển khai chuỗi về sự minh bạch và sự đồng ý. |
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 đã tích hợp 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ĩ nhưng 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. |