02 · インストール
すべてのページの head にタグを 1 つ
ページにタグを 1 つ貼り付けると、Tally が訪問、流入元、エンゲージメント時間、ゴール、外部リンクのクリックを数え、チェックアウトで渡す訪問者 ID も用意します。
01タグ
<script> タグ 1 つですべてが動きます。サイズは約 3 KB で、依存関係はなく、defer で読み込まれるため、ページの表示を遅らせることはありません。
<script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script>あなたのサイト専用のタグは、サイトを追加するときのスニペットの手順と、そのサイトの Setup ページにあり、data-site にサイトの ID が入っています。Cookie なしまたは同意優先で計測するサイトでは、タグにモードも入ります。
<script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script><script defer data-site="k3xq2mfa7twp" data-mode="cookieless" src="https://t.tallybyoutpost.com/script.js"></script><script defer data-site="k3xq2mfa7twp" data-mode="consent" src="https://t.tallybyoutpost.com/script.js"></script>タグが読み取るすべての属性はスクリプトの設定にあります。
02プラットフォームごとの設置場所
| プラットフォーム | 場所 |
|---|---|
| HTML | すべてのページの <head> に貼り付けます。 |
| Next.js | ルートレイアウトの app/layout.tsx の <head> 内に置きます。 |
| React と Vite | index.html の <head> 内に置きます。アプリのすべてのルートで共有されます。 |
| WordPress | クラシックテーマの header.php の </head> の直前か、ヘッダーコード用のプラグインに入れます。 |
| Webflow | Site settings › Custom code › Head code に入れて、公開します。 |
| Framer | Site settings › General › Custom code の <head> タグの末尾に入れて、公開します。 |
| Shopify | 手作業で入れる場所はありません。Tally のアプリが、テーマエディタでオンにするテーマアプリ埋め込みからタグを追加するので、テーマのコードは不要です。アプリの掲載は審査中です。 |
シングルページアプリでも、ほかに必要なものはありません。アプリが移動する各ルートが、それぞれ 1 つのページビューになります。
03送信する内容
- ページビュー:ページの読み込み時に 1 回、その後はシングルページアプリのルートごとに 1 回(
pushState、replaceState、戻るボタン)。クエリやハッシュだけの変更は、タグにdata-hashがない限り新しいページになりません。 - エンゲージメント時間とスクロール深度:ページが表示されていて、直近 30 秒以内に操作があった間の時間を数えます。ページが非表示になったときや離れたとき、また計測中は 30 秒ごとに送信します。
- ゴール:コードまたは
data-tally-goal属性から(ゴールと identify)。 - 外部サイトへのリンクのクリック:ブラウザがページを離れるときに、クリックを遅らせずに送信します。
- 購入者の照合に使うメールアドレス:ページが identify を呼び出したときに送信します。
イベントは JSON として、スクリプトと同じアドレスの /api/event に Cookie なしで送られます。スクリプトがページにエラーを投げることも、ページ遷移を遅らせることもありません。
04動作を確認する
05数えられないもの
足りない情報や、実際の画面と違う点はありませんか? どのページかを添えて support@tallybyoutpost.com までお知らせください。