AdGuild Ad Report Dashboard

1. Purpose of the Application

AdGuild Ad Report Dashboard is an internal business dashboard application developed and operated in-house by ADGUILD, K.K. (Kabushiki Kaisha AdGuild), a Japan-based performance-marketing company, to streamline our own Google Ads operations. ADGUILD runs a pay-per-click (PPC) affiliate-marketing business: we create and operate landing pages for advertisers' products, drive traffic to them with Google Ads (Search, Performance Max, and Demand Gen campaigns), and earn performance-based commissions. We operate approximately 30 Google Ads sub-accounts under our Manager Account (MCC 370-641-8337).

The dashboard uses the Google Ads API to (1) automatically ingest advertising performance reports for all sub-accounts, and (2) let our internal staff perform routine, day-to-day account operations — which we currently do by hand in the Google Ads UI — from a single audited interface. It replaces our legacy Google Ads Scripts setup, removing the 30-minute execution limit and adding structured error handling, CI/CD integration, and a consolidated dashboard the whole team can reference.

2. Screenshots

The dashboard is already in production for reporting (currently fed by Google Ads Scripts). The screenshots below are from the live system.

3. Main Features

3.1 Reporting (read-only)

• Automatic daily ingestion of campaign, ad-group, and Performance Max performance metrics (impressions, clicks, conversions, cost, impression share, etc.)
• Seven detail reports: keywords / search terms / ads / RSA assets / assets (extensions) / age / gender
• Cross-account views over all sub-accounts under our MCC; monthly, weekly, and custom date ranges
• Cross-platform comparison with Yahoo! JAPAN Ads, Meta Ads, and Microsoft Ads
• Change Events audit-log view of configuration changes

3.2 Account operations (write)

All of the following are routine tasks our staff currently perform manually in the Google Ads UI. The dashboard lets them run the same operations from one place, with every write audit-logged:

• Creating new sub-accounts under our MCC
• Creating conversion actions
• Sending user-access invitations from the MCC (restricted to a fixed, pre-defined list of internal email addresses)
• Creating rule-based remarketing audience lists (RuleBasedUserList only)
• Changing campaign daily budgets
• Changing campaign bidding strategies and statuses
• Managing negative-keyword lists (create / apply / detach)
• New-campaign wizard (campaign + budget + ad groups + keywords + Responsive Search Ads created in one guided flow)
• Keyword idea generation (KeywordPlanIdeaService, seed-based suggestions)

3.3 Explicitly out of scope

• Customer Match (uploading customer email / phone lists)
• Offline conversion uploads
• App Conversion Tracking and Remarketing API
• Keyword plan forecasts (idea generation only)
• Auto-applying Google recommendations

4. Who Uses It

This application is used only by ADGUILD employees and directly contracted analysts (currently 5–10 people). It is never exposed to clients, external vendors, or the general public. Access is controlled by multiple layers:

• Invited-email whitelist (no profile is created without a pre-registered email, even after a successful Google login)
• Role-based access control (admin / editor / viewer)
• Per-operation permission matrix for every write operation
• PostgreSQL Row-Level Security (per-account scoping)

5. Architecture

• Frontend Static SPA hosted on Cloudflare Pages
• Auth Google OAuth via Supabase Auth
• Database Supabase (PostgreSQL) + Row-Level Security
• ETL Workers Cloudflare Workers Cron + GitHub Actions
• Ads API Google Ads API (Basic Access), reporting + the limited write operations listed above

6. Data Handling

• We retrieve aggregated advertising performance metrics only. No end-user personal information is collected.
• We never upload personal data (emails, phone numbers, etc.) through the Google Ads API — no Customer Match.
• Retrieved data is used only inside our own Supabase database and is never shared with third parties.
• API credentials (developer token, OAuth client ID/secret, refresh token) are stored exclusively in Cloudflare Workers / GitHub Actions secret storage — never in our frontend or database.

7. Privacy Policy / Contact

Our privacy policy is available at https://ad-guild.jp/privacy.html. For inquiries about this application or our use of the Google Ads API, contact us at info@ad-guild.jp.

1. アプリの目的

AdGuild Ad Report Dashboard は、株式会社アドギルドが自社の Google 広告運用を効率化するために社内で開発・運用する内部業務用ダッシュボードアプリケーションです。当社は PPC アフィリエイト広告事業（広告主商品の紹介ページを制作し、Google 広告で集客して成果報酬を得る事業）を営んでおり、Google 広告マネージャーアカウント（MCC 370-641-8337）配下で約 30 個のサブアカウントを運用しています。

本アプリは Google Ads API を用いて、(1) 全サブアカウントの広告パフォーマンス レポートの自動取得、(2) 現在 Google 広告 UI 上で人手で行っている日常的な広告運用オペレーションのダッシュボード化を行います。既存の 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 利用に関するお問い合わせは、下記までご連絡ください。