Xử lý sự cố (Troubleshooting)

Các vấn đề bạn có thể gặp phải và các giải pháp khắc phục khả thi.

Không hiển thị modal đồng ý (Consent Modal)

Nguyên nhân có thể:

• Sai cấu hình guiOptions.
• SDK chưa được khởi tạo đúng cách.

Cách khắc phục:

1. Kiểm tra lại cấu hình trong guiOptions và đảm bảo modal được thiết lập đúng.
2. Xác minh rằng SDK đã được khởi tạo với các tham số hợp lệ.
3. Kiểm tra lỗi trong bảng điều khiển (console) của trình duyệt để tìm thông báo chi tiết.

---

CSS bị lỗi hoặc không áp dụng đúng

Nguyên nhân có thể:

• Các biến CSS không được ghi đè chính xác.
• Xung đột với các lớp CSS khác trong dự án.

Cách khắc phục:

1. Kiểm tra các biến CSS đã được ghi đè đúng cách theo tài liệu.
2. Sử dụng công cụ Developer Tools của trình duyệt để kiểm tra và sửa các vấn đề xung đột CSS.

---

Không lưu được sự đồng ý của người dùng

Nguyên nhân có thể:

• Cấu hình lưu trữ (storage) không chính xác.
• Quyền truy cập cookie hoặc localStorage bị hạn chế.

Cách khắc phục:

1. Đảm bảo rằng bạn đã thiết lập đúng cấu hình lưu trữ trong SDK.
2. Kiểm tra cài đặt trình duyệt hoặc chính sách bảo mật để đảm bảo cookie/localStorage được kích hoạt.

---

Lỗi khi tải SDK

Nguyên nhân có thể:

• Đường dẫn đến file SDK không đúng.
• Mạng kết nối bị gián đoạn.

Cách khắc phục:

1. Kiểm tra lại đường dẫn đến SDK trong file cấu hình của bạn.
2. Đảm bảo rằng không có vấn đề về mạng hoặc firewall cản trở việc tải file.

---

Giao diện không tương thích trên một số trình duyệt

Nguyên nhân có thể:

• Một số tính năng CSS/JavaScript không được hỗ trợ trên trình duyệt cũ.

Cách khắc phục:

1. Kiểm tra danh sách trình duyệt được hỗ trợ trong tài liệu.
2. Cập nhật trình duyệt lên phiên bản mới nhất.
3. Thêm các giải pháp thay thế (polyfills) cho các tính năng không được hỗ trợ.

---

Lỗi "Missing or invalid credentials"

Nguyên nhân có thể:

• Thông tin đăng nhập (url, key, trackingId) không được cung cấp đầy đủ hoặc không hợp lệ.
• Địa chỉ url không đúng hoặc không thể kết nối với máy chủ Kalapa CMP.

Cách khắc phục:

1. Kiểm tra lại cấu hình thông tin đăng nhập:
   • Đảm bảo tất cả các trường url, key, và trackingId đã được điền đầy đủ và chính xác.
2. Xác minh rằng url là địa chỉ hợp lệ của máy chủ Kalapa CMP.
3. Kiểm tra xem key và trackingId có đúng với thông tin được cung cấp bởi Kalapa không.
4. Nếu vấn đề vẫn tiếp diễn, liên hệ với đội ngũ hỗ trợ Kalapa để xác nhận thông tin đăng nhập.

---

Lỗi "Unauthorized access" hoặc "Invalid API key"

Nguyên nhân có thể:

• Khóa API (key) không hợp lệ hoặc đã hết hạn.
• Tài khoản của bạn không có quyền truy cập vào hệ thống Kalapa CMP.

Cách khắc phục:

1. Đảm bảo rằng key sử dụng là khóa API hợp lệ do Kalapa cung cấp.
2. Liên hệ với Kalapa để xác nhận trạng thái và quyền hạn của tài khoản.
3. Nếu cần, yêu cầu cấp mới hoặc gia hạn khóa API.

---

Không thể kết nối tới máy chủ Kalapa CMP

Nguyên nhân có thể:

• Địa chỉ url không đúng hoặc không thể truy cập do mạng.
• Máy chủ Kalapa CMP gặp sự cố hoặc bị chặn bởi tường lửa.

Cách khắc phục:

1. Kiểm tra lại địa chỉ url và đảm bảo nó khớp với địa chỉ được cung cấp bởi Kalapa.
2. Xác minh rằng mạng của bạn cho phép truy cập đến url này (không bị chặn bởi tường lửa hoặc chính sách mạng).
3. Kiểm tra trạng thái hoạt động của hệ thống Kalapa CMP. Nếu cần, liên hệ với đội ngũ hỗ trợ để xác nhận.

---

Lỗi khi theo dõi khách hàng (trackingId)

Nguyên nhân có thể:

• Trường trackingId bị thiếu hoặc không chính xác.

Cách khắc phục:

1. Kiểm tra lại giá trị của trackingId và đảm bảo rằng nó đúng với ID được cung cấp bởi Kalapa.
2. Nếu không chắc chắn về trackingId, hãy liên hệ với Kalapa để được hỗ trợ.

---

Nếu các vấn đề vẫn tiếp diễn, vui lòng liên hệ với đội ngũ hỗ trợ của Kalapa để được giúp đỡ kịp thời.