Google アナリティクスのイベントをトラッキングする

このページでは、gtag.js を使用して Google アナリティクスのイベントを送信する方法を説明します。

イベントを送信する

トラッキング スニペットが追加されたページのイベントを送信するには、次の構文で gtag.js の event コマンドを使用します。

gtag('event', <action>, {
  'event_category': <category>,
  'event_label': <label>,
  'value': <value>
});
  • <action> は、Google アナリティクスのイベント レポートでイベント アクションとして表示される文字列です。
  • <category> は、イベントのカテゴリとして表示される文字列です。
  • <label> は、イベントのラベルとして表示される文字列です。
  • <value> は、イベントの値(価値)として表示される 0 以上の整数です。

次の例では、アクション「xyz」、デフォルト カテゴリ「general」、デフォルト ラベル「(not set)」の Google アナリティクス イベントが送信されます。

gtag('event', 'xyz');

デフォルトのパラメータ値を、コードで独自の値を割り当てることでオーバーライドします。次の例では、アクション「aaa」、カテゴリ「bbb」、ラベル「ccc」の Google アナリティクス イベントが送信されます。

gtag('event', 'aaa', {
  'event_category' : 'bbb',
  'event_label' : 'ccc'
});

詳細: Google アナリティクス イベントのパラメータのさまざまな要素(カテゴリ、アクション、ラベル、値)

デフォルトの Google アナリティクス イベント

通常は、デフォルトの Google アナリティクス イベントを使用することをおすすめします。デフォルトのイベントには、デフォルトのカテゴリやラベルがあらかじめ設定されています。これらのイベントを使用することで、レポートの一貫性や将来実装される機能との相互運用性を確保しやすくなります。

次の例では、アクション「login」、カテゴリ「engagement」、ラベル「Google」の Google アナリティクス イベントが送信されます。

gtag('event', 'login', { method : 'Google' });

次の表は、デフォルトの Google アナリティクス イベントと、各イベントのデフォルトのカテゴリ、デフォルトのラベルタイプ(利用できる場合)を示したものです。表に記載のないイベント(例: 自作したイベントなど)については、デフォルトのカテゴリは「engagement」、デフォルトのラベルは「not set」となります。

イベント名 デフォルトのカテゴリ デフォルトのラベルタイプ
add_payment_info ecommerce  
add_to_cart ecommerce  
add_to_wishlist ecommerce  
begin_checkout ecommerce  
checkout_progress ecommerce  
generate_lead engagement  
login engagement method
purchase ecommerce  
refund ecommerce  
remove_from_cart ecommerce  
search engagement search_term
select_content engagement content_type
set_checkout_option ecommerce  
share engagement method
sign_up engagement method
view_item engagement  
view_item_list engagement  
view_promotion engagement  
view_search_results engagement search_term

非インタラクション イベントを送信する

非インタラクション イベントを送信するには、non_interaction パラメータを true に設定します。たとえば次のようになります。

gtag('event', 'video_auto_play_start', {
  'event_label': 'My promotional video',
  'event_category': 'video_auto_play',
  'non_interaction': true
});