ドキュメントスニペット

02 · インストール

すべてのページの head にタグを 1 つ

ページにタグを 1 つ貼り付けると、Tally が訪問、流入元、エンゲージメント時間、ゴール、外部リンクのクリックを数え、チェックアウトで渡す訪問者 ID も用意します。

01タグ

<script> タグ 1 つですべてが動きます。サイズは約 3 KB で、依存関係はなく、defer で読み込まれるため、ページの表示を遅らせることはありません。

HTML
<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 と Viteindex.html の <head> 内に置きます。アプリのすべてのルートで共有されます。
WordPressクラシックテーマの header.php の </head> の直前か、ヘッダーコード用のプラグインに入れます。
WebflowSite settings › Custom code › Head code に入れて、公開します。
FramerSite 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 までお知らせください。