Google タグマネージャー（サーバー）

これはAmplitude アナリティクス用のサーバーサイドGoogleタグマネージャーテンプレートです。このタグはデータ収集にAmplitude HTTP V2 APIを使用します。

Amplitude GTMテンプレートを常に最新バージョンに更新することで、機能強化、重要なバグ修正、ユーザーエクスペリエンスの向上を実現できます。

コンテナのセットアップ

ゼロから始める場合は、まずコンテナを設定してください。このAmplitude アナリティクスタグテンプレートは、Server ターゲットプラットフォームで利用でき、デスクトップおよびモバイルWebページで使用されます。

テンプレートを追加する

ギャラリーを検索して新しいタグテンプレートを作成します。「Amplitude アナリティクス」を選択し、addボタンをクリックします。

クライアントを作成する

クライアントは GTM サーバー側コンテナによって受信されたデータを取得し、処理または適応します。その後、クライアントはデータをそのコンテナ内のタグ、トリガー、および変数で使用できるようにします。新しいサーバーコンテナを作成すると、UniversalアナリティクスとGA4という2つのクライアントが自動的に作成されます。サーバー側テンプレートをWebコンテナのプロキシとして使用したり、Templateセクションでカスタムクライアントテンプレートを作成したりすることもできます。

タグを作成する

AmplitudeブラウザSDKトラッキング用のタグを作成します。 Newボタンをクリックして、新しいタグを作成します。

APIキー

AmplitudeプロジェクトのAPIキーを［API Key］フィールドにコピーします。EUデータレジデンシーの場合、プロジェクトAPIキーはanalytics.eu.amplitude.com以下にあります。各プロジェクトには異なるAPIキーがありますので、必ず正しいプロジェクトからAPIキーをコピーしてください。「設定」>「プロジェクト」の順に移動し、リストから該当するプロジェクト名をクリックして、プロジェクトのAPIキーを確認します。詳細については、APIキーとトークンのドキュメントを参照してください。

ユーザーのIPアドレスを隠す

このチェックボックスをオンにすると、AmplitudeがユーザーのIPアドレスを受信しないようになります。

チェックHide User IP Address：AmplitudeはHTTPリクエストヘッダーから収集されたIPを使用します。これはサーバーからのIPです。
チェックを外す Hide User IP Address: Amplitude は getRemoteAddress メソッドを使用してリクエストの送信元である IP アドレスを取得します。

EU域内のデータレジデンシー

EUデータレジデンシーの場合、Amplitude EU内でプロジェクトを設定し、Amplitude EUのAPIキーを使用してください。サーバゾーンを設定するには、[タグ設定] の下の [EUデータレジデンシーを使用] チェックボックスをオンにします。

イベント設定

イベントペイロードに関連する設定。

マップイベントタイプ

表に、Amplitudeイベントタイプにマッピングしたいイベント名のそれぞれに対して行を追加します。 Block events that are not mappedをオンにすると、Amplitudeはリクエストとともにこのテーブルに含まれるイベントデータキーのみを送信し、テーブルに含まれていないイベントは除外します。

名前	概要
`Event Name`	必須です。 `string` このタグ`event_name`が受信した。
`Send As Event Type`	必須です。 `string` イベント名をマッピングするイベントタイプ。これはAmplitudeダッシュボードに表示される名前です。

イベントプロパティのマッピング

Event データオブジェクト内のキーを、Amplitudeに送信したいイベントプロパティにマップします。イベントプロパティ名を指定しない場合、Amplitudeは代わりにイベントデータキーを使用します。

名前	概要
`Event Data Key`	必須です。 `string` Amplitudeイベントペイロードにイベントプロパティとして含める、イベントデータオブジェクト内のキーと値のペア。
`Send As Event Property`	オプションです。 `string` Amplitudeダッシュボードに表示されるこのイベントのプロパティ名。空の場合、Amplitudeは代わりに`Event Data Key`イベントタイプとして使用します。

イベントプロパティを追加する

この表を使用して、Amplitudeサーバーに送信するヒットに新しいイベントプロパティを追加します。各プロパティにはキーと値が必要です。

名前	概要
`Event Property Key`	必須です。 `string` イベントデータオブジェクト内の`event_name`。
`Event Property Value`	オプションです。 `string` イベントプロパティキーの値。

ユーザープロパティの設定

「ユーザープロパティ設定」で、次のフィールドに値を入力します。

UTMパラメータを自動的に追跡

Amplitudeは、UTMパラメータを追跡するためにgetEventData('page_location')を使用して解析します。search_parameter

このチェックボックスをオンにすると、utm_source、utm_medium、utm_campaign、utm_term、utm_contentなどすべてのUTMパラメータが収集されます。Amplitudeはこれらの値やその他のユーザープロパティを、追跡イベントとともに送信します。

ユーザープロパティをマップする

Event Dataオブジェクト内のキーをAmplitudeに送信したいユーザープロパティにマップします。ユーザープロパティ名を指定しない場合、Amplitudeは代わりにイベントデータキーを使用します。この表に含まれるイベントデータキーのみがAmplitudeリクエストと連携します。

名前	概要
`Event Data Key`	必須です。 `string` Amplitudeに送信するユーザープロパティとして含めるイベントデータオブジェクト内のキー。
`Send As User Property`	オプションです。 `string` ユーザープロパティ名。これはAmplitudeダッシュボードに表示される名前です。空の場合、Amplitudeは代わりにユーザープロパティキーとして`Event Data Key`使用します。

ユーザープロパティを追加する

この表を使用して、Amplitudeサーバーに送信するヒットに新しいイベントプロパティを追加します。各プロパティにはキーと値が必要です。

名前	概要
`User Property Key`	必須です。 `string` Amplitudeに送信するユーザープロパティとして含めるイベントデータオブジェクト内のキー。
`User Property Value`	必須です。 `string` 特定のユーザープロパティキーの値。

その他のプロパティ

この機能を使用して、追加のイベントプロパティを追加できます。重複がある場合、新しい追加値が前の値に置き換えられます。各プロパティにはキーと値が必要です。

名前	概要
`Additional Property Key`	必須です。 `string` イベントプロパティのキーです。
`Additional Property Value`	必須です。 `string` プロパティキーのプロパティ値。

イベントの追跡に伴うその他の情報

名前	概要	デフォルト値
`user_id`	ユーザーID。	イベントオブジェクトまたは `undefined` の`user_id` または `x-ga-mp2-user_properties.user_id`からの値。
`device_id`	デバイス ID。	イベントオブジェクトから`client_id` の値です。
`time`	現在の時刻をミリ秒単位で表す数値です。	詳細。
`session_id`	セッションID。	イベントオブジェクト + `000`における `ga_session_id`の整数値。
`insert_id`	Amplitude Serverに重複排除目的で挿入されるInsert ID。	`eventName` + イベントオブジェクト内の `device_id`+ `time`。
`library`	Amplitudeでイベントのソースを特定するためのライブラリ。	`S-GTM`。

トリガーを定義する - トリガー

すべてのタグはイベントに基づいて発行されます。 Google Tag Manager はイベントを登録するたびに、イベントトリガーを評価し、それに応じてタグを発行します。サーバータグ内のトリガーは、Web コンテナと比べて制限されています。 GTM は次のトリガーを提供します。

カスタムトリガー: サーバーコンテナクライアントが受信要求を受け入れ、それを処理し、そのデータをコンテナ内で他のタグで使用できるようにするときに、カスタムトリガーを使用してタグを発行できます。このタグをすべてのイベントに対して発行するか、特定のイベントに対して発行するかを選択できます。
ページビュートリガー: このトリガーは、クライアントが受信要求を処理し、page_viewイベントを生成した場合にアクティブになります。そのイベントは、サーバーGTMのプレビューモードで表示されるはずです。
カスタムイベントトリガー: カスタムイベントトリガーはページビュートリガーと同じように機能します。唯一の違いは、発火させたいイベントの名前を選択できることです。

トラブルシューティング

GTMギャラリーでAmplitude アナリティクスを見つけることができないのはなぜですか？

サーバーコンテナを選択していることを確認してください。サーバー側テンプレートは、サーバーコンテナギャラリーにのみ存在します。

これは役に立ちましたか？