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

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

この記事の解説内容:

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

始める前に

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

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

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

実装オプションを選択してください。

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

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

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

実装オプションを選択してください。

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 のスクリプトを読み込む