構成

このドキュメントでは、GA4 のすべての構成フィールドについて説明します。

allow_google_signals

広告向けの機能をすべて無効にするには、allow_google_signalsfalse に設定します。

フィールド名 デフォルト値
allow_google_signals boolean true

グローバルに設定する

gtag('set', 'allow_google_signals', true);

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'allow_google_signals': true
});

allow_ad_personalization_signals

広告のパーソナライズ機能を無効にするには、false に設定します。

フィールド名 デフォルト値
allow_ad_personalization_signals boolean true

グローバルに設定する

gtag('set', 'allow_ad_personalization_signals', true);

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'allow_ad_personalization_signals': true
});

client_id

ブラウザのインスタンスを匿名で識別します。デフォルトでは、この値はファーストパーティのアナリティクス Cookie として 2 年間の有効期限付きで保管されます。

フィールド名 デフォルト値
client_id string ユーザーごとにランダムに生成された値。

グローバルに設定する

gtag('set', 'client_id', 'aaa.bbb');

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'client_id': 'aaa.bbb'
});

content_group

フィールド名 デフォルト値
content_group string

グローバルに設定する

gtag('set', 'content_group', '/news/sports');

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'content_group': '/news/sports'
});

アナリティクス Cookie の保管に使用するドメインを指定します。

ドメインを指定せずに Cookie を設定するには、'none' に設定します。

Cookie をトップレベル ドメインと 1 つのサブドメイン(eTLD +1)にドメイン指定するには、'auto'(デフォルト値)に設定します。たとえば、cookie_domain'auto' に設定されている場合、https://example.com はドメインに example.com を使用し、https://subdomain.example.com もドメインに example.com を使用します。

フィールド名 デフォルト値
cookie_domain string 'auto'

グローバルに設定する

gtag('set', 'cookie_domain', 'example.com');

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'cookie_domain': 'example.com'
});

ヒットが Google アナリティクスに送信されるたびに、Cookie の有効期限はその時点の時刻と cookie_expires フィールドの値を足した値に更新されます。 つまり、デフォルト値の 2 年(63,072,000 秒)を使用しており、ユーザーが毎月サイトを訪問する場合、Cookie が期限切れになることはありません。

cookie_expires を 0(ゼロ)秒に設定すると Cookie がセッション ベースになり、現在のブラウザ セッションが終了した時点で期限切れとなります。

フィールド名 デフォルト値
cookie_expires number 63072000

グローバルに設定する

gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'cookie_expires': 28 * 24 * 60 * 60 /* 28 days, in seconds */
});

設定時に Cookie に追加フラグを付加します。フラグはセミコロンで区切る必要があります。設定するフラグの例については、新しい Cookie を作成するをご覧ください。

フィールド名 デフォルト値
cookie_flags string

グローバルに設定する

gtag('set', 'cookie_flags', 'SameSite=None;Secure');

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'cookie_flags': 'SameSite=None;Secure'
});

アナリティクス Cookie の保管に使用するサブパスを指定します。

フィールド名 デフォルト値
cookie_path string '/'

グローバルに設定する

gtag('set', 'cookie_path', '/example_path');

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'cookie_path': '/example_path'
});

アナリティクス Cookie の名前の先頭に付加する接頭辞を指定します。

フィールド名 デフォルト値
cookie_prefix string

グローバルに設定する

gtag('set', 'cookie_prefix', 'prefix');

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'cookie_prefix': 'prefix'
});

cookie_updatetrue に設定すると、gtag.js はページが読み込まれるたびに Cookie を更新します。つまり、サイトへの最新の訪問に基づいて Cookie の有効期限が更新されます。たとえば、Cookie の有効期限が 1 週間に設定されており、ユーザーが 5 日ごとに同じブラウザを使用して訪問した場合、Cookie の有効期限は訪問ごとに更新されるため、有効期限は実質的に切れることがなくなります。

false に設定すると、Cookie はページの読み込みごとには更新されません。つまり、ユーザーが最初にサイトにアクセスしたときに基づいて Cookie の有効期限が決まります。

フィールド名 デフォルト値
cookie_update boolean true

グローバルに設定する

gtag('set', 'cookie_update', true);

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'cookie_update': true
});

language

ユーザーの言語設定を指定します。デフォルトは、ユーザーの navigator.language 値です。

フィールド名 デフォルト値
language string デフォルト値は navigator.language です。

グローバルに設定する

gtag('set', 'language', 'en-us');

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'language': 'en-us'
});

page_location

ページの完全な URL を指定します。デフォルトは、ユーザーの document.location 値です。

フィールド名 デフォルト値
page_location string デフォルト値は document.location です。

グローバルに設定する

gtag('set', 'page_location', 'https://example.com/page1');

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'page_location': 'https://example.com/page1'
});

page_referrer

ページにトラフィックを送り込んだ参照ソースを指定します。この値はトラフィック ソースの算出にも使用され、値の形式は URL となります。 デフォルトは、ユーザーの document.referrer 値です。

フィールド名 デフォルト値
page_referrer string デフォルト値は document.referrer です。

グローバルに設定する

gtag('set', 'page_referrer', 'https://example.com');

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'page_referrer': 'https://example.com'
});

page_title

ページまたはドキュメントのタイトルです。デフォルトは、ユーザーの document.title 値です。

フィールド名 デフォルト値
page_title string デフォルト値は document.title です。

グローバルに設定する

gtag('set', 'page_title', 'Settings');

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'page_title': 'Settings'
});

send_page_view

false に設定すると、デフォルトのスニペットが page_view を送信できなくなります。

フィールド名 デフォルト値
send_page_view boolean true

グローバルに設定する

gtag('set', 'send_page_view', false);

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'send_page_view': false
});

screen_resolution

画面の解像度を指定します。x で区切られた 2 つの正の整数にする必要があります。たとえば、800 x 600 ピクセルの画面の場合、値は 800x600 になります。ユーザーの window.screen 値から計算されます。

フィールド名 デフォルト値
screen_resolution string デフォルト値は window.screen から計算されます

グローバルに設定する

gtag('set', 'screen_resolution', '800x600');

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'screen_resolution': '800x600'
});

user_id

サイトの所有者またはライブラリの利用者により提供された、ユーザーの既知の識別子を指定します。ユーザー ID として個人情報を使うことはできません。また、Google アナリティクス Cookie など、アナリティクスのストレージにこの値を残すことはできません。

フィールド名 デフォルト値
user_id string

グローバルに設定する

gtag('set', 'user_id', 'id');

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'user_id': 'id'
});

user_properties

ユーザー プロパティとは、言語設定や地域など、ユーザーベースのセグメントを表現するのに使用される属性を指します。プロジェクトごとに、最大 25 個のユーザー プロパティを追加設定できます。

フィールド名 デフォルト値
user_properties object

グローバルに設定する

gtag('set', 'user_properties', {
  'favorite_color': 'blue'
});

単一のストリームに設定する

gtag('config', 'STREAM_ID', {
  'user_properties': {
    'favorite_color': 'blue'
  }
});