ドキュメント

タグをインストールする

標準インストールは、計測したい各ページの終了 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 では関連イベントにタグを付けることで処理されます。維持すべき別個のゴール設定はありません。