gtag.js ライブラリでは、複数のブラウジング セッションをまたいでユニーク ユーザーを識別するために Cookie を使用します。このページでは、Cookie の設定をカスタマイズする方法について説明します。
Cookie のフィールドを設定する
次の表に、gtag.js で使用される Cookie フィールドのデフォルト値を示します。
フィールド名 | 値の型 | デフォルト値 |
---|---|---|
cookie_domain |
文字列 | 自動 |
cookie_expires |
整数 | アナリティクスの場合: 63072000(2 年間(秒単位))。コンバージョンの場合: 7776000(90 日間(秒単位))。 |
cookie_prefix |
文字列 | コンバージョンの場合: _gcl。注: アナリティクスの Cookie では、デフォルトのプレフィックスは使用されません。 |
cookie_update |
ブール値 | true |
これらの値を変更するには、gtag の config
コマンドにあるパラメータ リストで値を指定します。例:
gtag('config', '<TARGET_ID>', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 days, in seconds
});
Cookie ドメインの設定
gtag.js では、Cookie ドメインの自動設定がデフォルトで有効になっています。有効にすると、できる限り上位のドメインに Cookie が設定されます。たとえば、ウェブサイト アドレスが blog.example.com
の場合、Cookie は gtag.js によって example.com
ドメインに設定されます。サーバーがローカル環境(例: localhost
)で実行されていることが検出されると、cookie_domain
は自動的に none
に設定されます。この場合は、ドキュメントの場所の完全なドメインを使って Cookie が設定されます。
Cookie ドメインの自動設定を無効にするには、config
に cookie_domain
パラメータを追加します。
gtag('config', '<TARGET_ID>', {
'cookie_domain': 'blog.example.com'
});
Cookie プレフィックス
他の Cookie との競合を避けるために、Cookie プレフィックスの変更が必要となる場合があります。たとえば、このコードでは Cookie 名の先頭に「example
」が追加されます(example_ga
、example_aw
など)。
gtag('config', '<TARGET_ID>', {
cookie_prefix: 'example'
});
Cookie の有効期限
ページが読み込まれると、Cookie の有効期限はその時点の時刻と cookie_expires
フィールドの値を足した値に更新されます。つまり、cookie_expires
が 1 週間に設定されていて、ユーザーが 5 日以内に同じブラウザを使用してページを再訪問した場合、Cookie はその時点からさらに 1 週間利用可能になり、そのユーザーは Google アナリティクスでは同じ訪問者とみなされます。一方、Cookie の元の有効期限が切れた後に同じユーザーがページにアクセスした場合、新しい Cookie が作成され、1 回目と 2 回目の訪問は Google アナリティクスで個別のユーザーのものとみなされます。
cookie_expires
値を 0
(ゼロ)秒に設定すると Cookie がセッション ベースになり、現在のブラウザ セッションが終了した時点で期限切れとなります。
gtag('config', '<TARGET_ID>', {
cookie_expires: 0
});
Cookie の更新
cookie_update
が true
(デフォルト値)に設定されていると、ページが読み込まれるたびに Cookie が更新されます。つまり、サイトへの最新の訪問に基づいて Cookie の有効期限が更新されます。たとえば、Cookie の有効期限が 1 週間に設定されていて、ユーザーが 5 日ごとに同じブラウザを使用して訪問した場合、Cookie の有効期限は訪問ごとに更新されるため、有効期限が切れることはありません。
false
に設定すると、Cookie はページの読み込みごとには更新されません。つまり、ユーザーが最初にサイトにアクセスしたときに基づいて Cookie 有効期限が決まります。
gtag('config', '<TARGET_ID>', {
cookie_update: false
});