タグをインストールする
標準インストールは、計測したい各ページの終了 body タグの前に置く 1 行の非同期スクリプトです。XXXX を「サイト管理」ページに表示される site_id に置き換えてください。
<script async src="https://9ping.dev/hm.min.js" data-sid="XXXX"></script>
Google Tag Manager を使用している場合は、新しいカスタム HTML タグを作成し、同じスニペットを貼り付け、トリガーを All Pages に設定します。
JavaScript を無効にしている訪問者や、メール・AMP のコンテキストでは、noscript タグ内に 1 ピクセル画像のフォールバックを追加してください — 少なくともページビューは取得できます。
<noscript><img src="https://9ping.dev/collect.php?sid=XXXX&type=pv" width="1" height="1" alt=""></noscript>
シングルページアプリ(React、Vue、Next、Nuxt など)の場合、起動時に一度だけスクリプトを注入してください — タグはクライアント側のルート変更ごとに仮想ページビューを自動カウントします。
(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');
自分で制御するルーターでは、tj('pv') を呼び出すことで明示的にページビューを送信できます。タグ読み込み前のクリックについては、初期スタブが呼び出しをキューに入れスクリプト読み込み直後に再生するため、ハンドラを setTimeout で包む必要はありません。
サイト所有権を確認する
高度なレポートを有効にする前に確認することをお勧めします。「サイト管理」では各サイトについて 4 つの相互互換な方法が表示されます — 一番簡単なものを選んでください。
方法 1 — HTML ファイル。ダッシュボードから tj-verify-TOKEN.html をダウンロードし、サイトのルートにアップロードします。
方法 2 — メタタグ。ホームページの head に 1 行のメタタグを貼り付けます。
<meta name="tj-site-verification" content="YOUR_TOKEN">
方法 3 — トラッキングコード。ホームページですでに当社のタグが動作しており、少なくとも 1 回の訪問を受け取っていれば、自動的に確認されます。方法 4 — DNS TXT。tj-site-verification=YOUR_TOKEN をエイペックスドメインの TXT レコードとして追加します。
Open API と一括展開
すべてのアカウントには個人 API キー(プレフィックス tjk_)が付属し、HTTPS 経由でサイト一覧、サイト作成、タグスニペットの取得、統計の読み取りができます。X-API-Key ヘッダーを送信して認証します。
curl -H "X-API-Key: $TJ_KEY" "https://9ping.dev/openapi.php?action=sites"
1 台の Linux マシンからサイトグループ全体にタグを展開するには、「サイト管理」から tj-deploy.sh をダウンロードしてください。API 経由で各ドメインを登録し、タグスニペットを生成し、オプションでテンプレートに注入できます。
Open API は、各行が裸のドメインまたは domain|name のいずれかであるテキストファイルからの一括サイト作成をサポートします。アクションの完全な一覧は API リファレンスで確認できます。
セキュリティ:2 段階認証とリカバリーコード
すべてのダッシュボードアカウントで Google Authenticator(TOTP、RFC 6238)による 2 段階認証が必須です。サインアップ時に 10 個のワンタイムリカバリーコードを受け取ります — 安全な場所に保管してください。電話を紛失した場合、これらが唯一の復帰手段です。
リカバリーコードは 1 回限りの使用で、サーバー上にはハッシュとして保存されます。復旧するには、サインインページの「リカバリーコードで復旧」リンクを使用してください。復旧フローで新しいパスワードを設定し、認証アプリを再バインドできます。
GA4 または Baidu Tongji から移行する
9ping Analytics を試すために既存のタグを削除する必要はありません — 両方のタグを並行して動作させ、それぞれ独立してレポートできます。これは切り替え前の 1 週間、数値を比較する最も安全な方法です。
移行するには、「サイト管理」でドメインを追加し、1 行のタグを終了 body タグの前に貼り付け(または GTM 経由で配信)、リアルタイムパネルが点灯するのを確認し、準備ができたときに古いタグを削除してください。
カスタムイベントはきれいに変換できます:例えば method と plan というパラメータを持つ signup という GA4 イベントは、tj('event', 'signup', method, plan) になります。ゴールとファネルは 9ping では関連イベントにタグを付けることで処理されます。維持すべき別個のゴール設定はありません。