Hướng dẫn6 Th11, 2026 | FlexyConsent

Gỡ lỗi chuỗi IAB GPP trong bảng điều khiển trình duyệt: Hướng dẫn từng bước

Vì sao các vấn đề về GPP khó phát hiện

Khi một khách truy cập Hoa Kỳ từ chối việc bán hoặc chia sẻ dữ liệu của họ, lựa chọn đó phải đến được mọi đối tác quảng cáo trên trang. Với IAB Global Privacy Platform (GPP), nó được truyền đi dưới dạng một chuỗi nhỏ gọn và một danh sách ID phần. Nếu một trong hai bị sai — thiếu, lỗi thời hoặc mang sai phần — thì không có gì hỏng một cách dễ thấy. Quảng cáo vẫn tải, biểu ngữ vẫn trông ổn, và vấn đề chỉ lộ ra sau đó khi các đối tác bỏ qua lựa chọn từ chối hoặc đặt giá thầu thấp hơn cho kho quảng cáo của bạn.

Tin tốt là bạn có thể kiểm tra hầu hết mọi thứ từ bảng điều khiển trình duyệt. Hướng dẫn này đi qua các bước kiểm tra theo thứ tự mà chúng tôi sẽ thực hiện trên một trang đang hoạt động.

Bước 1: Xác nhận API tồn tại và đã sẵn sàng

Một CMP tương thích GPP cung cấp một hàm toàn cục __gpp. Mở DevTools trên trang của bạn và chạy lệnh ping:

__gpp('ping', function (data) { console.log(data); });

Đối tượng trả về cho bạn biết rất nhiều chỉ trong một cái nhìn:

Nếu __gpp là undefined, thì stub của CMP bị thiếu hoặc tải quá muộn. Stub phải có sẵn trước bất kỳ tập lệnh quảng cáo nào cần đến nó, nếu không các tập lệnh đó sẽ không thấy CMP và hoặc chờ đợi, hoặc tiếp tục mà không có tín hiệu.

Bước 2: Kiểm tra phần áp dụng

Mỗi khung quyền riêng tư trong GPP có một ID phần dạng số. Những ID mà nhà xuất bản gặp thường xuyên nhất là 2 (EU TCF v2), 5 (TCF của Canada), 7 (US National, “usnat”) và từ 8 trở đi cho các phần của từng bang như California, Virginia, Colorado, Utah và Connecticut. Một khách truy cập từ một bang của Hoa Kỳ thông thường sẽ thấy phần quốc gia hoặc phần của bang liên quan trong applicableSections, chứ không phải phần EU.

Hãy kiểm thử từ nhiều vị trí. Một lỗi phổ biến là CMP phát hiện đúng vị trí địa lý cho biểu ngữ nhưng vẫn ghi một phần mặc định vào chuỗi, hoặc ngược lại. Sử dụng VPN hoặc các công cụ xem trước của CMP, hãy so sánh những gì biểu ngữ hiển thị với những gì applicableSections báo cáo.

Bước 3: Đọc dữ liệu của phần

Thay vì giải mã chuỗi bằng tay, hãy yêu cầu CMP cung cấp phần đã được phân tích:

__gpp('getSection', function (data, success) { console.log(data, success); }, 'usnat');

Trong phần US National, các trường từ chối dùng một quy ước đơn giản: 0 nghĩa là không áp dụng, 1 nghĩa là người dùng đã từ chối, và 2 nghĩa là người dùng không từ chối. Hãy tập trung vào các trường này trước:

Bây giờ hãy thực hiện việc từ chối trên trang — nhấp vào liên kết “Do Not Sell or Share” của bạn hoặc bật tắt cài đặt trong trung tâm tùy chọn — và chạy lại getSection. Các trường từ chối phải chuyển từ 2 sang 1. Nếu không, giao diện và tín hiệu đang không đồng bộ.

Bước 4: Kiểm thử đường đi của Global Privacy Control

Một số luật của các bang yêu cầu doanh nghiệp coi tín hiệu Global Privacy Control là một lựa chọn từ chối. Hãy bật GPC trong một trình duyệt hoặc tiện ích mở rộng hỗ trợ nó, xác nhận navigator.globalPrivacyControl trả về true trong bảng điều khiển, rồi tải trang trong một phiên mới. Các trường từ chối liên quan phải đã hiển thị 1 mà khách truy cập không cần chạm vào biểu ngữ. Một số phần còn bao gồm một trường cho biết lựa chọn đến từ tín hiệu GPC.

Bước 5: Theo dõi sự kiện, không chỉ ảnh chụp tức thời

Các tập lệnh quảng cáo không nên đọc chuỗi một lần khi tải trang rồi quên nó. Hãy đăng ký một listener để xem các đối tác thấy gì:

__gpp('addEventListener', function (evt) { console.log(evt.eventName, evt.pingData); });

Bạn sẽ quan sát được các sự kiện như listenerRegistered, signalStatus và sectionChange. Khi khách truy cập thay đổi lựa chọn, một sự kiện sectionChange với chuỗi đã cập nhật sẽ theo sau. Nếu wrapper header bidding hoặc tích hợp máy chủ quảng cáo của bạn chỉ đọc chuỗi trước khi signalStatus chuyển thành “ready”, nó có thể gửi một giá trị trống hoặc lỗi thời.

Bước 6: Lần theo chuỗi đến các yêu cầu quảng cáo

Cuối cùng, mở tab Network và lọc các yêu cầu quảng cáo của bạn. Nhiều điểm cuối quảng cáo chấp nhận các tham số gpp và gpp_sid (chuỗi và các ID phần áp dụng). Hãy kiểm tra rằng:

  1. cả hai tham số đều có mặt trong các yêu cầu từ khách truy cập Hoa Kỳ;
  2. chuỗi khớp với chuỗi mà ping trả về tại thời điểm yêu cầu;
  3. sau khi từ chối, các yêu cầu tiếp theo mang chuỗi mới thay vì chuỗi đã lưu trong bộ nhớ đệm.

Nếu bạn dùng Prebid.js, hãy xác nhận mô-đun quản lý đồng ý của nó được cấu hình cho GPP, và kiểm tra các yêu cầu đặt giá thầu rời khỏi wrapper cũng như lệnh gọi máy chủ quảng cáo cuối cùng.

Các mẫu lỗi thường gặp

Những điểm chính cần nhớ

← Blog Đọc tất cả →