店舗チェーン向け広告運用 BI SaaS

複数店舗を持つチェーン事業者向けの広告運用 BI SaaS。Meta / Google / Yahoo! の数字を一画面に集約し、店舗別 KPI と CAC を横並びで可視化する。

ダッシュボードで分析するだけでなく、キャンペーン作成・停止・複製まで BI 上から完結する。Meta は Marketing API で即時公開、Google は『Umbrella 方式』で Apps Script から自動配信する独自設計。

出発点は『各媒体の管理画面を渡り歩きながら週次レビュー資料を作る』運用の限界。媒体ごとに数字の出方が違い、店舗別の意思決定まで降りるのにラグが大きい。これを 1 画面に集約し、配信操作までその場でできるようにする、というのが原点。

技術的にも運用設計でも、定説の通りにいかなかった箇所が多い。以下はその試行錯誤の記録。

■ 画像アップロードの罠 — Meta の /adimages は URL で渡せるはずが、外部画像ホストへのクローラのアクセス制約に何度もぶつかった。最終的に server-side で画像バイトを取得し multipart/form-data で送る方式に書き直し。

■ 通貨単位の罠 — Meta API は通貨ごとに『最小単位』が異なる。USD はセント単位で 100 倍、JPY は 0 桁通貨で 100 倍不要。当初 100 倍して『予算 100 倍盛り』のキャンペーンを 1 件作ってしまい、即停止して仕様を読み直した。

■ 所有関係の罠 — Page / Pixel / 広告アカウントが Business Manager 配下に揃っていないと、エラーメッセージがほぼ無意味な数字コードで返ってくる。BM の所有検証ロジックを BI 側に内蔵し、現場が踏み抜く手数を最小化した。

■ Token モードの罠 — User Token は短命、しかも App が Development モードだと配信できない。Live モード + System User Token の組み合わせに辿り着くまで、何度もエラーコードを掘り下げた。

■ Google の Dev Token 問題 — Google Ads API は Dev Token 申請が必須で、審査も厳しい。Token なしで自動配信する方法を探索し、最初は『BI で承認 → 人が Google Ads UI で作成』という human-in-loop を実装したが、20 手順の手動コピペで現場が回らないと判明、廃案。

■ Umbrella 方式の発見 — Apps Script の AdsApp.newCampaignBuilder() は存在しないが、Campaign.newAdGroupBuilder() は存在する。これを使って『クライアント毎に親キャンペーンを 1 つだけ手動作成、BI から作成されたキャンペーンは Apps Script が広告グループとして自動生成』というアーキテクチャに辿り着いた。Dev Token なしで広告グループ単位の完全自動化が成立。

■ 将来の Dev Token 取得への布石 — 全アクションは MCP の統一インターフェースで隠蔽し、`google_routing` フラグを切り替えるだけで API 直叩きに移行できる future-proofing を入れている。

いま試行錯誤しているのは、100 社規模でのオンボーディング工数（現状 30〜45 分 / 社）の削減、Apps Script に置いている認証情報の最小化、複数クライアント階層の権限設計まわり。

現在はアンカー顧客で本番運用しながら、横展開フェーズ。中期では数千店舗規模の業種横断 BI 基盤を目指す。