gtag() のコマンドは、Google タグ スニペットよりも後であれば、ページ内のどこからでも呼び出すことができます。gtag() には 3 つのコマンドがあります。一般的なプロパティの設定に使用する config と set、そして Google のサービスにデータを送信する event です。
config でサービスを初期化する
特定のサービスのアカウントの初期化と設定を行うには、config コマンドを使用します。コマンドは次のような形式になります。
gtag('config', '<TARGET_ID>', {<additional_config_info>});
<TARGET_ID> はデータ送信先のサービスのアカウント ID で、<additional_config_info> は追加の設定オプションを指定するためのオブジェクト（省略可能）です。
config コマンドを使用すると、gtag.js で処理するサービスとアカウントを指定し、関連する設定を指定できます。TARGET_ID で指定するサービスによっては、config コマンドがそのサービスの特定の動作を開始する場合があります。たとえば、config コマンドは gtag.js にページビュー ヒットを開始するよう指示することがあります。
1 つの Google タグの中で config コマンドを呼び出すのは 1 回だけにしましょう。その後の呼び出しにはすべて set コマンドを使用します。
個々のサービスに関する config コマンドの動作について詳しくは、以下の各サービスのドキュメントをご覧ください。
config コマンドと TARGET_ID だけの最も基本的な例を以下に示します。
gtag('config', '<TARGET_ID>');
<additional_config_info> オブジェクトは省略可能ですが、このオブジェクトでパラメータを指定すると、config コマンドを調整して拡張できます。たとえば、次のパラメータを追加すると、Google アナリティクスのページビューが自動的に送信されるのを妨ぐことができます。
gtag('config', 'TAG_ID', {'send_page_view': false});
event でデータを送信する
event コマンドでは、イベントデータの送信方法を指定できます。たとえば、event コマンドを使用すると、method の値を「Google」に指定して login イベントを送信することができます。
gtag('event', 'login', {
'method': 'Google'
});
個別のコンテキストに役立てていただけるように、推奨イベントと推奨パラメータのセットが用意されています。推奨イベントのリストに含まれていないカスタム イベントを送信することもできます。
set でイベントごとにデータを送信する
set コマンドを使用すると、ページ上のすべての後続イベントに関連付けるパラメータを設定できます。たとえば、サイトのすべてのトランザクションで同じ通貨を使用する場合は、set コマンドを使用して currency フィールドを指定します。
gtag('set', {'currency': 'USD'});
1 つの set コマンドで複数の属性を設定することができます。
gtag('set', {
'country': 'US',
'currency': 'USD'
});