Google タグマネージャー（GTM）の連携
Google タグマネージャーを連携すると、エージェント（MCP）が GTM のタグ・トリガー・変数を確認・編集し、頼めばバージョンを公開できるようになります。「GA4 の購入イベントタグを追加して公開して」のような計測まわりの作業を、GTM の画面を開かずに頼めます。広告媒体ではありませんが、連携の場所は他の媒体と同じ「アカウント連携」画面です。
| 項目 | 内容 |
|---|---|
| 認可スコープ | tagmanager.readonly / tagmanager.edit.containers / tagmanager.edit.containerversions / tagmanager.publish（参照・編集・バージョン作成・公開）と、連携したアカウントを表示するための userinfo.email |
| OAuthクライアント | アプリに設定済み（環境変数。Google広告・Gmail の連携と同じもの。選ぶ操作はありません） |
| 用意するもの | 操作したい GTM コンテナにアクセスできる Google アカウント（公開までさせるなら GTM 側で公開権限） |
重要
連携は 2段階です。マイページで GTM を連携しただけでは、エージェントはまだ何も操作できません。プロジェクトの「アナリティクス」画面で、操作するコンテナを1つ選んで保存するところまで行ってください（手順D）。エージェントはそこで選んだコンテナしか操作しません。
手順A【GCP】Tag Manager API を有効にする
アプリに設定された OAuth クライアント（環境変数）が属する GCP プロジェクト — Google広告の連携で使っているプロジェクト — で Tag Manager API を有効にします。
- GCP コンソールで対象のプロジェクトを開きます。
- 「API とサービス > ライブラリ」で Tag Manager API を検索し、「有効にする」を押します。
注意
Tag Manager API が有効になっていないと、連携はできても、アナリティクス画面でコンテナの一覧を取得できません。
手順B【GCP】同意画面にスコープを足す
- 「API とサービス > OAuth 同意画面 > データアクセス（スコープ）」を開きます。
- 「スコープを追加または削除」で、次の5つを追加して保存します。
https://www.googleapis.com/auth/tagmanager.readonlyhttps://www.googleapis.com/auth/tagmanager.edit.containershttps://www.googleapis.com/auth/tagmanager.edit.containerversionshttps://www.googleapis.com/auth/tagmanager.publishhttps://www.googleapis.com/auth/userinfo.email
手順C【GCP】公開ステータスを確認する
「OAuth 同意画面 > 対象（Audience）」の公開ステータスが**テスト（Testing）のままだと、認証が 7日で切れます（毎週「再認証が必要」になります）。継続して使うなら本番（In production）**にしてください。Google広告や Gmail の連携ですでに本番になっていれば、確認するだけで構いません。詳しくは Gmail の連携の手順C と同じです。
手順D【アプリ】GTM を連携し、プロジェクトでコンテナを選ぶ
D-1. マイページで連携する
- 「アカウント連携」画面の 「Google タグマネージャー」 セクションで 「+ アカウントを連携」 を押します。
- モーダルは確認だけです（OAuthクライアントを選ぶ操作はありません）。
- 操作したいコンテナにアクセスできる Google アカウントでログインし、表示された権限をすべて許可します。
- 戻るとカードにメールアドレスが表示されます。
D-2. プロジェクトで操作するコンテナを選ぶ
- プロジェクトの左ツリーで 「アナリティクス」 を開きます（概要ページ）。
- ページ上部のタブを 「Google タグマネージャー」 に切り替え、「コンテナを選ぶ」を押します。
- 連携アカウントを選ぶと、そのアカウントから見える GTM アカウントとコンテナが出るので、コンテナを選んで**「保存」**を押します。
GA4 をまだ連携していないプロジェクトでも、このカードは表示されます（GTM は GA4 と独立して選べます）。マイページの「アカウント連携 > Google アナリティクス（GA4）」の一覧でも、各プロジェクトで選んだコンテナを確認できます。
エージェントができるようになること
| できること | 内容 |
|---|---|
| 確認 | コンテナ・ワークスペース・タグ／トリガー／変数・組み込み変数・バージョンの一覧と中身、公開中のバージョン |
| 編集（下書き） | ワークスペースの作成、タグ／トリガー／変数の作成・更新・削除、組み込み変数（Click URL など）の有効化・無効化 |
| 公開 | ワークスペースの変更点を確認 → バージョン作成 → 公開。以前のバージョンを公開し直して戻すこともできます |
編集はすべて**ワークスペース（下書き）**の中で行われ、公開するまでサイトには反映されません。
注意
公開はサイトに即時反映されます。 エージェントには「頼まれたときだけ公開する」ように指示してありますが、公開までさせたくない場合は、MCP トークンの「アナリティクス・費用 > Google タグマネージャー」を 参照+編集 に絞ってください（MCP連携）。プロジェクトに自動で作られるエージェントのトークンは、公開まで許可された状態になります。
GA4 の設定も編集させる場合
エージェントは、プロジェクトに連携した GA4 プロパティのキーイベント・カスタムディメンション・カスタム指標・データストリームも作成・更新できます。ただし GA4 の連携は標準では参照のみの権限なので、アナリティクスの概要ページの GA4 連携情報で 「編集権限で再認可」 を押し、編集権限（analytics.edit）を許可してください。GTM の連携とは別の操作です。
うまくいかないときは
- コンテナの一覧が出ない・エラーになる: 手順A（Tag Manager API の有効化）が済んでいません。有効にしたプロジェクトが、アプリに設定された OAuth クライアント（Google広告の連携と同じもの）のプロジェクトかも確認してください。
- 「このアカウントから見えるコンテナがありません」: 連携した Google アカウントが、GTM でそのコンテナのユーザーに追加されていません。GTM の「管理 > ユーザー管理」で追加するか、アクセス権のあるアカウントで連携し直してください。
- 公開だけ失敗する（権限がない）: GTM 側でそのアカウントに公開権限がありません。GTM の「ユーザー管理」でコンテナの権限を「公開」にしてください。
- エージェントが「GTM コンテナが未設定です」と言う: 手順D-2のコンテナ選択が済んでいません。
- エージェントが「権限が不足しています（403）」と言う: MCP トークンに「Google タグマネージャー」の権限が入っていません。自分で発行したトークンは発行し直してください（自動で作られるエージェントのトークンは、エージェントのページを一度開くと補われます）。
- 毎週「再認証が必要」になる: 同意画面が**テスト（Testing）**のままです。手順Cで「本番」に切り替えてください。
- 「再認証が必要」バッジが出た: 同じ手順でもう一度連携します。同じアドレスなら行は増えず、認証情報が上書きされます。
重要
リフレッシュトークン等の認証情報は AES-256-GCM で暗号化して保存され、画面やAPIレスポンスに平文で出ることはありません。連携解除もこの画面から行え、解除すると Google 側のアクセス権も取り消され、プロジェクトのコンテナ選択も外れます。