เอกสารอ้างอิง Browser SDK
สคริปต์มีพื้นผิวที่เล็กโดยตั้งใจ: หนึ่งแท็ก หนึ่งชนิดองค์ประกอบ หนึ่งฟังก์ชัน
แท็กสคริปต์
| แอตทริบิวต์ | ความหมาย |
|---|---|
| src | ที่อยู่สคริปต์ที่แสดงในหน้าการเชื่อมต่อของคุณ |
| data-loop | publishable key ของคุณ เป็นสาธารณะ ใช้ได้เฉพาะบนโดเมนที่ยืนยันแล้วของคุณ |
| async | จำเป็น สคริปต์ต้องไม่บล็อกหน้าของคุณ |
องค์ประกอบสล็อต
| แอตทริบิวต์ | ความหมาย |
|---|---|
| data-loop-slot | ชื่อของตำแหน่ง ไม่เกิน 64 อักขระ ปรากฏในรายงานตำแหน่งของคุณ |
| data-loop-size | ไม่บังคับ หนึ่งใน 300x250, 320x50, 320x100, 728x90, 970x250, 160x600 ทำให้สล็อตเป็นแบนเนอร์ |
| data-loop-type | ไม่บังคับ recommendation (ค่าเริ่มต้นเมื่อไม่มีขนาด), feed หรือ banner |
การติดตามคอนเวอร์ชัน
name เป็นสตริงไม่เกิน 40 อักขระ props เป็นออบเจ็กต์แบบแบนที่ไม่บังคับ ประกอบด้วยสตริง ตัวเลข และบูลีน การเรียกจะถูกเพิกเฉยเว้นแต่การโหลดหน้าปัจจุบันมาถึงผ่านยูนิต
loop('track', name, props?)พฤติกรรมที่คุณวางใจได้
- ทำงานครั้งเดียวต่อหน้า ไม่ว่าแท็กจะถูกใส่กี่ครั้ง
- ค้นหาสล็อตที่เพิ่มภายหลังโดยการนำทางฝั่งไคลเอนต์
- เรนเดอร์แต่ละยูนิตใน closed shadow root: CSS ของคุณไม่กระทบยูนิต และยูนิตไม่กระทบหน้าของคุณ
- ไม่เคยโยนข้อผิดพลาดเข้าสู่หน้าของคุณ ความล้มเหลวใด ๆ จบลงด้วยสล็อตที่ว่างและยุบ
- รายงานผ่าน sendBeacon ด้วยเนื้อหา text/plain จึงไม่มีคำขอ preflight
การดีบัก
เพิ่ม data-loop-debug ให้สล็อตเพื่อเปิด shadow root ให้ตรวจสอบในเครื่องมือนักพัฒนา ในแท็บ network คำขอแรกไปที่ /v1/config โดย 200 หมายความว่าคีย์และโดเมนตรงกัน