Dokumentasi

Pasang teg

Pemasangan standard ialah satu skrip async sebelum teg body penutup setiap halaman yang ingin anda ukur. Gantikan XXXX dengan site_id yang ditunjukkan pada halaman Urus tapak anda.

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

💡 Buka tapak anda, kemudian semak papan pemuka — Dalam talian sekarang dan Paparan halaman sepatutnya naik dalam beberapa saat.

Jika anda menggunakan Google Tag Manager, cipta teg Custom HTML baharu, tampal coretan yang sama, dan tetapkan pencetus kepada All Pages.

Untuk pelawat dengan JavaScript dinyahdayakan atau untuk konteks e-mel dan AMP, tambah sandaran imej satu piksel di dalam teg noscript — anda akan sekurang-kurangnya menangkap paparan halaman.

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

Untuk aplikasi satu halaman (React, Vue, Next, Nuxt dan rakan-rakan) suntik skrip sekali pada but — teg secara automatik mengira paparan halaman maya pada setiap perubahan laluan sisi pelanggan.

(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);})();

Peristiwa tersuai

Setelah teg dimuatkan, fungsi global window.tj tersedia untuk peristiwa ad-hoc seperti klik butang, penghantaran borang dan muat turun. Tandatangannya ialah kategori, tindakan, label.

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

Untuk penghala yang anda kawal sendiri, anda boleh mencetus paparan halaman eksplisit dengan memanggil tj('pv'). Untuk klik sebelum teg, stub awal akan beratur panggilan dan memainkannya semula sebaik sahaja skrip dimuatkan, jadi anda tidak perlu membalut pengendali anda dalam setTimeout.

Sahkan pemilikan tapak

Pengesahan disyorkan sebelum anda menghidupkan laporan lanjutan. Urus tapak menyenaraikan empat kaedah yang boleh ditukar ganti untuk setiap tapak — pilih mana yang paling mudah.

Kaedah satu — fail HTML. Muat turun tj-verify-TOKEN.html dari papan pemuka dan muat naiknya ke root tapak anda.

Kaedah dua — teg meta. Tampal satu teg meta ke dalam head halaman utama anda.

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

Kaedah tiga — kod penjejakan. Jika halaman utama sudah menjalankan teg kami dan telah menerima sekurang-kurangnya satu lawatan, ia disahkan secara automatik. Kaedah empat — DNS TXT. Tambah tj-site-verification=YOUR_TOKEN sebagai rekod TXT pada domain apex.

Open API dan penggunaan pukal

Setiap akaun disertakan dengan kunci API peribadi (awalan tjk_) yang membolehkan anda menyenaraikan tapak, mencipta tapak, menarik coretan teg dan membaca statistik melalui HTTPS. Sahkan dengan menghantar pengepala X-API-Key.

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

Untuk menyebarkan teg merentas seluruh kumpulan tapak dari satu kotak Linux, muat turun tj-deploy.sh dari Urus tapak. Ia mendaftarkan setiap domain melalui API, menjana coretan teg, dan boleh secara pilihan menyuntiknya ke dalam templat anda.

Open API menyokong penciptaan tapak secara pukal daripada fail teks, di mana setiap baris ialah samada domain biasa atau domain|nama. Anda boleh menemui senarai tindakan penuh dalam rujukan API.

Keselamatan: pengesahan 2 langkah dan kod pemulihan

Semua akaun papan pemuka mempunyai pengesahan 2 langkah yang dikuatkuasakan dengan Google Authenticator (TOTP, RFC 6238). Semasa pendaftaran anda menerima sepuluh kod pemulihan sekali guna — simpan di tempat yang selamat; jika anda kehilangan telefon, inilah satu-satunya cara untuk kembali masuk.

Kod pemulihan adalah sekali guna dan disimpan sebagai cincangan pada pelayan. Untuk memulihkan, gunakan pautan Pulihkan dengan kod pemulihan pada halaman log masuk; aliran pemulihan akan membenarkan anda menetapkan kata laluan baharu dan mengikat semula authenticator.

Berhijrah dari GA4 atau Baidu Tongji

Anda tidak perlu mengalih keluar teg sedia ada untuk mencuba 9ping Analytics — kedua-dua teg boleh berjalan bersebelahan dan melapor secara bebas, yang merupakan cara paling selamat untuk membandingkan angka selama seminggu sebelum anda bertukar.

Untuk berhijrah, tambah domain anda di Urus tapak, tampal teg satu baris sebelum teg body penutup (atau hantar melalui GTM), perhatikan panel masa nyata menyala, dan alih keluar teg lama bila-bila masa anda bersedia.

Peristiwa tersuai diterjemah dengan kemas: peristiwa GA4 bernama, contohnya, signup, dengan parameter method dan plan, menjadi tj('event', 'signup', method, plan). Matlamat dan corong dikendalikan dalam 9ping dengan menandakan peristiwa berkenaan; tiada konfigurasi matlamat berasingan untuk diselenggara.