Tài liệu tham khảo SDK trình duyệt
Script có bề mặt cố ý nhỏ gọn: một thẻ, một loại phần tử, một hàm.
Thẻ script
| Thuộc tính | Ý nghĩa |
|---|---|
| src | Địa chỉ script hiển thị trên trang Tích hợp của bạn. |
| data-loop | Khóa công khai của bạn. Công khai; chỉ hoạt động trên tên miền đã xác minh của bạn. |
| async | Bắt buộc. Script không được chặn trang của bạn. |
Phần tử slot
| Thuộc tính | Ý nghĩa |
|---|---|
| data-loop-slot | Tên của vị trí, tối đa 64 ký tự. Nó xuất hiện trong báo cáo vị trí của bạn. |
| data-loop-size | Không bắt buộc. Một trong 300x250, 320x50, 320x100, 728x90, 970x250, 160x600. Biến slot thành banner. |
| data-loop-type | Không bắt buộc. recommendation (mặc định khi không có kích thước), feed, hoặc banner. |
Theo dõi một chuyển đổi
name là một chuỗi tối đa 40 ký tự. props là một đối tượng phẳng tùy chọn gồm chuỗi, số và boolean. Lệnh gọi bị bỏ qua trừ khi lần tải trang hiện tại đến qua một đơn vị quảng cáo.
loop('track', name, props?)Hành vi bạn có thể tin cậy
- Chạy một lần cho mỗi trang, dù thẻ được đưa vào bao nhiêu lần.
- Tìm các slot được thêm sau bằng điều hướng phía client.
- Dựng mỗi đơn vị quảng cáo trong một closed shadow root: CSS của bạn không thể ảnh hưởng đến nó và nó không thể ảnh hưởng đến trang của bạn.
- Không bao giờ ném lỗi vào trang của bạn. Mọi lỗi đều kết thúc bằng việc slot để trống và thu gọn.
- Báo cáo qua sendBeacon với nội dung text/plain, nên không có yêu cầu preflight nào được thực hiện.
Gỡ lỗi
Thêm data-loop-debug vào một slot để mở shadow root của nó cho việc kiểm tra trong công cụ nhà phát triển. Trong tab mạng, yêu cầu đầu tiên là đến /v1/config; mã 200 nghĩa là khóa và tên miền khớp nhau.