giip

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/ 接頭辞を保持)。

🛠️ プロパティ管理

ページは常に**現在の組織(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

← PreviousCQE スクリプト管理Next →GA分析レポート