📘 広告 API 連携ガイド

siranui.ai をご利用いただく際、お客様ご自身で準備・入力いただく項目と、その取得方法をまとめています。Yahoo / Microsoft の API アプリケーション登録（Client ID 等）は当サービス側で行うため、お客様が発行する必要はありません。

お客様が入力しないもの： Yahoo! 広告・Microsoft 広告の Client ID / Client Secret、リダイレクト URI の登録作業。これらは siranui.ai が管理します。

一覧表

媒体 お客様の準備 画面での操作
Google 広告 開発者トークン、顧客 ID（MCC または CID） 手入力（利用開始 Step2 / マイページ）
Yahoo! 広告 ビジネス ID での認可、アカウント ID 「認証連携」ボタン ＋ ID 入力
Microsoft 広告 Microsoft アカウントでの認可、Customer ID 「認証連携」ボタン ＋ ID 入力

🌐 Google 広告

必要なもの

  • 開発者トークン（Developer Token） — Google Ads API 利用に必須
  • 顧客 ID — MCC（管理アカウント）または個別 CID（10桁）

取得手順

  1. MCC（管理用アカウント）にログイン
  2. ツールと設定 → 設定 → API センター を開く
  3. 表示されている開発者トークンをコピー
  4. 連携する顧客 ID を確認（アカウント選択メニューまたは MCC 配下一覧）
  5. siranui.ai の連携画面に入力して保存
開発者トークンはスタンダードアクセス（または基本アクセス）が必要です。「テストアクセス」のみでは本番アカウントに API アクセスできません。

参考: Google Ads API — 開発者トークン

🔴 Yahoo! 広告

必要なもの

  • ビジネス ID による認可 — 画面の「Yahoo! 広告と認証連携」から OAuth で承認（キーの手入力は不要）
  • Account ID — 検索広告・ディスプレイ広告それぞれのアカウント ID

連携手順

  1. 利用開始ウィザード Step2、マイページ、またはアカウントグループ設定で「認証連携」をクリック
  2. ポップアップで Yahoo! ビジネス ID にログインし、アプリ利用を承認
  3. 「✅ 認証済み」と表示されたら認可完了
  4. Yahoo! 広告管理画面で Account ID を確認し入力（検索: 7桁程度 / ディスプレイ: 10桁・100始まり）
各広告アカウントは、承認したビジネス ID に紐づくもののみ操作できます。別法人のビジネス ID のアカウントには、その ID で再度認証が必要です。

参考: LINEヤフー広告 API — 認可認証

🟢 Microsoft 広告

必要なもの

  • Microsoft アカウントでの認可 — 「Microsoft 広告と認証連携」ボタンから OAuth で承認
  • Customer ID — Microsoft 広告管理画面のアカウント ID

連携手順

  1. 連携画面で「Microsoft 広告と認証連携」をクリック
  2. Microsoft 広告にログインし、アクセス許可を承認
  3. Customer ID を確認して入力
Developer Token は siranui.ai 側で管理します。お客様が Microsoft 開発者ポータルから取得する必要はありません。

参考: Microsoft Advertising — OAuth 認証

連携の流れ（共通）

  1. アカウント登録後、利用開始ウィザードで媒体を選択
  2. Step2 で Google は開発者トークン＋ID を入力 / Yahoo・Microsoft は認証ボタンで承認
  3. アカウント ID を指定し連携を保存
  4. マイページでエージェント契約後、各機能をご利用ください

よくあるトラブル