เอกสาร

ติดตั้งแท็ก

การติดตั้งแบบมาตรฐานเป็นสคริปต์ async บรรทัดเดียววางก่อนแท็กปิด body ของทุกหน้าที่คุณต้องการวัดผล แทนที่ XXXX ด้วย site_id ที่แสดงบนหน้าจัดการไซต์

<script async src="https://9ping.dev/hm.min.js" data-sid="XXXX"></script>

หากคุณใช้ Google Tag Manager ให้สร้างแท็ก Custom HTML ใหม่ วางสคริปต์เดียวกัน และตั้งทริกเกอร์เป็น All Pages

สำหรับผู้เข้าชมที่ปิด JavaScript หรือบริบทอีเมลและ AMP ให้เพิ่มภาพ pixel ขนาด 1x1 ภายในแท็ก noscript คุณจะได้บันทึก PV เป็นอย่างน้อย

<noscript><img src="https://9ping.dev/collect.php?sid=XXXX&type=pv" width="1" height="1" alt=""></noscript>

สำหรับ single-page apps (React, Vue, Next, Nuxt และอื่น ๆ) ให้แทรกสคริปต์ครั้งเดียวตอนเริ่มต้น แท็กจะนับ PV เสมือนโดยอัตโนมัติทุกครั้งที่มีการเปลี่ยน route ฝั่งไคลเอ็นต์

(function(){var s=document.createElement('script');s.async=true;s.src='https://9ping.dev/hm.min.js';s.dataset.sid='XXXX';document.head.appendChild(s);})();

อีเวนต์กำหนดเอง

เมื่อแท็กโหลดแล้ว ฟังก์ชัน window.tj ระดับโกลบอลจะพร้อมใช้งานสำหรับอีเวนต์เฉพาะกิจ เช่น การคลิกปุ่ม การส่งฟอร์ม และการดาวน์โหลด รูปแบบคือ category, action, label

tj('event', 'button', 'click', 'download_whitepaper');

สำหรับเราเตอร์ที่คุณควบคุมเอง คุณสามารถส่ง PV แบบชัดเจนโดยเรียก tj('pv') สำหรับการคลิกที่เกิดก่อนแท็กโหลด สตับเริ่มต้นจะเก็บการเรียกไว้และส่งซ้ำทันทีที่สคริปต์โหลดเสร็จ คุณจึงไม่จำเป็นต้องห่อ handler ด้วย setTimeout

ยืนยันความเป็นเจ้าของไซต์

แนะนำให้ทำการยืนยันก่อนเปิดใช้รายงานขั้นสูง หน้าจัดการไซต์มี 4 วิธีให้เลือกใช้แทนกันได้สำหรับแต่ละไซต์ เลือกวิธีที่ง่ายที่สุด

วิธีที่หนึ่ง ไฟล์ HTML ดาวน์โหลด tj-verify-TOKEN.html จากแดชบอร์ดและอัปโหลดไปที่รูทของไซต์

วิธีที่สอง เมตาแท็ก วางเมตาแท็กบรรทัดเดียวใน head ของหน้าแรก

<meta name="tj-site-verification" content="YOUR_TOKEN">

วิธีที่สาม โค้ดติดตาม หากหน้าแรกมีแท็กของเรารันอยู่และได้รับการเข้าชมอย่างน้อยหนึ่งครั้ง ระบบจะยืนยันโดยอัตโนมัติ วิธีที่สี่ DNS TXT เพิ่ม tj-site-verification=YOUR_TOKEN เป็นเรคคอร์ด TXT บนโดเมนหลัก

Open API และการติดตั้งแบบกลุ่ม

ทุกบัญชีมาพร้อมคีย์ API ส่วนตัว (ขึ้นต้นด้วย tjk_) ที่ให้คุณดูรายการไซต์ สร้างไซต์ ดึงสคริปต์แท็ก และอ่านสถิติผ่าน HTTPS ยืนยันตัวตนโดยส่ง header X-API-Key

curl -H "X-API-Key: $TJ_KEY" "https://9ping.dev/openapi.php?action=sites"

หากต้องการติดตั้งแท็กในกลุ่มไซต์ทั้งหมดจากเครื่อง Linux เครื่องเดียว ให้ดาวน์โหลด tj-deploy.sh จากหน้าจัดการไซต์ มันจะลงทะเบียนแต่ละโดเมนผ่าน API สร้างสคริปต์แท็ก และเลือกที่จะแทรกเข้าไปในเทมเพลตของคุณก็ได้

Open API รองรับการสร้างไซต์แบบกลุ่มจากไฟล์ข้อความ โดยแต่ละบรรทัดเป็นโดเมนเปล่าหรือ domain|name คุณสามารถดูรายการ action ทั้งหมดได้ในเอกสารอ้างอิง API

ความปลอดภัย: การยืนยันตัวตนสองขั้นตอนและรหัสกู้คืน

ทุกบัญชีแดชบอร์ดบังคับใช้การยืนยันตัวตนสองขั้นตอนด้วย Google Authenticator (TOTP, RFC 6238) เมื่อสมัครคุณจะได้รับรหัสกู้คืนใช้ครั้งเดียว 10 รหัส เก็บไว้ในที่ปลอดภัย หากคุณทำโทรศัพท์หาย สิ่งนี้คือทางเดียวที่จะกลับเข้าระบบได้

รหัสกู้คืนใช้ได้เพียงครั้งเดียวและถูกเก็บแบบแฮชบนเซิร์ฟเวอร์ ในการกู้คืน ใช้ลิงก์ Recover with a recovery code บนหน้าลงชื่อเข้า กระบวนการกู้คืนจะให้คุณตั้งรหัสผ่านใหม่และผูกตัวยืนยันใหม่

ย้ายจาก GA4 หรือ Baidu Tongji

คุณไม่จำเป็นต้องเอาแท็กเดิมออกเพื่อทดลอง 9ping Analytics ทั้งสองแท็กสามารถรันคู่กันและรายงานแยกกันได้ ซึ่งเป็นวิธีที่ปลอดภัยที่สุดในการเปรียบเทียบตัวเลขสักหนึ่งสัปดาห์ก่อนสลับ

ในการย้าย ให้เพิ่มโดเมนของคุณในหน้าจัดการไซต์ วางแท็กบรรทัดเดียวก่อนแท็กปิด body (หรือส่งผ่าน GTM) ดูแผงเรียลไทม์สว่างขึ้น แล้วเอาแท็กเดิมออกเมื่อคุณพร้อม

อีเวนต์กำหนดเองแปลงได้อย่างสะอาด อีเวนต์ของ GA4 ชื่อ signup ที่มีพารามิเตอร์ method และ plan จะกลายเป็น tj('event', 'signup', method, plan) เป้าหมายและ funnel จัดการได้ใน 9ping โดยการแท็กอีเวนต์ที่เกี่ยวข้อง ไม่มีการตั้งค่าเป้าหมายแยกที่ต้องดูแล