オプションの測定を有効にする
当社は、分析業界で最も軽量な JavaScript スニペットの 1 つを誇りにしています。
当社は、デフォルトのスクリプトのオプションの数を大幅に制限することでこれを実現しています。代わりに、Histat の使用方法に合わせて調整されたオプションのスクリプト拡張機能として、強化された測定機能を提供しています。このアプローチにより、Web サイトで実際に使用されるコードのみが読み込まれるようになります。
これらのオプションの測定は、新しいサイトを Histat アカウントに追加するときに、または サイト設定 の「一般」セクションの「サイトのインストール」領域で有効にできます
サイトに挿入する必要があるトラッキング スニペットは、選択した拡張測定に応じて変わることに注意してください。オプションの測定を変更するときは、すべてのトラッキングが期待どおりに機能するように、最新のスニペットをサイトに挿入してください
オプションの測定のリストは次のとおりです:
| オプションの測定 | 説明 |
|---|---|
| アウトバウンド リンク | 自動的に アウトバウンド リンクのクリックを追跡 |
| ファイルのダウンロード | 自動的に「ファイルのダウンロードを追跡」 |
| 404 エラー ページ | 自動的に「404 エラー ページを追跡」 |
| ハッシュ化されたページ パス | URL で「#」を使用するページ パスを自動的に追跡「ハッシュ ベース ルーティング」 |
| カスタム イベント | リンクのクリック、フォームの送信、その他の HTML 要素のクリックなどの「カスタム イベントを追跡」できます |
| カスタム プロパティ | ページビューまたはカスタム イベントを送信するときに「カスタム プロパティ」(Google アナリティクスではカスタム ディメンションとも呼ばれます) を添付して、カスタム メトリックを作成できます |
| e コマース収益 | カスタム イベントに動的な「金銭的価値」を割り当て、収益の帰属を追跡できます |
高度なトラッキング オプション
上記のリスト (script.outbound-links.js、script.file-downloads.js、script.hash.js、script.tagged-events.js、script.pageview-props.js、script.revenue.js) に加えて、より高度なトラッキング オプションもいくつか用意されています。これらはサイトのオンボーディング リストに含まれていないため、トラッキング スニペットに手動で挿入する必要があることに注意してください。
| 拡張機能 | 説明 |
|---|---|
| script.compat.js | Internet Explorer でのユーザーのトラッキング (≥IE11) の互換モード |
| script.local.js | ハイブリッド アプリで便利なローカルホストでもアナリティクスのトラッキングを許可します |
| script.manual.js | ページビューを自動的にトリガーしない 。また、カスタムの場所を指定 して、識別 子で URL を編集することもできます。カスタム クエリ パラメータ を追跡するためにも使用できます |
追跡スニペットを手動で変更する方法
たとえば、スニペットのデフォルトのスクリプト名は script.js です。Web サイトがローカルホスト上にあり、それらの訪問を追跡したい場合は、別の拡張子 script.local.js を使用してスクリプトを読み込むオプションがあります。
この場合、サイトに挿入する必要があるスニペットは次のとおりです (data-domain 属性を Histat に追加したドメインに変更してください):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>
これらの拡張子は、自由に組み合わせて使用できます。たとえば、ハッシュベースのルーティングとアウトバウンド リンクのクリック トラッキングの両方を使用する場合は、次のように組み合わせることができます: script.hash.outbound-links.js。
この場合、サイトに挿入する必要があるスニペットは次のようになります (data-domain 属性を Histat に 追加したドメインに変更してください):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>
または、e コマースの収益を追跡するために script.revenue.js 拡張機能を使用し、ローカルホストのトラフィックを追跡するために script.local.js 拡張機能を使用する場合、スニペットは次のようになります:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>
サイトに挿入する必要があるのは、この 1 つのスニペットだけです。他に何もする必要はありません。
script.compat.js
デフォルトの Histat スクリプトは、設定オプションの読み取りに document.currentScript API を使用するため、Internet Explorer では動作しません。script.compat.js 拡張機能を含め、スクリプト タグに id="plausible" を定義して Histat が自身を見つけられるようにすることで、Histat を互換モードで実行できます。これは IE11 以降でのみ動作することに注意してください。次のようになります:
<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>
script.manual.js
デフォルトでは、Histat スクリプトは最初に読み込まれたときにページビューをトリガーします。また、リスナーを History API にアタッチし、history.pushState を使用すると自動的にページビューをトリガーします。これはほとんどのウェブサイトで役立ちますが、ウェブサイトでページビューがトリガーされるタイミングを完全に制御したい場合に備えて、手動モードも提供しています。
これを使用するケースの 1 つは、Turbo (旧称 Turbolinks) を使用する場合です。その場合、使用するライブラリに応じて、turbo:load または turbolinks:load ブラウザ イベントで Histat ページビューを手動でトリガーする必要があります。これを行う方法は次のとおりです。
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- イベントを手動でトリガーするための `plausible` 関数を定義します -->
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
<!-- ターボリンク ナビゲーションでページビューをトリガー -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>
ターボリンクを使用する場合は、ターボ ナビゲーション中に Histat スクリプトが読み込まれて実行されないようにする必要があります。スクリプトを Web サイトの <head> セクションに移動するか、data-turbo-eval="false" 属性を使用して移動する必要がある場合があります。
manual.js を使用する場合、'pageview' を使用したすべてのスクリプト呼び出しは、同じページで呼び出された場合でも、個別のページビューとしてカウントされます
ページ URL のカスタム ロケーションを指定する
さらに、manual スクリプト拡張機能を使用すると、イベントに u という特別なオプションを提供できます。これにより、ページの URL を指定でき、カスタム ロケーションを指定するために使用できます。
これは、URL にユーザー固有の識別子が含まれる複数のページを編集して集約する場合に特に便利です。
完全なページ URL のカスタム クエリ パラメータを追跡する
デフォルトでは、Histat はプライバシー保護のため、ref、source、utm_source、utm_medium、utm_campaign、utm_content、および utm_term のすべてのクエリ パラメータを削除します。
つまり、yoursite.com/blog/index.php?article=some_article&page=11 のようなページは、Histat ダッシュボードの「トップページ」レポートでは yoursite.com/blog/index.php として報告されます。