Google タグマネージャー（クライアント）

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

このアプローチはまた、システム内に異なるバージョンのAmplitude SDKが共存する場合にイベントが見失われるのを防ぐことができます。

Amplitudeは初期化段階でクッキーを生成します。クッキーの管理に関する詳細については、クッキー管理の詳細を参照してください。 Amplitudeは、クッキーへの同意を得た後に初期化することをお勧めします。 Amplitudeは遅延初期化をサポートしており、initコマンドの前に発生したイベントをすべてキャプチャします。

APIキー

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

自動キャプチャオプション

次のイベントタイプに対して自動キャプチャを有効にするには、［自動キャプチャイベントを有効にします］：

• マーケティングアトリビューションを追跡します。
• ページビューを追跡します。
• セッションを追跡します。
• フォームのインタラクションを追跡します。
• ファイルのダウンロードを追跡します。
• 要素間の相互作用を追跡します。

詳細については、「ブラウザ SDK 2 - 自動キャプチャ」を参照してください。

ページビューの追跡

ページビュートラッキングを有効にするには、このチェックボックスをオンにします。 以下の設定が利用可能なページビュートラッキングオプションです。 詳細については、「ブラウザSDK 2」を参照してください。

セッション追跡

セッション トラッキングを有効にするには、このボックスをオンにします。 詳細については、「ブラウザSDK 2」を参照してください。

フォームインタラクション追跡

フォームのインタラクションの追跡を有効にするには、このボックスをオンにします。 詳細については、「ブラウザSDK 2」を参照してください。

ファイルダウンロードの追跡

ファイルのダウンロード追跡を有効にするには、このボックスをオンにします。 詳細については、「ブラウザSDK 2」を参照してください。

ネットワーク追跡

ネットワーク追跡を有効にするには、このボックスをオンにします。 ネットワーク追跡は、XHRやFetchによって呼び出されたネットワークリクエストイベントをキャプチャします。 詳細については、「ブラウザSDK 2 - ネットワークリクエストの追跡」を参照してください。

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

EUデータレジデンシーの場合、Amplitude EU内でプロジェクトを作成し、Amplitude EUのAPIキーを使用してください。 サーバゾーンを設定するには、［Tag Configuration］＞ ［Initialization of the init tag］ の下の ［EU Data Residency］ チェックボックスをオンにします。初期化セクションは、タグタイプが init に設定されている場合にのみ表示されます。 詳細については、「ブラウザSDK 2」を参照してください。

ユーザーID

ユーザー ID がすでに使用可能な場合は、次の操作を実行できます。

• init の「ユーザーID」入力ボックスに値を入力して、インスタンスを初期化します。
• setUserId のタグタイプを使用して、後でユーザーIDを設定してください。詳細については、「ブラウザSDK 2」を参照してください。

設定

次のオプションから選択してください。

• Use default values。 初期化では、各設定オプションのデフォルト値が使用されます。
• Set configuration manually。 対応するオプションを選択することで設定されます。 以下の設定は、GTMテンプレートの値タイプで使用できるものです。
• Select a **GTM variable** from the list。 インスタンス設定に使用するキーと値のペアを含むオブジェクトを返す必要があります。 キーが使用可能な設定の一部であることを確認してください。

新しい設定オプション

[新しい設定オプション] フィールドを使用して、追加の設定オブジェクトを init に渡します。 GTM ではカスタムテンプレートのフィールド数が 100 に制限されていますが、initタグはその上限に達しているため、新しいブラウザSDKオプションではタグ内に独自のフィールドが設定されません。 これらのオプションを GTM 変数のオブジェクトに組み込み、その変数をこのフィールドに割り当てます。 このタグは、initタグの残りの部分から構築された設定の上にオブジェクトをマージします。

このフィールドはインラインオブジェクトではなく変数参照を受け取るため、まず変数を作成してください：

1. 設定オブジェクトを返すGTM変数を作成します。公開されているオプションについてはコミュニティテンプレートギャラリーにあるAmplitude Browser SDK設定変数テンプレートを使用するか、テンプレートでカバーされていないものについてはカスタムJavaScript変数を使用してください。
2. initタグ内で、[新規設定オプション] をその変数に設定します (例: {{New config options}})。

この 2 つの設定フィールドの動作は異なります。 これらのタグがどのように相互作用するかを理解することで、タグが予期せず削除したり設定を上書きしたりすることを防ぐことができます。

• 設定はタグの開始点です。 その後、このタグは、自動キャプチャ、セッションリプレイ、EU データレジデンシーなど、そのタグの他の設定をその上に適用し、一致するトップレベルのキーをすべて上書きします。init このフィールドで、タグ自身の自動キャプチャ設定は、GTM 変数を介して渡されたautocaptureキーなどのキーを置き換えます。
• 新しい設定オプションは最後に来るため、競合するトップレベルのキーに対しては新しい設定オプションが優先されます。 マージは浅いものです。このタグは、wholesale などの最上位キーを深くマージするのではなく、autocapture置き換えます。

次の例では、単一の設定オブジェクトを使用し、それを各フィールドに割り当てた結果を示しています。 自動キャプチャイベントが有効になっていることを前提としています。

{
  deviceId: 'my-device-id',
  autocapture: {
    attribution: {
      trackingMethod: ['userProperty', 'eventProperty']
    },
    newAutocaptureOption: 'value'
  }
}

Configuration に割り当てられたオブジェクトはベースとなり、その後タグの Autocapture 設定がautocaptureキー全体を上書きします。

{
  deviceId: 'my-device-id',              // ✅ kept (UI never touches it)
  autocapture: { /* UI autocapture */ }, // ❌ entire object overwritten —
                                         //    attribution + newAutocaptureOption lost
}

新しい設定オプションに割り当てられた場合、このタグは最後にオブジェクトをマージします。 マージは浅いため、autocapture はタグの Autocapture 設定を完全に置き換えます。

{
  deviceId: 'my-device-id',              // ✅ added
  autocapture: {                         // ✅ your value wins, but it REPLACES
    attribution: {                       //    the tag's Autocapture config (shallow merge)
      trackingMethod: ['userProperty', 'eventProperty']
    },
    newAutocaptureOption: 'value'
  }
}

セッション開始前にユーザープロパティを設定する

ユーザープロパティが自動session_startイベントで新しい値を必要とする場合に、New configuration options にidentifyオブジェクトを渡します。 SDK は $identify の直前に結果イベントを追跡するため、session_start は更新されたプロパティを保持しますsession_start。init の後に起動される identify または setUserProperties タグは、この処理を実行できません。これは、その identify イベントが session_start の後に発生し、後のイベントにのみ適用されるためです。

Amplitude Browser SDK の設定変数テンプレートはidentifyフィールドを公開しないため、カスタム JavaScript 変数にオブジェクトを構築してください。 SDK は値に対して getUserProperties() のみを呼び出すため、そのメソッドを持つプレーンオブジェクトは Identify インスタンスの代わりに機能します:

function() {
  var identify = {
    getUserProperties: function() {
      return {
        "$set": {
          "location": "vancouver"
        }
      };
    }
  };
  return {
    identify: identify
  };
}

getUserProperties()はidentifyイベントのuser_propertiesペイロードを返すため、任意のidentify操作をキーとして受け入れます：$set、$setOnce、$add、$append、$prepend、$remove、$preInsert、$postInsert、$unset、または$clearAll。必要な場合は、identify と一緒に同じ変数から他の初期化オプションを返します。

カスタムエンリッチメントプラグイン

Enable Custom Enrichment プラグインを使用して、Custom Enrichment プラグインをinitタグに追加します。 このプラグインは、タグが追跡するすべてのイベントに対してエンリッチメント機能を実行します。 Amplitudeはその機能をプロジェクトのリモート設定に保存するため、コンテナを再公開することなくその機能を変更できます。

デフォルトでは、このチェックボックスは選択されていません。

イベントの追跡

イベントは、ユーザーがアプリケーションとどのように対話するかを表します。 たとえば、「ボタンがクリックされました」というアクションは、メモしておきたい項目かもしれません。

このtrackタグ タイプは、特定のトリガーの下でイベントを追跡します。

イベントタイプ

個々のイベントプロパティ

イベントプロパティオブジェクト

有効なイベントプロパティオブジェクトを返すGTM変数を選択してください。重複したキーが存在する場合、これによりイベントプロパティが上書きされます。Amplitude は、オブジェクト形式でない入力や、user_propertiesキーの下にある値をすべて無視します。

    {
        'eventPropKey' : 'eventPropValue',
        'otherEventPropKey': 'otherEventPropValue',
    }

プロパティを定義するためのスケーラブルなアプローチを確立するには、GTM で Google タグ: イベント設定変数を使用できます。 GTM Google タグ: イベント設定変数を使用すると、複数のタグでイベント設定を再利用できます。 詳細については、「Browser SDK 2」を参照してください。この変数を使用してプロパティを作成し、複数のタグ間で再利用できます。

Google タグ: イベント設定変数の形式:

    {
        'eventPropKey' : 'eventPropValue',
        'otherEventPropKey': 'otherEventPropValue',
        'user_properties': {
            'user_property_key': 'user_property_value'
        }
    }

イベントプロパティオブジェクトの入力として「Googleタグ：イベント設定」変数を選択した場合、Amplitudeは以下の値を無視しますuser_properties。

カスタムタイムスタンプ

グループでの追跡

イベントレベルのグループを設定します。イベントレベルのグループの場合、グループの指定は特定のログイベントにのみ適用され、setGroup で明示的に設定されていない限り、ユーザーに永続することはありません。 詳細については、「ブラウザSDK 2 - ユーザーグループ」を参照してください。

ユーザープロパティを設定する

個々のユーザープロパティ操作をそれぞれテーブル内の独自の行として追加します。好きなだけ追加できますが、1回の操作で含めることができるのは特定のユーザープロパティのみです。操作は順番に実行されます。 詳細については、「ブラウザSDK 2」を参照してください。

グループの設定

Amplitudeでは、ユーザーをグループに割り当てたり、それらのグループに対して「ユニーク数による集計」などのクエリを実行したりすることができます。 グループの少なくとも1人のメンバーが特定のイベントを実行した場合、そのグループはカウントに含まれます。詳細については、「ブラウザSDK 2」を参照してください。

グループプロパティを設定する

Group Identify API を使用して、特定のグループのプロパティを設定または更新します。これらの更新は今後のイベントにのみ影響します。詳細については、「ブラウザSDK 2」を参照してください。

収益の追跡

ユーザーの収益イベントを追跡します。 収益インスタンスは各収益トランザクションを保存し、Amplitudeのイベントセグメンテーションと収益LTVチャートで使用されるいくつかの特別な収益プロパティ（revenueTypeやproductIdentifierなど）を定義できます。

イベントをフラッシュする

flush メソッドは、クライアントにバッファリングされたイベントを送信するよう促します。 flushタグタイプを手動で呼び出す必要はありません。flushIntervalMillisタグタイプは または flushQueueSize のいずれか早い方に基づいてトリガーされます。 ブラウザを閉じることによるイベントの損失を回避するには、transport構成オプションbeaconで を設定するか、イベントで をamplitude.setTransport('beacon')呼び出すことを検討してくださいpagehide。 詳細については、「ブラウザSDK 2」を参照してください。

イベントのトラフィック負荷に応じて flushQueueSize と flushIntervalMillis を削減し、イベントがクライアント上で停止しないようにします。

ユーザーIDを設定する

ログアウト後に userIdと deviceId をリセットするには、代わりに resetタグタイプを確認してください。

デバイス ID を設定する

ログアウト後に userIdと deviceId をリセットするには、代わりに resetタグタイプを確認してください。

セッション ID を設定する

Amplitudeはセッションロジックを自動的に処理します。 セッション制御をオプトアウトするには、sessionId を-1 に設定する必要がある場合があります。 値がエポックからのミリ秒単位（Unix タイムスタンプ）または -1 であることを確認してください。 詳細については、「ブラウザSDK 2」を参照してください。

リセット

ユーザーがログアウトしたときに使用resetします。 これには 2 つの操作が含まれます: setUserId(undefined)および setDeviceId(UUID())。 詳細については、「ブラウザSDK 2」を参照してください。

オプトアウトを設定する

このチェックボックスをオンにすると、ユーザーの追跡をオプトアウトできます。Opt current user out of tracking 詳細については、「ブラウザSDK 2」を参照してください。

トリガーを定義する

すべてのタグはイベントに基づいて発行されます。 Google Tag Manager はイベントを登録するときに、イベント トリガーを評価してタグを発行します。 GTM で使用可能なトリガーについては、「トリガーの種類」を参照してください。

カスタムプラグインを追加する

プラグインを使用すると、イベントを変更できます。 詳細については、ブラウザ SDK プラグインのドキュメントを参照してください。 カスタム HTML タグを使用してカスタムプラグインを追加できます。

たとえば、デフォルトのページビューイベントにイベントプロパティを追加する HTML の場合:

<script>
  window.amplitudeGTM.add({
    name: "page-view-enrichment-plugin",
    execute: function(event) {
      if(event.event_type === "[Amplitude] Page Viewed"){
        event.event_properties["custom_key"] = "custom_value";
      }
      return event;
    }
  });
</script>

名前付きインスタンスにプラグインを追加するには、window.amplitudeGTM.createInstance('instanceName').add() を使用します。

GTM は、そのテンプレートに基づくタグが起動された場合にのみテンプレートをロードします。 その結果、タグの順序を設定して、プラグインが最初にロードされ、その後のすべてのイベントに適用されるようにします。これを行うには、プラグインをinitタグのセットアップタグとして追加するカスタムHTMLタグを作成します。次に、フラッシュタグをカスタムHTMLタグのセットアップタグとして設定します。タグを次の順序で並べ替えます。

• フラッシュ
• カスタム HTML。
• init

トラブルシューティング

これらは、GTM テンプレートで発生する一般的な問題です。 ご使用の GTM インスタンスに関する詳細なトラブルシューティングについては、GTM ヘルプセンターを参照してください。

• 問題のトラブルシューティング。
• コンテナのプレビューとデバッグ。

Amplitude GTMテンプレートはReact Native（AndroidまたはiOS）アプリをサポートしていますか？

いいえ。Amplitude アナリティクス Browser SDKは、デスクトップおよびモバイルブラウザ向けに設計されたウェブコンテナのみをサポートしています。Amplitudeはモバイルアプリ用のGTMテンプレートをサポートしていません。 この機能をリクエストするには、Amplitudeヘルプセンターから機能リクエストを送信してください。

自分のプラグインが機能するためには、カスタムエンリッチメントプラグインを有効にするチェックを入れる必要がありますか？

いいえ。「カスタムエンリッチメントプラグインを有効にする」チェックボックスは、プロジェクトのリモート設定からエンリッチメント機能を実行するAmplitude製プラグインを制御します。 これは、amplitudeGTM.add() でカスタム HTML タグを使用して登録するプラグインとは無関係です。

テンプレートをアップグレードした後でこのチェックボックスがオフになっている場合は、オフのままにしてください。 独自のプラグインは動作し続けます。 このチェックボックスの機能については、「カスタムエンリッチメントプラグイン」を参照してください。また、作成するプラグインについては、「カスタムプラグインを追加する」を参照してください。

Amplitudeテンプレートにロジックを追加できますか？

はい。ただし、推奨されていません。 変更されたコミュニティギャラリーテンプレートは開発者から更新を受け取ることはありませんが、テンプレートを復元して再び通知を受け取ることができます。

欠落しているイベント

• 複数のバージョンのAmplitudeブラウザSDKがインストールされているかどうかを確認してください。 SDKの異なるバージョン間で競合が発生する可能性があります。GTM インスタンスに別のインスタンス名を付けてみてください。
• ウェブサイトがテンプレートが挿入しようとしているスクリプトをブロックしている場合は、ブラウザの [コンソール] または [ネットワーク] タブを確認して、スクリプトがブロックされているかどうか、またはエラーが発生しているかどうかを確認してください。
• 初期化ウェブアトリビューションイベントが見つかりません。Cookieの同意をインストールしている場合は、の値がdocument.referrer現在のドメインに更新されるか確認してください。現在のドメインからのキャンペーンは追跡されません。
• 適切なタグ配信オプションを選択していることを確認してください。このオプションを選択すると、ユーザーがトリガーイベントを実行するたびにタグが起動します。Once per event 選択すると、タグは 1 回だけ起動されます。Once per Page この不一致により、イベントが期待どおりに送信されない可能性があります。

増加する全体的なユーザー数

クッキーが誤って変更または削除されたかどうかを確認してください。 クッキーは重要なユーザーセッションデータとマーケティングキャンペーン情報を保存します。 これらのクッキーが削除されると、Amplitudeはユーザー識別子（ユーザーIDやデバイスIDなど）をリセットし、ユーザー数が急増する原因となります。また、最後に閲覧されたキャンペーンのパラメータを削除すると、オーガニックおよびダイレクトのトラフィックが増加するなど、さまざまな効果をもたらす可能性があります。

クロスドメイントラッキング

ドメイン間でユーザーを保持するには、カスタム HTML タグを作成して、ユーザーの deviceId を追跡したいドメインリンクに添付します。URL に追加する場合、Amplitude Browser SDK は新しい deviceId を生成するのではなく、URL パラメータ値を使用します。 ampDeviceId=YourDeviceId詳細については、GitHub 上のサンプルスクリプトを参照してください。

テンプレートバージョン 15cce （ライブラリバージョン amplitude-ts-gtm/3.17.1 ）以降、テンプレートは同じセッションを維持するためにURLパラメータ ampSessionId からセッションIDを取得することをサポートしています。また、ampTimestampパラメータを含めて評価ウィンドウを作成することもできます。このウィンドウは、トラッキングパラメータが期限切れになっていない場合にのみ使用されるようにします。 詳細については、「ブラウザSDK 2.0を使用したクロスドメイントラッキング」を参照してください。

identifyまたはgroupIdentify値に他のタイプを渡す方法

タグ内の値をハードコーディングすると、入力内容が強制的に型stringに変わります。 numberまたは boolean などの他のタイプを使用するには、GTM 変数（具体的にはデータ層変数）を作成します。

データレイヤーは正しいのにイベントは間違っているのはなぜですか？

この問題は、タグがデータ層の変数から値を読み取った場合に発生します。その場合、短時間で2つの値がデータ層にプッシュされます。期待される動作は、Amplitudeが異なる値を持つ2つのイベントを追跡することです。しかし実際には、両方のイベントが2番目の（最も最近プッシュされた）値を持ちます。

これは、最初の値がデータ層にプッシュされると、データ層が値を更新しますが、イベントをトリガーすることはありません。 2番目の値がプッシュされると、データ層は再び値を更新し、2つのイベントをトリガーし、どちらも2番目の値を読み取ります。

メッセージにイベント名を追加したにもかかわらずこの問題が引き続き発生する場合は、トラックタグにsetupタグがあるかどうかを確認してください。セットアップタグはトラックタグを遅らせることがあります。そのため、データレイヤー変数が最新の値で上書きされた後に、トラックタグがその変数を読み取ることになります。setup タグを削除するとこの問題は解決するはずです。

重大な変更点のチェックリスト

ページビューイベントの名前とプロパティ

新しいテンプレートは、デフォルトのページビューイベントを変更して[Amplitude]プレフィックスを含めます。古いページビューイベントを引き続き使用するには、Use legacy page view propertiesチェックボックスをオンにします。 詳細については、表を参照してください。

• - イベント名: Page View; - プロパティ: page_location, page_path, page_title. page_url
  • 現在:
    • イベント名: [Amplitude] Page Viewed.
    • プロパティ: [Amplitude] Page Domain, [Amplitude] Page Location, [Amplitude] Page Path, [Amplitude] Page Title, [Amplitude] Page URL.

サブドメインアトリビューション追跡

あるサブドメインから別のサブドメイン (experiment.amplitude.comなど) へのトラフィックはデフォルトでは追跡されません。analytics.amplitude.com 他のサブドメインではなく、location.hostname でのアトリビューション追跡を除外するには、Track marketing attribution セクションの Exclude Referrers 入力項目に文字列値 location.hostnameを追加します。 詳細については、表を参照してください。

ユーザーエージェントパーサー

新しいテンプレートはデバイス関連情報を解析する方法を変更します。これにより、OS、デバイスタイプ、デバイスファミリ（event.os_name、event.os_version、event.device_model、event.device_manufacturer）、および関連プロパティの値に影響を与える可能性があります。ユーザー エージェントを解析するために古い方法を引き続き使用するには、この(Legacy) Enable client side user agent enrichmentチェックボックスをオンにします。 詳細については、表を参照してください。