Cài đặt script
Việc cài đặt là một thẻ script trong phần head của trang. Script tải bất đồng bộ, không bao giờ chặn việc hiển thị, và không đặt cookie nào trên thiết bị của khách truy cập.
Thẻ script
Sao chép thẻ từ Tích hợp. Thẻ mang khóa công khai của bạn, vốn được thiết kế để công khai và chỉ hoạt động trên tên miền của chính bạn.
<script async src="https://…/l.js" data-loop="pk_live_…"></script>Vị trí đặt trên các nền tảng phổ biến
| Nền tảng | Vị trí |
|---|---|
| WordPress | Appearance → Theme File Editor → header.php, hoặc plugin “header scripts” |
| Ghost | Settings → Code injection → Site header |
| Tistory | Skin editor → HTML → bên trong <head> |
| Webflow | Site settings → Custom code → Head code |
| Squarespace | Settings → Advanced → Code Injection → Header |
| Wix | Settings → Custom code → Head |
| Shopify | Online Store → Themes → Edit code → theme.liquid |
Cài đặt bằng AI
Tích hợp → Cài đặt bằng AI cung cấp một hướng dẫn cho Claude Code, Cursor hoặc Codex. Hướng dẫn nêu chính xác thẻ cần thêm, vị trí của nó trong framework của bạn, những gì không được động vào, và cách kiểm tra kết quả. Nó được ghép từ văn bản cố định đã được xem xét và chỉ chứa khóa công khai của bạn.
React và Next.js
Các component bao quanh script và một slot nằm trong gói SDK. Gói chưa được xuất bản lên npm, nên hầu hết website nên dùng thẻ script; trong Next.js App Router, hãy đặt nó trong app/layout.tsx hoặc dùng next/script với cùng các thuộc tính.
Content-Security-Policy
Nếu website của bạn gửi header Content-Security-Policy, hãy cho phép origin của script trong cả script-src và connect-src.
Cách xác minh hoạt động
Không cần tải tệp lên và không cần bản ghi DNS. Việc script gọi chúng tôi từ một trang thuộc tên miền của bạn là bằng chứng bạn kiểm soát website. Tài khoản đầu tiên làm được điều đó sẽ giữ tên miền; cho đến lúc đó, bất kỳ ai cũng có thể giữ một bản nháp chưa xác minh của nó, và các website chưa xác minh không tham gia vào việc trao đổi.
Câu hỏi thường gặp
- Script nặng bao nhiêu?
- Dưới 4 KB khi nén.
- Nó có đặt cookie không?
- Không cookie, và không lưu gì trên thiết bị của khách truy cập trên website của bạn. Một ngoại lệ: trên website mà khách truy cập đến sau khi nhấp vào một đơn vị quảng cáo, một token cho lượt truy cập đó được giữ trong thẻ trình duyệt đó tối đa một giờ, để việc đăng ký hoặc mua hàng tại đó có thể được tính. Token mất đi khi đóng thẻ và không website nào khác đọc được.
- Tôi có thể tải nó qua trình quản lý thẻ (tag manager) không?
- Có, miễn là thẻ giữ thuộc tính data-loop. Tải trực tiếp trong head sẽ xác minh website sớm hơn.