サーバーサイドのタグ マネージャーにデータを送信する

この記事では、サーバーサイド コンテナにイベントを送信するさまざまな方法について説明します。詳しい背景情報をお探しの場合は、サーバーサイド タグ設定の仕組みをご覧ください。

この記事の解説内容:

  • ウェブサイトからサーバーサイド コンテナにデータを送信する
  • 追加データをサーバー コンテナに送信する
  • サーバーサイド コンテナでデータを受け取る
  • ウェブサイト以外のソースからデータを送信する

始める前に

このガイドは、以下を完了されていることを前提とした内容です。

1. ウェブサイトからサーバーサイド コンテナにデータを送信する

タグ マネージャーまたは gtag.js を使用して、サーバーサイド実装を通してデータを送信できます。使用する実装方法を選択してください。

Google タグ: GA 4

サーバーサイドの処理用に Google タグをセットアップするには、サーバー コンテナ URL を追加する必要があります。

サーバー コンテナ URL の設定変数を作成する

  1. Google タグ マネージャーを開きます。

  2. 設定するウェブコンテナを選択します。

  3. [変数] メニューを開きます。

  4. タイプが [Google タグ: 設定] の新しいユーザー定義変数を作成します。

  5. 次のパラメータを追加します。

    • 名前: server_container_url
    • 値: タグ マネージャーのサーバー コンテナのサーバー コンテナ URL に設定します。

  6. 変数に名前を付け（例: サーバー URL）、保存します。

サーバー コンテナの URL を Google タグに割り当てる

  1. [タグ] メニューを開きます。
  2. 新しい Google タグを追加するか、既存のタグを編集します。
  3. [設定] で、今回作成したサーバー コンテナ変数を選択します。
  4. 他のトリガーより先に Google タグが配信されるようにするには、[トリガー] をクリックし、[初期化 - すべてのページトリガー] を使用します。詳しくは、ページトリガーについての記事をご覧ください。
  5. タグを保存し、コンテナを公開します。

省略可: 各イベントとともに追加のパラメータを送信する

さらに、設定レベルのパラメータとイベントレベルのパラメータという 2 種類の追加パラメータを送信できます。設定パラメータは Google タグの動作に影響を与え、Google タグレベルでのみ設定できます。

イベント パラメータはイベントに関する追加情報を指定し、すべてのイベント、選択したイベント、または page_view イベントに対して設定できます。

設定パラメータすべてのイベント選択したイベントpage_view イベント

Google タグ マネージャーで設定を再利用する方法をご覧ください。

すべてのイベントにわたって追加パラメータを送信するには、Google タグ マネージャーでイベントの設定を再利用するをご覧ください。

Google アナリティクス 4 イベントとともに追加パラメータを送信するには:

  1. ウェブ用コンテナで、Google アナリティクス 4 イベントタグを追加するか、既存のタグを編集します。
  2. [イベント パラメータ] > [行を追加] をクリックします。
  3. イベントとともに送信するパラメータを追加します。事前定義済みのイベント パラメータについては、推奨イベントのリファレンスをご覧ください。
    • [フィールド名] 欄で、パラメータ名（例: language）を追加します。
    • [値] 欄で、パラメータの値を追加します。
  1. トリガーの発動条件として [初期化 - すべてのページ] を指定します。
  2. タグを保存し、コンテナを公開します。

page_view イベントの発生時にパラメータを送信するには:

  1. ウェブコンテナで、既存の Google タグを編集します。

  2. 次の新しいパラメータを追加して、設定内のデフォルトの page_view を無効にします。

    • 名前: send_page_view
    • 値: false

  3. Google アナリティクス: GA4 イベントタグを新規作成します。

    • 設定タグとして、ステップ 1 で編集したタグを選択します。
    • イベント名を page_view に設定します。

  4. イベントとともに送信するパラメータを追加します。事前定義済みのイベント パラメータについては、推奨イベントのリファレンスをご覧ください。 - [フィールド名] 欄で、パラメータ名（例: language）を追加します。

    • [値] 欄で、パラメータの値を追加します。
  1. トリガーの発動条件として [初期化 - すべてのページ] を指定します。
  2. タグを保存し、コンテナを公開します。

2. サーバーサイド コンテナでデータを受け取る

サーバー コンテナに送信した HTTP リクエストを、コンテナ側のクライアントが「獲得」するように設定する必要があります。

利用可能なクライアントの一覧を参照する手順は次のとおりです。

  1. Google タグ マネージャーを開きます。

  2. 使用するサーバー コンテナを開きます。

  3. 左側のナビゲーション バーで [クライアント] をクリックします。GA4 用のクライアントは、あらかじめサーバーサイド コンテナにインストールされています。

  4. クライアントの名前をクリックすると、詳細の確認と編集ができます。

オプションのクライアント設定

ほとんどの場合、クライアントを変更する必要はありませんが、ユースケースによっては次の設定を変更することも可能です。

  • 優先度: クライアントの実行順序を指定します。数字が大きいものから順に実行され、受信したリクエストに一致する最初のクライアントが、そのリクエストのアクティブなクライアントとなります。

  • 有効化の条件: クライアントがリクエストに応答する条件を指定します。

    • 特定の ID 向けのデフォルトの gtag.js パス: サーバー コンテナの URL を使用した gtag.js JavaScript 配信が有効になります。この設定をオンにすると、デフォルトの gtag.js リクエストパス（/gtag/js?id=TAG_ID など）へのリクエストに応答して、このクライアントが有効になります。[測定 ID を追加] をクリックして、リンク先 ID を追加します（複数可）。

省略可: 追加データをサーバーサイド タグ マネージャーで受け取る

追加パラメータを送信している場合、追加パラメータを解析したり、追加パラメータからイベントデータを作成したりするには、サーバー コンテナ内に Google アナリティクス 4 クライアントをセットアップする必要があります。

一部のサーバータグでは、セットアップなしでアウトバウンド リクエストに追加パラメータが含まれます。これらのパラメータを除外するには、変換を作成して値を削除します。

他のタグで追加パラメータを使用するには:

  1. サーバー コンテナで、左側のナビゲーションの [変数] をクリックします。
  2. [ユーザー定義変数] セクションで [新規] をクリックします。
  3. [変数の設定] で、変数タイプ [イベントデータ] を選択します。
  4. [キーパス] 欄に、パラメータの名前を入力します。
  5. 変数に名前を付けて保存します。

これで、受け取ったイベント パラメータを、サーバー コンテナ内の任意のタグで活用できるようになりました。

3. 省略可: ウェブサイト以外のソースからデータを送信する

Google アナリティクスの Measurement Protocol を使用すると、モバイルアプリやサーバー間アプリケーションなどのデータをタグ設定サーバーへ送信できるようになります。

モバイルアプリ

Android アプリまたは iOS アプリからサーバー コンテナへデータを送信するには、カスタム画像タグを作成し、Measurement Protocol を使用するように設定します。

  1. モバイル用コンテナ（Android または iOS）で、[タグ] > [新規] をクリックします。
  2. [タグの設定] で、タグタイプとして [カスタム画像] を選択します。
  3. [画像の URL] として、前に指定した Measurement Protocol クライアントのパスにあるサーバー コンテナのピクセル画像を設定します。ピクセル URL の末尾に任意の Measurement Protocol パラメータを追加します。
    https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
  4. [キャッシュ無効化を有効にする] チェックボックスをオフにします。
  5. タグを保存し、コンテナを公開します。
  6. サーバーサイド コンテナで、[クライアント] > [新規] をクリックします。
  7. [クライアントの構成] で、クライアントの種類として [Measurement Protocol] を選択します。
  8. [アクティベーション パス] として、アプリのコレクション エンドポイントのパスを設定します。
  9. クライアントの設定を保存し、サーバーサイド コンテナを公開します。

サーバー間アプリ

Measurement Protocol データをサーバー コンテナへ送信するには、www.google-analytics.com ホスト名をサーバー コンテナのドメイン名に置き換えます。次に例を示します。

POST /batch HTTP/1.1
Host: collection.example.com

v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

Measurement Protocol のヒットを受け取るには、サーバーサイド タグ マネージャーのコンテナに Measurement Protocol クライアントを組み込みます。

  1. サーバーサイド コンテナで、[クライアント] > [新規] をクリックします。
  2. [クライアントの構成] で、クライアントの種類として [Measurement Protocol] を選択します。
  3. [アクティベーション パス] として、サーバーのエンドポイントのパスを設定します。
  4. クライアントの設定を保存し、コンテナを公開します。

次のステップ

純粋なファーストパーティ コンテキストでデータ送信を行うには、Google のスクリプト（Google アナリティクス ライブラリなど）を自社サーバーから配信する必要があります。

自社サーバーを通して Google のスクリプトを読み込む