Gửi phản hồi & Báo lỗi

Khi có quảng cáo lọt qua bộ lọc, giao diện trang web bị vỡ hoặc trình phát video gặp sự cố, việc gửi báo cáo giúp tác giả tái hiện và khắc phục lỗi nhanh chóng mà không đòi hỏi bạn phải biết đọc mã nguồn HTML hay JavaScript.

Chọn đúng kênh liên hệ#

Nvirya AdGuard cung cấp sẵn các kênh phản hồi trong mục Giới thiệu → Cộng đồng & hỗ trợ:

Giới hạn tần suất gửi: Để tránh gửi trùng lặp do chạm nhầm, hộp thoại Gửi phản hồi áp dụng thời gian chờ 30 giây trên mỗi tên miền (nvirya_x_last_report). Nếu bạn gửi tiếp trong vòng 30 giây trên cùng một trang, thông báo sẽ hiện: Vui lòng đợi {sec} giây trước khi gửi tiếp.

Dữ liệu nào được thu thập trong báo cáo lỗi?#

Khi bạn chọn Quảng cáo bị sót, Lỗi bố cục trang, Lỗi phát video, hoặc Khác trong hộp thoại Gửi phản hồi và nhấn Gửi, hàm submitReport() sẽ đóng gói dữ liệu JSON và gửi qua phương thức HTTP POST (GM_xmlhttpRequest hoặc fetch) tới Discord webhook được cấu hình trong script.

Mỗi báo cáo lỗi bao gồm chính xác các trường sau:

1. Tên miền trang web (Domain): Giá trị location.hostname hiện tại (ví dụ: news.example.com).
2. Phiên bản script (Phiên bản): v11.7.0.
3. Phân loại sự cố đã chọn (Lý do): Missed ad, Broken layout, Player issue, hoặc Other.
4. URL trang đã làm sạch (URL (Sanitized)): Được tạo bởi hàm getSanitizedUrl() (giới hạn tối đa 1.000 ký tự):
   • Xóa bỏ hoàn toàn phần neo #hash ở cuối URL.
   • Quét toàn bộ tên tham số truy vấn (?key=value). Bất kỳ tham số nào có tên khóa khớp với /auth|token|session|key|pass|code|secret|credential|email|user/i đều được thay thế giá trị thành [REDACTED].
5. Ghi chú của người dùng (Ghi chú): Nội dung bạn nhập vào ô Chi tiết (tùy chọn): (tối đa 1.000 ký tự), hoặc (Không có) nếu để trống.
6. Thống kê chặn (Thống kê chặn):
   • Session (Phiên này): Số lượng ads, hidden và popups trong phiên hiện tại.
   • Lifetime (Tích lũy): Tổng số ads và hidden tích lũy.
7. Nhật ký lọc gần nhất (Logs gần nhất): 4 bản ghi cuối cùng từ bộ đệm logRing trong bộ nhớ ([LEVEL] type: message extra, giới hạn 900 ký tự).
8. Thông tin trình duyệt (User Agent): Chuỗi navigator.userAgent của trình duyệt (giới hạn 200 ký tự) để tác giả biết lỗi xảy ra trên trình duyệt và hệ điều hành nào.

Dữ liệu gửi đi khi Đề xuất tính năng#

Khi bạn chọn Đề xuất tính năng (Feature request), bạn bắt buộc phải nhập mô tả (Vui lòng nhập mô tả ngắn trước nếu để trống). Script chỉ gửi:

• Nội dung đề xuất của bạn (tối đa 1.000 ký tự)
• Phiên bản đang dùng (v11.7.0)
• Nhóm nền tảng thiết bị (iOS / iPadOS hoặc Android / Desktop)

Chế độ đề xuất tính năng không gửi tên miền trang web, URL trang, thống kê chặn, nhật ký lọc hay chuỗi User-Agent đầy đủ.

Ranh giới quyền riêng tư: Những điều cần lưu ý trước khi nhấn Gửi#

Nvirya AdGuard minh bạch về phạm vi bảo mật của báo cáo:

• Truyền tải qua Webhook: Báo cáo được gửi qua kết nối HTTPS tới Discord webhook của dự án, nghĩa là dữ liệu báo cáo được truyền qua hạ tầng của Discord (discord.com / discordapp.com).
• Giới hạn của việc làm sạch URL tự động: Dù getSanitizedUrl() tự động ẩn giá trị của các tham số có tên khóa chứa token, session, auth, key, pass, code, secret, email hoặc user, hàm này không thể biết liệu một trang web có nhúng mã định danh cá nhân trực tiếp vào đường dẫn URL (ví dụ: https://example.com/account/orders/987654) hoặc dùng tên tham số riêng biệt (như ?id=12345) hay không.

Trước khi nhấn Gửi báo cáo lỗi:

1. Kiểm tra xem bạn có đang ở trang tài khoản cá nhân đã đăng nhập, tài liệu riêng tư hay cổng nội bộ hay không. Nếu bản thân đường dẫn URL mang tính riêng tư, không gửi báo cáo tự động từ trang đó.
2. Tuyệt đối không dán mật khẩu, cookie phiên, thông tin liên hệ cá nhân hoặc khóa bí mật vào ô Chi tiết (tùy chọn):.

Tự kiểm tra dữ liệu chẩn đoán (Sao chép nhật ký chẩn đoán)#

Nếu bạn muốn xem toàn bộ thông tin chẩn đoán trước khi chia sẻ, hãy mở Giới thiệu → Chẩn đoán → Sao chép nhật ký chẩn đoán. Thao tác này sao chép bản tóm tắt văn bản do collectDebugInfo() tạo ra vào bộ nhớ tạm để bạn tự kiểm tra và biên tập trước khi gửi qua Telegram hoặc Discord.