プラグインは、ユーザー インタラクションの測定を支援するために、analytics.jsの機能を強化するスクリプトです。 プラグインは通常、eコマースやクロスドメイン測定など、すべての Google Analytics ユーザーが必要とするわけではない機能に特化しているため、analytics.js にはデフォルトで含まれていません。

このガイドでは、analytics.js のプラグインを要求して使用する方法を説明します。

プラグインの要求

requirega()require コマンドの最終引数として渡すことができます。

以下は完全な require コマンドのシグネチャーです：

ga('require', pluginName, );

例えば、デフォルトのトラッカーで使用するために Enhanced Ecommerce プラグインを要求する方法です。

ga('require', 'ec');

また、「myTracker」という名前のトラッカー用にAdvertising Featuresプラグインを要求し、デフォルトのCookie名の値をオーバーライドする設定オプションを渡す方法は次のとおりです。

ga('myTracker.require', 'displayfeatures', { cookieName: 'display_features_cookie'});

プラグイン コードのロード

requirega() コマンド キューで使用するプラグイン メソッドを初期化しますが、プラグイン スクリプト自体はロードしません。

プラグインのコードをページに追加するには、<script>async 属性を設定して、サイトの他の機能の読み込みをブロックしないようにする方法が推奨されます。

次のコードは、仮想的なリンク トラッキング プラグインを要求し、ロードします。

analytics.jsライブラリとanalytics.jsプラグインの両方が非同期的にロードされるため、プラグインが完全にロードされて使用できる状態になったことを知るのは困難です。

analytics.jsライブラリは、まだロードされていないプラグインに対するrequireコマンドに遭遇したときに、コマンドキューの実行を停止することでこの問題を解決します。

そのため、使用しているプラグインをテストして、正しくロードされ、実行されることを確認することが非常に重要です。

プラグインのメソッドの呼び出し

プラグインを要求すると、そのメソッドは ga() コマンド キューで使用できるようになります。

ga('methodName', ...args);

例えば、Enhanced Ecommerce プラグインの addProduct メソッドは次のように呼び出すことができます。

ga('ec:addProduct', { 'id': 'P12345', 'quantity': 1});

または、コマンド文字列にトラッカー名を追加することで、名前の付いたトラッカー上で次のように呼び出されます：

ga('myTracker.ec:addProduct', { 'id': 'P12345', 'quantity': 1});

このセクションのすべてのガイドをお読みになった方は、analytics.jsのほとんどの機能に精通しているはずです。jsを使用しています。 次のガイドでは、より簡単にエラーを検出し、コードが何をしているかを正確に確認するために、analytics.js の実装をデバッグする方法について説明します。