analytics.js から gtag.js に移行する（ユニバーサル アナリティクス）

このガイドでは、既存の analytics.js ユニバーサル アナリティクスの実装を移行して gtag.js を使用するためのプロセスについて説明します。

概要

analytics.js には、Google アナリティクスにデータを送信するための主要なメカニズムが 2 つあります。

1. トラッカー

   トラッカーは、測定するプロパティを指定します。

2. ヒットタイプ

   ヒットタイプは、測定するインタラクションのタイプを指定します。

gtag.js では、config コマンドを使用するか、コマンドに対するパラメータとして、プロパティが指定されます。

analytics.js とは異なり、gtag.js では、Google アナリティクスへのデータの送信にトラッカーを使用しません。代わりに、config コマンドで設定した ID で識別される Google アナリティクス プロパティにデータを送信します。gtag.js に提供されるイベント名で、Google アナリティクスに送信されるデータの種類を指定します。

analytics.js から gtag.js に移行するには、サイトのすべてのページに対して次の操作を行います。

• analytics.js のスニペットを gtag.js スニペットに置き換えます。

• 次の処理について、analytics.js コードを同等の gtag.js コードに置き換えます。

  • ページビューの測定
  • イベントの測定
  • カスタム ディメンションとカスタム指標の送信
  • カスタム速度の測定
  • 例外の測定

analytics.js のスニペットを gtag.js スニペットに置き換える

ウェブページの analytics.js スニペットを見つけます。

<!-- Google Analytics -->
<script>
  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');

  ga('create', 'TAG_ID', 'auto');
  ga('send', 'pageview');
</script>
<!-- End Google Analytics -->

これを次の gtag.js スニペットに置き換えます。

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'TAG_ID');
</script>

注: TAG_ID は、実際のタグ ID に置き換えてください。

ページビューの測定

analytics.js は、トラッカーを使用してページビューを Google アナリティクスに送信します。トラッカーには、Google アナリティクス プロパティの測定 ID が設定されています。gtag.js は、config コマンドで指定された TAG_ID で識別される Google アナリティクス プロパティにページビューを送信します。

デフォルトのトラッカーでページビューを測定する

次のように、デフォルトのトラッカーを使用して Google アナリティクスにページビューを送信（send）している analytics.js コードを見つけて削除します。

// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');

// Uses the default tracker to send a pageview to the
// Google Analytics property with tag ID of 'TAG_ID'.
ga('send', 'pageview');

gtag.js スニペットに含まれる次のコードは、タグ ID が TAG_ID の Google アナリティクス プロパティにページビューを自動的に送信します。

gtag('config', 'TAG_ID');

指定したトラッカーでページビューを測定する

次のコードは、指定したトラッカーを使用して Google アナリティクスにページビューを送信する analytics.js のコードです。

ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'pageview');

これを次の gtag.js event コマンドに置き換えます。

gtag('event', 'page_view', { 'send_to': 'TAG_ID' });

イベントの測定

前述のとおり、analytics.js はトラッカーを使用して Google アナリティクスにイベントを送信します。トラッカーには、Google アナリティクス プロパティのトラッキング ID が設定されています。一方、gtag.js は config コマンドで指定された TAG_ID で識別される Google アナリティクス プロパティにイベントを送信します。

デフォルトのトラッカーでイベントを測定する

次のように、デフォルトのトラッカーを使用して Google アナリティクスにイベントを送信（send）している analytics.js コードを見つけます。

ga('create', 'TAG_ID', 'auto');
ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

それらすべてを、次の gtag.js event コマンドに置き換えます。

gtag('event', eventName, eventParameters);

eventName は、ログに記録するイベントの名前です。

注: gtag.js では、Google アナリティクス イベントのカテゴリとラベルにデフォルト値が設けられています。

例:

analytics.js:

// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');

// Uses the default tracker to send the event to the
// Google Analytics property with a tag ID of `TAG_ID`.
ga('send', 'event', 'Videos', 'play', 'Fall Campaign');

gtag.js:

// Sends the event to the Google Analytics property with a
// tag ID of `TAG_ID` set by the config command in
// the gtag.js snippet.
gtag('event', 'play', {
  'event_category': 'Videos',
  'event_label': 'Fall Campaign'
});

指定したトラッカーでイベントを測定する

次のコードは、指定したトラッカーを使用して Google アナリティクスにイベントを送信する analytics.js のコードです。

ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

これを次の gtag.js event コマンドに置き換えます。

gtag('event', eventName, {
  'send_to': 'TAG_ID',
  'parameter1': 'value1',
  'parameter2': 'value2',
  // ...
});

例:

analytics.js:

// Creates a tracker named <b>clientTracker</b>.
ga('create', 'TAG_ID', 'auto', 'clientTracker');

// Uses tracker clientTracker to send the event to the
// Google Analytics property with a tag ID of TAG_ID.
ga('clientTracker.send', 'event', 'Videos', 'play', 'Fall Campaign');

gtag.js:

// Send the event to the Google Analytics property
// with a tag ID of 'TAG_ID'.
gtag('event', 'play', {
  'send_to': 'TAG_ID',
  'event_category': 'Videos',
  'event_label': 'Fall Campaign'
});

カスタム ディメンションとカスタム指標の送信

ウェブページで、Google アナリティクスにカスタム ディメンションを送信する analytics.js send コマンドを見つけます。

ga('send', 'hitType', { 'dimension<Index>':  'dimension_value'});

それらすべてを、次の gtag.js コードに置き換えます。

gtag('config', 'TAG_ID', {
  'custom_map': {'dimension<Index>': 'dimension_name'}
});
gtag('event', 'any_event_name', {'dimension_name': 'dimension_value'});

TAG_ID は、ご自分の Google アナリティクス ID に置き換えてください。

ウェブページで、Google アナリティクスにカスタム指標を送信する analytics.js send コマンドを見つけます。

ga('send', 'hitType', { 'metric<Index>':  'metric_value'});

それらすべてを、次の gtag.js コードに置き換えます。

gtag('config', 'TAG_ID', {
  'custom_map': {'metric<Index>': 'metric_name'}
});
gtag('event', 'any_event_name', {'metric_name': 'metric_value'});

TAG_ID は実際のタグ ID に置き換えてください。

カスタム速度の測定

ウェブページで、カスタム指標を測定する analytics.js send コマンドを見つけます。

ga('send', 'timing', 'timingCategory', 'timingVar', timingValue, 'timingLabel');

それらすべてを、次の gtag.js event コマンドに置き換えます。

gtag('event', 'timing_complete', {
  'name': 'timingVar',
  'value': timingValue,
  'event_category': 'timingCategory',
  'event_label': 'timingLabel'
});

例外の測定

ウェブページで、Google アナリティクスに例外を測定する analytics.js send コマンドを見つけます。

ga('send', 'exception', {
  'exDescription': 'error_message',
  'exFatal': false  // set to true if the exception is fatal
});

それらすべてを、次の gtag.js event コマンドに置き換えます。

gtag('event', 'exception', {
  'description': 'error_message',
  'fatal': false  // set to true if the exception is fatal
});

analytics.js のフィールドを gtag.js のパラメータにマッピングする

次の表は、analytics.js のフィールドを対応する gtag.js のパラメータにマッピングしています。

イベント

analytics.js のフィールド	gtag.js のパラメータ
eventAction	event_action
eventCategory	event_category
eventLabel	event_label
eventValue	value

カスタム ディメンションとカスタム指標

analytics.js のフィールド	gtag.js のパラメータ
dimension<Index>	dimension<Index>
metric<Index>	metric<Index>

<Index> は、カスタム ディメンションまたはカスタム指標のインデックスを表す負ではない整数です。

カスタム速度

analytics.js のフィールド	gtag.js のパラメータ
timingCategory	event_category
timingLabel	event_label
timingValue	value
timingVar	name

例外測定

analytics.js のフィールド	gtag.js のパラメータ
exDescription	description
exFatal	fatal

拡張 e コマースの行動データ

analytics.js のフィールド	gtag.js のパラメータ
id	transaction_id
affiliation	affiliation
revenue	value
tax	tax
shipping	shipping
coupon	coupon
list	list_name
step	checkout_step
option	checkout_option

プロモーション データ

analytics.js のフィールド	gtag.js のパラメータ
creative	creative_name
position（インプレッション、商品）	list_position
position（プロモーション）	creative_slot

商品アクションとプロモーション アクション

analytics.js のフィールド	gtag.js のイベント
add	add_to_cart
checkout（最初の手順）	begin_checkout
checkout（後続のステップ）	checkout_progress
checkout_option	set_checkout_option
click	select_content（プロモーションなし）
detail	view_item
promo_click	select_content（プロモーションあり）
purchase	purchase
refund	refund
remove	remove_from_cart

クライアント ID とユーザー ID

analytics.js のフィールド	gtag.js のパラメータ
clientId	client_id
userId	user_id