GAプロパティ管理ガイド

組織のGA4プロパティを登録・管理し、GIIPで収集・分析・表示できるようにします。

🔗 GAプロパティ管理を開く →

📋 概要

GIIPはGoogle Analytics 4(GA4)の指標をプロパティ単位で収集します。データを収集・表示するには、各GA4プロパティをこのページで組織(CSN)に登録する必要があります。1つの組織に複数登録できます。

🔑 管理できる人

組織(CSN)に所属するユーザーは、その組織のGAプロパティを閲覧・管理できます。権限はサーバー側で強制され、専用の管理者ロールは不要です。

🧭 GA4プロパティIDの確認

1. Google Analytics → 管理(歯車)。
2. プロパティ の プロパティの詳細 を開く。
3. プロパティID(例: 123456789)をコピー。
4. GIIPには properties/123456789 の形式で入力(properties/ 接頭辞を保持)。

⚠️ プロパティIDと測定IDは別物です — 混同しやすい点

GA4には名前が似ている2つのIDがありますが、用途がまったく違います。

	プロパティID	測定ID
形式	純粋な数字(例: 123456789)	G-で始まる文字列(例: G-RD96JF3S6Q)
確認場所	管理 → プロパティ → プロパティの詳細	管理 → データストリーム → 該当のウェブストリームをクリック
使われる場所	GIIPの「GAプロパティ」入力欄(properties/<数字> 形式)。GIIPの収集エージェントがGA4 Data APIを呼び出す際に使用。	サイトに埋め込むgtagスニペット(giipv3/src/app/layout.tsx の GA_ID など)。訪問者のブラウザが実際にイベントを送信する際に使用。

両方が同じプロパティを指している必要があります。 1つのプロパティに複数のデータストリームが存在でき、それぞれに測定IDがあります — そのため「プロパティID」だけを見て登録しても、実際のサイトがそのプロパティにデータを送っているかどうかは分かりません。

実際に起きた事例(giip-911/912): GIIPに登録したプロパティIDは正しかったものの、サイトのgtag測定IDが別の(古い)プロパティを指していたため、GIIPが参照するプロパティにはそのサイトのトラフィックが一切入っておらず、無関係なサイトのページデータが表示されていました。確認手順:

1. GIIPに登録したプロパティID(properties/<数字>)を確認。
2. GA4でそのプロパティのデータストリーム → 測定IDを確認。
3. サイトのソースにあるgtag測定ID(layout.tsx の GA_ID または NEXT_PUBLIC_GA_ID 環境変数)と一致するか照合。
4. 異なる場合は、サイト側の測定IDをそのプロパティのものに変更するか、GIIPの登録をサイトが実際に送信しているプロパティに変更します。

🛠️ プロパティ管理

ページは常に**現在の組織(CSN)**を対象とし、タイトル横に表示されます。

追加

1. GAプロパティ(例: properties/123456789)を入力。
2. 任意でラベル(例: マーケティングサイト)を入力。
3. 追加 をクリック → 下の一覧に表示。

編集

1. 行の 編集 をクリック → フォームに値が入ります。
2. ラベル(またはプロパティID)を変更し 更新。キャンセルで中止。

削除

行の 削除 をクリックして確認。登録のみ削除され、収集済み指標は削除されません。

🔐 GA4サービスアカウントキーの登録(giip-803)

実際の収集(GA収集パイプライン ページの [収集開始] ボタン)を動作させるには、各プロパティにGA4サービスアカウントキーが登録されている必要があります。サーバーに事前にファイルを配置する必要はなく、この画面で直接入力すればDBに安全に保存され、収集器が実行時に自動で取得して使用します。

1. Google Cloud Consoleでサービスアカウントを作成し、JSONキーをダウンロードします。
2. GA4管理画面(プロパティのアクセス管理)で、そのサービスアカウントに**閲覧者(Viewer)**権限を付与します。
3. ダウンロードしたJSONファイルの内容をそのままコピーし、GA4サービスアカウントキー(JSON) 欄に貼り付けます。
4. 追加/更新 をクリック — 保存後、一覧のキー状態列が登録済みに変わります。

• キーを入力せずラベルだけ変更しても、既存のキーはそのまま保持されます。
• 一覧にキーの内容が再表示されることはありません(「登録済み」/「未登録」のみ表示)。置き換えるには新しいJSONを貼り付けてください。

🔗 次のステップ

• 登録したプロパティは GA分析レポート のドロップダウンで選択できます。
• 収集エージェントは登録済みプロパティのみ指標を送信できます(未登録は403拒否)。
• GA収集パイプライン ページの [収集開始] ボタンで即座に収集をトリガーできます(サービスアカウントキーの登録が必要)。

🧩 フィールド

フィールド	意味
GAプロパティ	GA4リソース名 properties/<id>。組織内で一意。
ラベル	一覧での識別用の自由テキスト。
状態	有効/無効。無効は保持されるが収集しない。
GA4サービスアカウントキー(JSON)	収集器がGA4 Data API呼び出しに使う認証キー。保存後は画面に再表示されません。
キー状態	登録済み/未登録 — 一覧専用の表示(キー本体ではありません)。

トラブルシューティング

症状	原因	解決
「組織(CSN)が選択されていません」	セッションに有効な組織がない	上部でプロジェクト/組織を選択して再表示。
「この組織への権限がありません」	その組織のメンバーでない	管理者に追加を依頼、または所属組織に切替。
GAレポートにプロパティが出ない	未登録または別組織	正しい組織でここから登録。
収集器が403を返す	プロパティID未登録	正確な properties/<id> を先に登録。
[収集開始] クリック時に「この組織にはまだGA収集機が登録されていません」	このプロパティにサービスアカウントキーが未登録	上記「GA4サービスアカウントキーの登録」の手順でキーを貼り付け。
キー入力時に「正しいJSON形式ではありません」	貼り付けた内容が完全なJSONでない(一部だけコピーなど)	Googleがダウンロードした .json ファイル全体を再度コピーして貼り付け。

---

バージョン: 1.1 最終更新: 2026-07-29 ソースファイル: giipv3/public/help/ga-property.ja.md