1. アプリの目的
AdGuild Ad Report Dashboard は、株式会社アドギルドが自社の Google 広告運用を効率化するために社内で開発・運用する内部業務用ダッシュボードアプリケーションです。当社が Google 広告マネージャーアカウント（MCC）配下で運用する約 30 個のサブアカウントに対して、Google Ads API を用いた広告パフォーマンス レポートの自動取得と、日常的な広告運用オペレーションの自動化を行います。
本アプリは既存の Google Ads Scripts による運用を置き換えることで、レポート取得の実行時間制限（30 分）を撤廃し、構造化されたエラーハンドリング・CI/CD 統合・チーム全員が参照できる集約ダッシュボードを実現することを目的としています。
2. 主な機能
2.1 広告パフォーマンス レポート機能
- キャンペーン、広告グループ、Performance Max キャンペーンの日次パフォーマンス メトリクス（表示回数、クリック、コンバージョン、費用、インプレッション シェア等）の自動取得
- 詳細レポート 7 種類の取得（キーワード / 検索語句 / 広告 / RSA アセット / 表示オプション / 年齢 / 性別）
- MCC 配下全サブアカウントの横断表示、月次・週次・任意期間の集計
- Yahoo! 広告、Meta 広告、Microsoft 広告と統合したクロスプラットフォーム比較ビュー
- 広告設定の変更履歴（Change Events）の監査ログ表示
2.2 広告運用オペレーション機能
下記はすべて、現在は Google 広告 UI 上で人手で行っている日常業務を、社内スタッフが本ダッシュボード内から実行できるようにするものです。
- MCC 配下へのサブアカウント新規作成
- コンバージョン アクションの新規作成
- MCC からのユーザー アクセス招待の発行（当社が事前に定義した固定リストの社内メールアドレス宛のみ）
- Rule-based 型のリマーケティング用オーディエンス リスト（RuleBasedUserList）の作成
- キャンペーンの日予算の変更
- キャンペーンの入札戦略・ステータスの変更
- 除外キーワード リストの追加・適用・解除
- 新規キャンペーンの作成ウィザード（キャンペーン + 予算 + 広告グループ + 検索キーワード + Responsive Search Ads を 1 つのウィザードで一括作成）
- キーワード アイデア生成（Google のキーワード プランナー相当のシード語からの関連キーワード提案）
2.3 明示的にサポートしない機能
本アプリは以下の機能はサポートしません。将来必要になった場合は Google Ads API チームに対して用途変更申請を提出します。
- Customer Match（顧客リストのメール／電話番号アップロード）
- オフライン コンバージョンのアップロード
- アプリ コンバージョン計測（App Conversion Tracking and Remarketing API）
- キーワード プランのフォーキャスト（予測メトリクス取得）
- Google 推奨事項の自動適用
3. 利用対象者
本アプリは 株式会社アドギルドの従業員および直接契約のアナリスト（現在 5〜10 名）のみ が利用します。クライアント、外部ベンダー、一般公開ユーザーには一切公開しません。
アクセス制御は次の複数レイヤーで厳格に管理されます:
- 招待制メール ホワイトリスト（未登録のメールアドレスからは Google ログイン成功後もプロファイル作成不可）
- ロール別アクセス制御（管理者 / 編集者 / 閲覧者）
- 各書き込みオペレーションごとの権限マトリクス
- PostgreSQL Row-Level Security（アカウント単位のスコーピング）
4. 技術構成
- Frontend 静的 SPA（Cloudflare Pages ホスティング）
- Auth Supabase Auth 経由の Google OAuth
- Database Supabase（PostgreSQL）+ Row-Level Security
- ETL Workers Cloudflare Workers Cron + GitHub Actions
- Ads API Google Ads API（Basic Access）、read + 限定的な write オペレーション
5. データの取り扱い
- 取得するのは広告パフォーマンスの集計値のみ。エンドユーザーの個人情報は取得しません。
- Customer Match など、顧客のメール・電話番号などの個人データを Google Ads API 経由でアップロードすることはありません。
- 取得したデータは当社の Supabase データベース内でのみ利用し、第三者に共有しません。
- Google Ads API へのアクセスに用いる認証情報（Developer Token、OAuth Client ID/Secret、Refresh Token）は当社 Cloudflare Workers / GitHub Actions のシークレット領域にのみ保管され、当社のフロントエンドやデータベースには一切保存しません。
6. プライバシー ポリシー
本アプリおよび当社のサービス全般に関するプライバシー ポリシーは こちら をご覧ください。
7. お問い合わせ
本アプリまたは当社の Google Ads API 利用に関するお問い合わせは、下記までご連絡ください。