設定

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

allow_google_signals

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

フィールド名	型	デフォルト値
`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
});

campaign_content

A/B テストやコンテンツターゲット広告で使用します。campaign_content を使用して、同じ URL を参照する広告とリンクを区別します。

フィールド名	型	デフォルト値
`campaign_content`	`string`	`undefined`

例

グローバルに設定する

gtag('set', 'campaign_content', 'logolink');

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

gtag('config', 'STREAM_ID', {
  'campaign_content': 'logolink'
});

campaign_id

この参照が参照しているキャンペーンを識別するために使用されます。campaign_id を使用して、特定のキャンペーンを識別できます。

フィールド名	型	デフォルト値
`campaign_id`	`string`	`undefined`

例

グローバルに設定する

gtag('set', 'campaign_id', 'abc.123');

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

gtag('config', 'STREAM_ID', {
  'campaign_id': 'abc.123'
});

campaign_medium

campaign_medium を使用して、メールやクリック単価などのメディアを識別します。

フィールド名	型	デフォルト値
`campaign_medium`	`string`	`undefined`

例

グローバルに設定する

gtag('set', 'campaign_medium', 'cpc');

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

gtag('config', 'STREAM_ID', {
  'campaign_medium': 'cpc'
});

campaign_name

キーワード分析で使用します。campaign_name を使用して、特定商品のプロモーションキャンペーンやまたは戦略的キャンペーンを識別します。

フィールド名	型	デフォルト値
`campaign_name`	`string`	`undefined`

例

グローバルに設定する

gtag('set', 'campaign_name', 'spring_sale');

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

gtag('config', 'STREAM_ID', {
  'campaign_name': 'spring_sale'
});

campaign_source

campaign_source を使用して、検索エンジンやニュースレター名などの参照元を識別します。

フィールド名	型	デフォルト値
`campaign_source`	`string`	`undefined`

例

グローバルに設定する

gtag('set', 'campaign_source', 'google');

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

gtag('config', 'STREAM_ID', {
  'campaign_source': 'google'
});

campaign_term

有料検索で使用します。campaign_term を使用して、有料検索広告のキーワードをトラッキングします。

フィールド名	型	デフォルト値
`campaign_term`	`string`	`undefined`

例

グローバルに設定する

gtag('set', 'campaign_term', 'running+shoes');

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

gtag('config', 'STREAM_ID', {
  'campaign_term': 'running+shoes'
});

campaign

設定可能なすべてのキャンペーン値を含むオブジェクト。

campaign オブジェクトは以前の実装をサポートするためのものであり、ほとんどの場合は推奨されません。代わりに、各フィールドに campaign という接頭辞を付けたバージョンを使用してください。

campaign_id
campaign_source
campaign_medium
campaign_name
campaign_term
campaign_content

フィールド名	型	デフォルト値
`campaign`	`object`	`undefined`

例

グローバルに設定する

gtag('set', 'campaign', {
  'id': 'abc.123',
  'source': 'google',
  'medium': 'cpc',
  'name': 'spring_sale',
  'term': 'running+shoes',
  'content': 'logolink'
});

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

gtag('config', 'STREAM_ID', {
  'campaign': {
    'id': 'abc.123',
    'source': 'google',
    'medium': 'cpc',
    'name': 'spring_sale',
    'term': 'running+shoes',
    'content': 'logolink'
  }
});

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_domain

アナリティクス 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'
});

cookie_expires

ヒットが 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_flags

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

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

例

グローバルに設定する

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

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

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

cookie_path

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

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

例

グローバルに設定する

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

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

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

cookie_prefix

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

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

例

グローバルに設定する

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

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

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

cookie_update

cookie_update を true に設定すると、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
});

ignore_referrer

true に設定すると、参照 URL がトラフィックソースとして表示されなくなります。このフィールドの使用に適したケース

フィールド名	型	デフォルト値
`ignore_referrer`	`boolean`	false

例

グローバルに設定する

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

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

gtag('config', 'STREAM_ID', {
  'ignore_referrer': 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` です。	1,000

例

グローバルに設定する

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` です。	420

例

グローバルに設定する

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` です。	300

例

グローバルに設定する

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 × 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`		256

例

グローバルに設定する

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

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

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

user_properties

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

フィールド名	型	デフォルト値	文字数制限
`user_properties`	`object`		プロパティ名 = 24 プロパティ値 = 36

例

グローバルに設定する

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

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

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