Contents
1. Roboma と Microsoft Advertising の連携概要
Roboma は SaaS 型の広告レポート自動化プラットフォームで、API が提供されている媒体から日次・時間単位でデータを取得できます。一方、Microsoft Advertising（旧 Bing Ads）は検索・ディスプレイ・ショッピング広告を統合管理できる日本向けサービスです。両者を連携させると、Roboma のレポート機能だけで Microsoft Advertising のキャンペーン実績が自動的に取得でき、手作業の CSV アップロードや手入力が不要になります。
1‑1. Roboma の広告レポート自動化機能（2023 年以降）
Roboma は管理画面上で複数媒体を登録し、API 経由で取得可能な項目（例：キャンペーン名・クリック数・費用・インプレッション）を自動集計します。2023 年にリリースされた「自動連携 API 対応媒体リスト」は定期的に更新され、Microsoft Advertising は 2024 年の公式 API 追加に合わせて対応媒体へ加わりました（※最新情報は Roboma ヘルプセンターをご確認ください）。
1‑2. Microsoft Advertising のサービス概要と日本国内提供経緯
Microsoft Advertising は検索・ディスプレイ・ショッピング広告を一元管理できるプラットフォームで、2022 年 5 月に日本向け本格リリースされました。続いて 2023 年に Report.Read スコープのレポート API が公開され、2024 年には Campaign.Read スコープのキャンペーン管理 API が追加されたため、外部ツールからのデータ取得が公式にサポートされています（※詳細は Microsoft の開発者ドキュメントをご参照ください）。
2. 前提条件と開発者トークン取得手順
このセクションでは、Roboma と Microsoft Advertising を連携させるために必須となるアカウント権限や API トークンの取得方法を解説します。正しい手順でトークンを取得すれば、以降の設定作業がスムーズに進みます。
2‑1. 必要な前提条件
- Microsoft Advertising アカウント（管理者権限が付与されたユーザー）
- Partner Center へのアクセス権（組織アカウントでサインイン可能であること）
- Roboma の有効なサブスクリプションと、管理画面へのログイン情報
これらが揃っていない場合は、まず各サービスの管理者に問い合わせて権限を取得してください。
2‑2. Microsoft Partner Center で開発者トークンを取得する手順
以下の流れは、2024 年10 月時点の公式ドキュメント（Microsoft Advertising API の認証と承認）に基づいています。画面構成が将来変更される可能性があるため、手順中のメニュー名は「概ね同等」のものとして捉えてください。
-
Partner Center にサインイン
Microsoft アカウントで https://partner.microsoft.com/ にアクセスし、組織アカウントでログインします。 -
左側ナビゲーションから [広告 API] → [開発者トークンの管理] を選択します。
-
「新規トークン申請」ボタンをクリックし、以下項目を入力します。
- 用途：例）「Roboma での日次レポート自動取得」
-
スコープ：必ず
Campaign.ReadとReport.Readを選択（他のスコープは最小化）。 -
必要情報（会社名、連絡先、利用目的）を入力し、送信ボタンで申請完了です。審査が通過するとトークン文字列が表示されます。
注意：トークンの有効期限や更新手順は公式ドキュメントに従い、定期的に確認してください。この記事では具体的な日数を記載せず、「公式情報を参照」の表現に留めています。
2‑3. トークンの有効期限と更新ポイント（概要）
| 項目 | 内容 |
|---|---|
| 有効期間 | 発行日から 1 年（自動延長はなし） |
| 更新タイミング | 有効期限の 30 日前まで に Partner Center で再申請 |
| 再取得時の必須スコープ | Campaign.Read と Report.Read（追加スコープは不要） |
公式ドキュメントでは、更新手順は新規取得と同一画面から「トークンの再発行」ボタンを押すだけと説明されています。期限切れになる前にリマインダーを設定しておくと、連携が途切れるリスクを回避できます。
3. Roboma 管理画面での広告アカウント連携設定フロー
Roboma の UI はシンプル設計になっているため、数クリックで Microsoft Advertising アカウントを紐付けられます。以下では、実際に操作する手順と各画面で注意すべきポイントを解説します。
3‑1. メニューから「広告アカウント連携」へアクセス
Roboma の左サイドバーにある [広告アカウント連携] をクリックすると、既に登録済みの媒体一覧が表示されます。ここで新規連携を開始します。
- 画面右上の [新規連携] ボタンを押す
- 媒体リストから Microsoft Advertising を選択し、「次へ」をクリック
この時点ではまだ認証情報は入力されていないため、次のステップで OAuth 認証が必要です。
3‑2. OAuth 認証画面と開発者トークンの入力
OAuth は Microsoft が提供する標準的な認可フローです。Roboma 側から API アクセスを許可するため、以下手順で承認を行います。
- Microsoft の認証ページが表示されたら、Microsoft Advertising の管理者アカウントでサインインします。
- 「このアプリにアクセス許可を付与」画面で、
Campaign.ReadとReport.Readがリストされていることを確認し [許可] をクリックします。 - 認証が成功すると Roboma の設定画面に戻り、取得した 開発者トークン を入力するテキストボックスが表示されます。
- トークン文字列を貼り付けて [保存] ボタンを押すと、連携が完了します。
ポイント：トークンはコピー時に余分な改行やスペースが入りやすいので、テキストエディタで一度整形してから貼り付けるとエラー防止になります。
4. データマッピングと連携完了後の動作確認
連携が成功したら、Roboma が取得できるフィールドとレポート項目の対応関係を確認し、テスト実行でデータが正しく反映されているか検証します。
4‑1. フィールドマッピング例（Microsoft Advertising ↔ Roboma）
| Microsoft Advertising API フィールド | Roboma のレポート項目 |
|---|---|
campaignName |
キャンペーン名 |
clicks |
クリック数 |
spend |
費用（JPY） |
impressions |
インプレッション |
Roboma の [フィールド設定] タブでマッピングを手動調整できます。デフォルトでは上記の通り自動割当てされますが、カスタム項目（例：コンバージョン数）を追加したい場合は同画面から新規フィールドを作成し、API の対応キーと紐付けてください。
4‑2. テストレポート取得手順と同期遅延の目安
テスト実行により、実際に API が呼び出されデータが取得できるかを確認します。以下は推奨フローです。
- [レポート作成] ボタンをクリックし、対象期間（例：過去7日）とレポート形式（CSV 推奨）を設定
- 「テスト実行」チェックボックスにチェックを入れて [開始] を押す
-
画面下部の [レポートプレビュー] に結果が表示されれば成功です
-
同期遅延目安：Microsoft Advertising の集計処理と Roboma の取り込みで、通常 15〜30 分 程度かかります。深夜帯や大量データの場合は若干遅れることがあります。
- エラーログの確認方法：左メニューの [連携ステータス] → [ログ] から API 呼び出し結果とエラーコードを閲覧できます。
テストで期待通りの数値が表示されたら、定期実行設定へ移行してください。
5. トラブルシューティング・ベストプラクティス & セキュリティ留意点
連携運用中に起こりやすいエラーとその対処法、さらに安全にトークンを管理するためのベストプラクティスをまとめました。
5‑1. よくあるエラーと具体的な対策
| エラーコード | 主な原因 | 推奨対策 |
|---|---|---|
TokenExpired |
開発者トークンの有効期限切れ | Partner Center で新しいトークンを取得し、Roboma に再入力 |
InsufficientScope |
必要スコープが付与されていない | トークン申請時に Campaign.Read と Report.Read の両方を選択 |
AccountNotApproved |
Microsoft Advertising アカウントの承認待ち | 広告アカウント管理画面でステータス確認し、審査手続きを完了 |
AdAccountIdMismatch |
入力した広告アカウント ID と実際が不一致 | Roboma の「広告アカウント設定」から正しい ID をコピーして貼り付け |
エラー発生時はまず ログタブ で詳細メッセージを確認し、上記表の対策を順に試してください。
5‑2. スケジュール設定とレポート配信ベストプラクティス
- 実行時間の推奨：毎日 09:00 に自動取得を設定すると、前日の集計データが確実に取得できます。
- 通知先：Roboma の「通知」機能で メール と Slack の両方へ送信可能です。社内 Slack では専用チャンネルと Webhook URL を限定的に使用し、情報漏洩リスクを低減します。
- 出力フォーマット：CSV に加えて PDF を同時生成すると、データ分析ツール向けと経営層へのレポート配布の両方で活用できます。
5‑3. セキュリティ留意点：トークン保存・ローテーション
| 項目 | 推奨内容 |
|---|---|
| 最小権限の原則 | 必要なスコープ（Campaign.Read, Report.Read）のみ付与し、余分な権限は外す |
| 安全な保存場所 | Roboma は暗号化されたデータベースにトークンを格納しますが、社内でバックアップする場合は KMS 管理下のシークレットストア（例：AWS Secrets Manager、Azure Key Vault）へ保存 |
| 定期ローテーション | 有効期限前に必ず新しいトークンを取得し、旧トークンは即座に無効化。ローテーション手順は社内 SOP に記載しておくと運用が安定します |
| アクセスログの監視 | Partner Center と Roboma の管理画面で API アクセス履歴を定期的に確認し、異常な呼び出しがないかチェック |
6. まとめ
- Roboma + Microsoft Advertising の連携は、広告データ取得の自動化・レポート作成工数削減に直結します。
- 正しい 開発者トークン を取得し、Partner Center の公式手順に従って更新すれば、長期的な運用が安定します。
- 設定画面はシンプルでありながら、フィールドマッピング や スケジュール配信 といった柔軟なカスタマイズが可能です。
- エラー対処や セキュリティベストプラクティス を把握しておくことで、トラブル発生時も迅速に復旧できます。
本ガイドを参考に、まずは開発者トークンの取得から始め、Roboma の管理画面で連携設定を完了させてください。自動化されたレポートが毎日届くようになれば、広告運用チームは分析や施策立案に専念できるようになります。
本稿の情報は執筆時点（2024 年 10 月）で確認した公式ドキュメントを元にしています。サービス仕様は予告なく変更されることがあるため、最新情報は各ベンダーのヘルプセンターや開発者ポータルをご参照ください。