このドキュメントでは、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 |
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'
}
});