この記事では、サーバー側のコンテナにイベントを送信するさまざまな方法について説明します。この記事の手順を開始する前に、まずサーバー側のタグ設定を行ってください。
この記事では、以下の手順を説明します。
- ウェブサイトからサーバー側のコンテナにデータを送信する
- サーバー側のコンテナでデータを受信する
- ファースト パーティのエンドポイントから Google アナリティクス スクリプトを読み込む
- Google アナリティクス 4 タグを使って追加のデータをサーバー コンテナに送信する
- ウェブサイト以外のソースからデータを送信する
ウェブサイトの構成
タグ マネージャーまたはグローバル サイトタグ(gtag.js)を使用して、サーバー側へデータを送信できます。
タグ マネージャー
サーバー側構成を介してデータが転送されるようにサポート対象のタグを設定するには、[トランスポート URL を設定] を使用します。トランスポート URL には、ファースト パーティ ドメインのエンドポイントを指定します。
サーバー側で処理されるようにタグを設定するには、トランスポート URL を追加します。
Google アナリティクス 4
- ウェブ用コンテナで、GA4 設定タグを追加するか、既存のタグを編集します。
- [サーバー コンテナに送信する] チェックボックスをオンにします。
- 対応するテキスト フィールドにサーバー コンテナの URL を入力します。
- タグを保存し、[すべてのページ] トリガーで発動するようにトリガーを構成します。
- コンテナを公開します。
ユニバーサル アナリティクス
- ウェブ用コンテナで、ユニバーサル アナリティクス タグを追加して、Google アナリティクス設定変数を指定するか、既存のユニバーサル アナリティクスの設定を使用します。
- [詳細設定] に移動します。
- [トランスポート URL を設定] チェックボックスをオンにします。
- サーバー コンテナの URL を [トランスポート URL] フィールドに追加します(例:
https://<DOMAIN_NAME>
。DOMAIN_NAME
はサーバー コンテナのドメイン名)。 - タグを保存し、すべてのページで発生するようにトリガーを設定します。
- コンテナを公開します。
グローバル サイトタグ(gtag.js)
ウェブサイトで gtag.js を使っている場合は、ユニバーサル アナリティクスまたは Google アナリティクス 4 の config
コマンドを更新して、サーバー コンテナにイベントを送信します。
GA4 タグと UA タグの両方で、既存のタグに transport_url
パラメータと first_party_collection
パラメータを追加します。
gtag('config', 'G-XXXXXX', {
transport_url: 'https://analytics.example.com',
first_party_collection: true
});
G-XXXXXX
を、Google アナリティクス 4 またはユニバーサル アナリティクスの ID に置き換えます。https://analytics.example.com
は、サーバー コンテナの URL に置き換えます。
サーバー側クライアントの設定
トランスポート URL を設定すると、タグ マネージャーのサーバー側コンテナへデータが送信されるようになります。デフォルトでは、GA4 と UA のクライアントがサーバー側のコンテナにプリインストールされています。
タグ マネージャーのサーバー用コンテナで、左側のナビゲーションにある [クライアント] をクリックすると、クライアントのリストが表示されます。詳細を表示または編集するクライアントの名前をクリックします。ほとんどの場合、クライアントを変更する必要はありませんが、状況によっては、以下の設定の編集が必要になります。
優先度: クライアントの実行順序を指定します。数字が大きいものが最初に実行され、受信したリクエストに一致する最初のクライアントが、そのリクエストのアクティブなクライアントとなります。
有効化の条件: クライアントがリクエストに応答する条件を指定します。
ユニバーサル アナリティクスのデフォルトのパス: リクエストのパスに
/collect
や/r/collect
が含まれている場合、または JavaScript ファイルが Google アナリティクスへデータを送信するために使用する同様のパスが含まれている場合、クライアントが有効化されます。デフォルトでは、この設定が適用されます。特定の ID 向けのデフォルトの gtag.js パス: サーバー コンテナの URL を使用した gtag.js JavaScript 配信が有効になります。この設定を選択すると、デフォルトの gtag.js リクエストパス(
/gtag/js?id=G-XXXXXX
など)へのリクエストに応答して、このクライアントが有効になります。[測定 ID を追加] をクリックして、1 つ以上の Google アナリティクス測定 ID を追加します。
Google スクリプトを読み込む
サーバーサイド タグ設定のメリットを最大限に活用するには、サーバー コンテナを使用して、サポートされているスクリプトを読み込みます。これにより、サードパーティ ドメインへの依存を減らすことができます。
gtag.js ソースドメインを更新する
gtag.js をインストールすると、デフォルト構成により、www.googletagmanager.com
から Google アナリティクス ライブラリが読み込まれます。サーバー コンテナを使用してアナリティクス コードを読み込むには、このドメイン名をサーバー コンテナのドメイン名に変更します。
<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://<DOMAIN NAME>/gtag/js?id=<G-XXXXXX>"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', '<G-XXXXXX>');
</script>
クライアントの構成
Google アナリティクス スクリプトの読み込みがリクエストされたとき、サーバー コンテナが応答できるようにするには、クライアントを一部変更する必要があります。
- サーバー側コンテナで [クライアント] をクリックし、クライアントをリスト表示します。
- 編集するクライアントの名前をクリックします。
- [特定の ID 向けのデフォルトの gtag.js パス] を選択します。
- [測定 ID を追加] をクリックして、ID を入力します。
- クライアントの設定を保存し、コンテナを公開します。
gtm.js ソースドメインを更新する
ウェブサイトに gtm.js をインストールすると、デフォルト構成により、www.googletagmanager.com
から Google タグ マネージャー ライブラリが読み込まれます。サーバー コンテナを使用して GTM コードを読み込むには、このドメイン名を、gtm.js
スクリプトと ns.html
ファイルの両方で、サーバー コンテナのドメイン名に変更します。
クライアントの構成
Google タグ マネージャー スクリプトの読み込みがリクエストされた際にサーバー コンテナが応答できるようにするには、Google タグ マネージャー: ウェブコンテナのクライアントを追加し、設定に変更を加えます。
- サーバー側コンテナで [クライアント] をクリックし、クライアントをリスト表示します。
- [クライアント] セクションで [新規] をクリックします。
- [クライアントの構成] セクションをクリックして、クライアントの種類を選択します。
- 利用可能なクライアントの一覧から [Google タグ マネージャー: ウェブコンテナ] を選択します。
- [コンテナ ID を追加] をクリックし、Google タグ マネージャー ウェブコンテナ ID を入力します。この ID は、上記の HTML スニペットで使用した ID と一致する必要があります。
- クライアントの設定を保存し、コンテナを公開します。
他のタグの追加データを含める
サーバーに同様のデータを送信する複数のタグをページにインストールしている場合は、個別のタグを使用する代わりに、タグ マネージャーや gtag.js で Google アナリティクス 4 タグを使って、そのデータをサーバー コンテナにルーティングすることをおすすめします。タグで追加のイベント パラメータを指定し、それからサーバー側コンテナで変数を使ってパラメータを抽出することができます。これにより、ページ上の JavaScript の量を減らし、HTTP リクエストの数を最小限に抑えることができるため、ウェブサイトのパフォーマンスが向上します。
タグ マネージャー
固有の ID など、すべてのイベントで送信するパラメータがある場合は、Google アナリティクス 4 設定タグの [設定フィールド] に追加します。
- ウェブ用コンテナで、Google アナリティクス 4 設定タグを追加するか、既存のタグを編集します。
- [設定フィールド] > [行を追加] をクリックします。
- すべてのイベントに表示するパラメータをパラメータ名 / 値テーブルに追加します。
- [すべてのページ] を対象に配信されるようにトリガーを設定し、タグを保存します。
一部のイベントで送信するパラメータがある場合は、Google アナリティクス 4 イベントタグの [イベント パラメータ] セクションでそのパラメータを追加します。
- ウェブ用コンテナで、Google アナリティクス 4 イベントタグを追加するか、既存のタグを編集します。
- [イベント パラメータ] > [行を追加] をクリックします。
- パラメータをパラメータ名 / 値テーブルに追加します。
- トリガーを設定して、タグを保存します。
gtag.js
gtag API では、追加のパラメータをコマンド パラメータとして含めることで指定できます。詳しくは、gtag.js API リファレンスをご覧ください。
すべてのイベントで送信するパラメータを設定するには:
gtag('config', '<G-XXXXXX>', {
'transport_url': 'https://analytics.example.com'
'custom_parameter': 'value',
});
特定のイベントで送信するパラメータを設定するには:
gtag('event', 'event_name', {
'custom_parameter': 'value',
});
page_view
イベントのみで送信されるパラメータを設定するには、false
の値を持つ send_page_view
パラメータを config コマンド内に追加し、個別の page_view
イベントを追加します。
gtag('config', 'G-XXXXXX', {
'transport_url': 'https://analytics.example.com'
'send_page_view': false,
});
gtag('event', 'page_view', {
'custom_parameter': 'value',
});
サーバー側 Google タグ マネージャーで追加データを受信する
サーバー コンテナでは、Google アナリティクス 4 クライアントによって追加のパラメータが解析され、イベントデータに設定されます。このデータを他のタグで使用するには、イベントデータ変数を作成し、キーパスにパラメータ名を指定することをおすすめします。こうすることで、パラメータを必要とするタグでこの変数を使用できるようになります。
他のソースからデータを送信
Google アナリティクスの Measurement Protocol を使用すると、モバイルアプリやサーバー間アプリケーションなどのデータをタグ設定サーバーへ送信できるようになります。
モバイルアプリ
Android アプリまたは iOS アプリからサーバー コンテナへデータを送信するには、カスタム画像タグを作成し、Measurement Protocol を使用するように設定します。
- モバイル用コンテナ(Android または iOS)で、[タグ] > [新規] をクリックします。
- [タグの設定] で、タグタイプとして [カスタム画像] を選択します。
- [画像の URL] として、前に指定した Measurement Protocol クライアントのパスにあるサーバー コンテナのピクセル画像を設定します。ピクセル URL の末尾に任意の Measurement Protocol パラメータを追加します。
https://custom.example.com/app?v=1&tid=G-XXXXXX&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
- [キャッシュ無効化を有効にする] チェックボックスをオフにします。
- タグを保存し、コンテナを公開します。
- サーバー側コンテナで、[クライアント] > [新規] をクリックします。
- [クライアントの構成] で、クライアントの種類として [Measurement Protocol] を選択します。
- [アクティベーション パス] として、アプリのコレクション エンドポイントのパスを設定します。
- クライアントの設定を保存し、サーバー側コンテナを公開します。
サーバー間アプリ
Measurement Protocol データをサーバー コンテナへ送信するには、www.google-analytics.com
ホスト名をサーバー コンテナのドメイン名に置き換えます。例:
POST /batch HTTP/1.1
Host: collection.example.com
v=1&tid=G-XXXXXX&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
Measurement Protocol のヒットを受信するには、Measurement Protocol クライアントを使用して Google タグ マネージャーのサーバー側コンポーネントを設定します。
- サーバー側コンテナで、[クライアント] > [新規] をクリックします。
- [クライアントの構成] で、クライアントの種類として [Measurement Protocol] を選択します。
- [アクティベーション パス] として、サーバーのエンドポイントのパスを設定します。
- クライアントの設定を保存し、コンテナを公開します。