📘 広告 API 連携ガイド

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

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

一覧表

媒体 お客様の準備 画面での操作
Google 広告 顧客 ID（MCC または CID）、操作権限のある Google アカウント ID 入力 ＋「Google 広告と認証連携」
Yahoo! 広告 ビジネス ID での認可、アカウント ID 「認証連携」ボタン ＋ ID 入力
Microsoft 広告 Microsoft アカウントでの認可、Customer ID 「認証連携」ボタン ＋ ID 入力

🌐 Google 広告

必要なもの

  • 顧客 ID — MCC（管理アカウント）または個別 CID（10桁）
  • Google アカウントでの OAuth — そのアカウントを操作できる権限での認可

連携手順

  1. 連携する顧客 ID（10桁）を確認（アカウント選択メニューまたは MCC 配下一覧）
  2. siranui.ai の連携画面で ID を入力する
  3. 「Google 広告と認証連携」から OAuth で認可する
開発者トークンは運営側のものを使用するため、お客様による入力は不要です。

🔴 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 で各媒体の ID を入力し、認証連携ボタンで OAuth 承認する
  3. アカウントを選択し連携を保存する
  4. エージェント契約後、各機能をご利用ください（操作全体は ユーザーマニュアル）

よくあるトラブル