addashboard-cli 0.8.1 → 0.9.0

package/skills/ad-ops/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ad-ops
-description: ad-dashboard (https://macchiato.site) の webgram CLI 経由で広告を YDA / Meta に半自動入稿する (TikTok は将来対応予定)。発火したら「入稿先アカウント&媒体」→「今回の方式 (HTMLプランナーで手動指定=既定 / 前回の入稿計画を参考にする / チャットで1つずつ聞く)」の順に確定させる。入稿の実体は 2 系統 — 動画・ローカル画像の API 入稿フロー (固定デフォルト + URL 空き番号自動割当 + 一覧 OK 確認、現状 YDA) と、入稿プランナー `ad-planner.html` (YDA / Meta を案件×媒体の統合プルダウンで切替する GUI → 入稿計画JSON → `submit-plan` で dry-run → 本実行)。「広告運用」「広告入稿」「動画入稿」「まとめ入稿」「ASC 入稿」「YDA 入稿」「Meta 入稿」「入稿プランナー」「YDA入稿プランナー」「Meta入稿プランナー」「入稿シート」「TikTok 入稿」「webgram」「ad-dashboard」と言われたら使用。Node.js が入っていれば追加インストール不要 (`npx` 経由)。
+description: ad-dashboard (https://macchiato.site) の webgram CLI 経由で広告を YDA / Meta / Google (Demand Gen) / TikTok (ByteDance) に半自動入稿する。発火したら「入稿先アカウント&媒体」→「今回の方式 (HTMLプランナーで手動指定=既定 / 前回の入稿計画を参考にする / チャットで1つずつ聞く)」の順に確定させる。入稿の実体は 2 系統 — 動画・ローカル画像の API 入稿フロー (固定デフォルト + URL 空き番号自動割当 + 一覧 OK 確認、現状 YDA) と、入稿プランナー `ad-planner.html` (YDA / Meta / Google / TikTok を案件×媒体の統合プルダウンで切替する GUI → 入稿計画JSON → `submit-plan` で dry-run → 本実行)。「広告運用」「広告入稿」「動画入稿」「まとめ入稿」「ASC 入稿」「YDA 入稿」「Meta 入稿」「Google 入稿」「YouTube 入稿」「Demand Gen 入稿」「入稿プランナー」「YDA入稿プランナー」「Meta入稿プランナー」「Google入稿プランナー」「TikTok入稿プランナー」「入稿シート」「TikTok 入稿」「webgram」「ad-dashboard」と言われたら使用。Node.js が入っていれば追加インストール不要 (`npx` 経由)。
 ---
 
 # ad-ops skill (広告運用スキル)
@@ -8,8 +8,9 @@ description: ad-dashboard (https://macchiato.site) の webgram CLI 経由で広
 Google Drive から手動 DL 済みの素材を各媒体に半自動入稿するためのスキル。
 
 - **動画の API 入稿フロー（`submit`）**: 現状 **YDA のみ**。
-- **入稿プランナー（`ad-planner.html` → 入稿計画JSON → `submit-plan`）**: **YDA / Meta 対応**（ヘッダーの「案件 × 媒体」統合プルダウンで切替）。
-- **TikTok / ByteDance**: プランナー・入稿フローともに未対応（汎用 JSON 入稿 `submit --json-file` のみ）。
+- **入稿プランナー（`ad-planner.html` → 入稿計画JSON → `submit-plan`）**: **YDA / Meta / Google / TikTok 対応**（ヘッダーの「案件 × 媒体」統合プルダウンで切替）。
+- **Google (Demand Gen)**: プランナー・dry-run・本実行に対応。**2026-08-23 に実 API での入稿を確認済み**（PAUSED・1キャンペーン）。ただし配信実績はまだ無いので、初回は PAUSED・最小予算から始めて管理画面で目視確認する。詳細は下の「Google (Demand Gen) の対応範囲」を参照。
+- **TikTok / ByteDance**: プランナー・dry-run・本実行に対応（**単一動画のみ**）。**2026-08-23 に実 API を初めて叩き、キャンペーン作成と自動ロールバックまで確認**。広告グループ以降は地域IDの取得手段が無くて未達だったため `regions` を追加した。**配信オン (ENABLE) は backend が拒否する**。詳細は下の「TikTok (単一動画) の対応範囲」を参照。
 
 配置・発火方法・ログイン手順は [cli/README.md](../../README.md) の「初期設定: Skill として配置する」章を参照。
 
@@ -221,7 +222,7 @@ skills/ad-ops/scripts/adops.sh open meta <accountId> campaigns
 
 * `resource` は `campaigns` / `adgroups` / `ads`。**中間層は媒体で語が違う**（YDA=`adgroups` / Meta=`adsets`）が、`adops.sh open` がどちらの表記でも受けて媒体別の正しいURLに変換する（**URLを手で組み立てるとここを間違える**）。複数入稿した場合も一覧を 1 つ開けば十分
 
-* TikTok は将来対応時に `adops.sh open` へ追加する
+* TikTok は `adops.sh open bytedance <advertiserId>` で広告管理画面を開く。**TikTok はキャンペーン / 広告グループ / 広告を URL で指定できない**ため、resource を渡しても同じ画面が開く（画面上のタブで切り替える）
 
 ## 画像入稿フロー（ローカル画像・YDA）
 
@@ -290,13 +291,173 @@ skills/ad-ops/scripts/adops.sh open yda <accountId> campaigns
 
 ## 媒体別の注意
 
-**上記の動画 API 入稿フロー (`submit --video`) の対応は YDA のみ。** Meta は **入稿プランナー経由 (`submit-plan`)** で画像／動画とも入稿できる。TikTok を指定された場合は「未対応」と明示してから相談する。
+**上記の動画 API 入稿フロー (`submit --video`) の対応は YDA のみ。** Meta / Google / TikTok は **入稿プランナー経由 (`submit-plan`)** で入稿する。
 
 | 媒体                     | 動画 API 入稿フロー | 入稿プランナー GUI  | 入稿リンクの粒度               | 備考                                             |
 | ---------------------- | ------------ | ------------ | ---------------------- | ---------------------------------------------- |
 | **YDA**                | ✅ 対応済み       | ✅ 対応済み       | 広告ごと                   | まず YDA から対応 (社内優先順位、名倉さん依頼)                    |
 | **Meta**               | ⏳ 未対応        | ✅ 対応済み (画像/動画) | 広告ごと (まとめ入稿でも広告単位で変わる) | ASC でも広告ごとに個別リンクを設定。**実 API への本入稿 PoC は未実施**    |
-| **TikTok / ByteDance** | ⏳ 将来対応予定     | ⏳ 未対応        | 広告グループ単位で 1 本          | まとめ入稿は 10 本でも 20 本でも入稿リンクは 1 つ (クリエイティブグループ単位) |
+| **Google (Demand Gen)** | ⏳ 未対応 | ✅ 対応済み (画像/動画) | 広告ごと | **実 API での入稿を確認済み**（2026-08-23・PAUSED）。動画は YouTube 動画IDを人が用意する |
+| **TikTok / ByteDance** | ⏳ 未対応     | ✅ 対応済み (単一動画)        | 広告ごと          | **実 API での入稿検証は未了**。**配信オン (ENABLE) は backend が拒否**。動画とカバー画像はアップロード済みIDを使う |
+
+***
+
+## Google (Demand Gen) の対応範囲
+
+**Google 広告の入稿を頼まれたら、まずこの節を読んでから動く。**
+
+### 何ができて、何ができないか
+
+| | 状態 |
+|---|---|
+| プランナーで計画を組む | ✅ できる（統合プルダウンで「Google」を選ぶ） |
+| dry-run で不備を潰す | ✅ できる |
+| **本実行（実際の入稿）** | ✅ **できる**（2026-08-23 に実 API で確認済み）。ただし**配信オン (ENABLED) では入稿できない** — backend が 400 で拒否し、lint も ERROR で止める。**PAUSED で入稿し、管理画面で確認してから手で配信をオンにする**運用。広告が1件も作れなかった CP は自動削除される |
+| 既存キャンペーン・広告グループへの広告追加 | ❌ 未対応。毎回あたらしいキャンペーンを作る形になる |
+| 動画ファイルのアップロード | ❌ 未対応。**Google Ads API には窓口があるが（`YouTubeVideoUploadService`）、使っている Node ライブラリ（Opteo `google-ads-api`）が非対応**。運用者が YouTube へ手で上げ、動画IDを渡す |
+| 参照データの自動取込（`refs-import`） | ❌ 未対応（yda のみ）。アカウントJSONを手で用意する |
+| 管理画面を開く | ✅ `adops.sh open google <customerId> [campaigns\|adgroups\|ads]`。アカウントJSONの `consoleMcc` を使う |
+| 入稿後に状態を確認する | ✅ `webgram list --platform google --resource ads --account-id <id> [--campaign-id <cpId>]`。**キャンペーン / 広告グループ / 広告の status を名前で返す**（PAUSED で入ったかを管理画面を開かずに確認できる） |
+| 画像のローカルパス入稿 | ❌ 未対応。**Google Ads に登録済み IMAGE アセットの `resource_name` を事前に用意する**（Demand Gen 画像広告は CLI のアップロード対象外） |
+| 地域の指定漏れ | ✅ 安全弁あり。**未指定なら日本 (2392) を既定で入れる**（未指定は全世界配信になるため。Meta の JP 既定と同じ） |
+
+### キャンペーン型が Demand Gen 固定な理由
+
+**Google Ads API では動画（VIDEO）キャンペーンを新規作成できない**（公式明記）。API から YouTube 面へ広告を出す経路は Demand Gen だけ。Demand Gen は YouTube / Discover / Gmail / ディスプレイに配信でき、画像広告と動画広告を同じキャンペーンで扱える。
+
+### 事前に用意してもらうもの
+
+戦略壁打ち（フェーズ1）で必ず確認する:
+
+1. **YouTube 動画ID** — 運用者が事前に YouTube へアップロードしておく（動画広告の場合）
+2. **ブランド名** — 広告に表示される広告主名（表示幅25まで）。**Demand Gen では必須**
+3. **ロゴ画像アセット** — Google Ads に登録済み IMAGE アセットの resource_name。**画像広告では必須**（1:1・128x128以上）
+4. **地域** — **指定しないと全世界配信になる**。通常は「日本」
+
+### YDA / Meta との構造の違い
+
+| | Google |
+|---|---|
+| 予算の階層 | **キャンペーン**（YDA と同じ。Meta は広告セット） |
+| 入札 | 目標CPA を入れると tCPA 入札 / 空欄ならコンバージョン数の最大化 |
+| 地域・言語の階層 | **広告グループ**（Demand Gen は広告グループ層に持つ） |
+| 動画広告の必須項目 | 見出し / **長見出し** / 説明文 / ブランド名。**長見出しは動画広告だけが持つ** |
+| 画像広告の必須項目 | 横長 or 正方形画像 / **ロゴ 1-5枚** / 見出し / 説明文 / ブランド名 |
+| accountId | 10桁数値（ハイフン無し）。`act_` は付けない |
+
+### 開発中の CLI で dry-run を試す場合
+
+npm 公開版（`@latest`）にはまだ Google 対応が入っていないため、手元のビルドを使う:
+
+```bash
+cd <repo>/cli && npm run build
+WEBGRAM_CLI="node $PWD/dist/index.js" skills/ad-ops/scripts/adops.sh plan <入稿計画.json>
+```
+
+`adops.sh` の各コマンドは `WEBGRAM_CLI` で CLI を差し替えられる（未設定なら `npx -y addashboard-cli@latest`）。
+
+## TikTok (単一動画) の対応範囲
+
+**TikTok 広告の入稿を頼まれたら、まずこの節を読んでから動く。**
+
+### 何ができて、何ができないか
+
+| | 状態 |
+|---|---|
+| プランナーで計画を組む | ✅ できる（統合プルダウンで「TikTok」を選ぶ） |
+| dry-run で不備を潰す | ✅ できる |
+| **本実行（実際の入稿）** | ⚠️ **できるが実 API で未検証**。**配信オン (ENABLE) は backend が 400 で拒否する**（検証が済むまで）。DISABLE で 1キャンペーン・最小予算から流し、管理画面で目視確認する。広告が1件も作れなかった CP は自動削除される（削除できなければ停止に切り替える） |
+| 単一動画広告 (`SINGLE_VIDEO`) | ✅ 対応 |
+| 画像広告 / カルーセル / Spark Ads | ❌ 未対応 |
+| CV最適化（`WEB_CONVERSIONS` + pixel） | ❌ 未対応。目的は `TRAFFIC`（記事LP誘導）固定 |
+| **動画・カバー画像のローカルアップロード** | ✅ **できる**。広告行の「動画パス」「カバー画像パス」に入れると、本実行の直前に CLI が自動アップロードして ID に解決する（dry-run では上げない）。参照データに登録済みなら番号だけでよい |
+| **入稿後の確認** | ✅ `webgram list --platform bytedance --resource ads --account-id <id> [--campaign-id <id>]`。`operationStatus`（指定したオン/オフ）と `secondaryStatus`（審査・配信の実状態）の**両方**が返る |
+| 既存キャンペーン・広告グループへの広告追加 | ❌ 未対応。毎回あたらしいキャンペーンを作る形になる |
+| 参照データの自動取込（`refs-import`） | ❌ 未対応。アカウントJSONを手で用意する |
+| 管理画面を開く | ✅ `adops.sh open bytedance <advertiserId>`。**キャンペーン / 広告グループ / 広告のURL指定はできない**ので、開いた画面のタブで切り替える |
+| 配信期間 / フリークエンシー | ❌ 未対応（開始時刻は未指定なら 1 時間後になる） |
+
+### 事前に用意してもらうもの
+
+戦略壁打ち（フェーズ1）で必ず確認する:
+
+1. **identity ID と BC ID** — 広告主として表示される TikTok アカウント。**これが無いと広告が作れない**（Meta の FBページID 相当）
+   ```bash
+   webgram list --platform bytedance --resource identities --account-id <advertiserId>
+   ```
+   **本番実測では `BC_AUTH_TT`（Business Center 経由で認可された TikTok アカウント）がほぼ全て**（4アカウントで各14件。`CUSTOMIZED_USER` は 0〜2件）。`BC_AUTH_TT` は **`identityAuthorizedBcId` が必須**なので、`identities` が返す `authorizedBcId` もアカウントJSONに入れる。ID は UUID 形式で数値ではない
+
+2. **地域ID（location_id）** — **TikTok 独自の採番で公開一覧が無い**。決め打ちの値は使えない（`1210023` を送ったら `code=40002 At least 1 location ID is invalid` になった）
+   ```bash
+   webgram list --platform bytedance --resource regions --account-id <advertiserId>
+   # 0 件のときは経路を切り替える / 生の応答を見る
+   webgram list --platform bytedance --resource regions --account-id <id> --mode search
+   webgram list --platform bytedance --resource regions --account-id <id> --raw
+   # 既存の配信中広告グループから逆引きする（最も確実）
+   webgram list --platform bytedance --resource adgroups --account-id <id>
+   ```
+   取れた値をアカウントJSONの `refs.regions`（`{"日本": "<location_id>"}`）に入れる
+2. **動画とカバー画像** — 2 通りある。**`SINGLE_VIDEO` はカバー画像が必須**で、動画だけでは広告を作れない
+   - **登録済みを使う**: アセットライブラリの ID を参照データに入れる
+     ```bash
+     webgram list --platform bytedance --resource resources --account-id <advertiserId>
+     ```
+   - **ローカルファイルを上げる**: 広告行の「動画パス」「カバー画像パス」に入れる（本実行時に自動アップロード）
+3. **動画とカバー画像** — 前述のとおり登録済みIDでもローカルファイルでもよい
+4. **日予算** — 広告グループ階層。上限 1,000,000 円で backend が弾く（桁ミス防止）。**`BUDGET_MODE_DAY` で拒否されたら `BUDGET_MODE_DYNAMIC_DAILY_BUDGET` を試す**（TRAFFIC では後者を要求されることがある）
+
+### 他媒体との構造の違い
+
+| | TikTok |
+|---|---|
+| 予算の階層 | **広告グループ**（Meta と同じ。YDA / Google はキャンペーン） |
+| 配信オンの値 | **`ENABLE`**（YDA / Meta は `ACTIVE`、Google は `ENABLED`）。配信オフは `DISABLE` |
+| 状態のキー名 | **`operationStatus`**（他媒体は `status`） |
+| 広告文 | **1 本だけ**（`ad_text`・100字まで）。見出し / 説明文の 2 段構えを持たない |
+| 素材モード | `creative_material_mode` は**広告グループ**のフィールド（既定 `CUSTOM`）。広告側に置いても無視される |
+| accountId | `advertiser_id`（数値）。`act_` は付けない |
+| **配信スケジュールの時刻** | **UTC+0**（YDA / Meta は JST）。`schedule_start_time` は `"YYYY-MM-DD HH:mm:ss"` で **UTC** で書く。JST で書くと 9 時間ずれる |
+| identity | **`BC_AUTH_TT` が主流**。`identityAuthorizedBcId` が必須。ID は UUID 形式 |
+| 地域 | **参照データ（`refs.regions`）から引く**。固定の enum を持たない（公開一覧が無いため） |
+| 命名規則 | `{番号}v-{広告文番号}-{paramCode}`（説明文が無いので L 区間が無い） |
+| 最終リンク先URL | `{記事URL}?ad={paramCode}`（Meta / Google と同じ形） |
+
+### 失敗したときに何が残るか
+
+TikTok の削除は `/campaign/status/update/` の `operation_status=DELETE`。**拒否されると停止（DISABLE）にフォールバックする**ので、3 状態を区別する。
+
+| 状態 | 意味 | 運用者がすること |
+|---|---|---|
+| `deleted` | CP は消えた | なし（Slack に「自動削除済み」と出る） |
+| `disabled` | **CP は停止して残っている** | **手動で削除する**（Slack の warning とCLIのログに campaignId が出る） |
+| `failed` | 削除も停止もできなかった | **至急確認**。配信可能な状態で残っている可能性がある |
+
+広告が 1 件でも作れていれば削除しない。**広告グループの作成で失敗した場合も削除対象**（広告に到達していないので結果の広告は 0 件になるが、「広告なし計画」ではない）。
+
+### 実 API で確認できたこと / まだ届いていないこと（2026-08-23）
+
+本番アカウントで初めて叩いた結果。
+
+| 項目 | 結果 |
+|---|---|
+| 認証・書き込み権限 | ✅ **キャンペーンの作成に成功** |
+| **自動ロールバック** | ✅ **実地で動作**。広告グループ作成が失敗 → CP を自動削除。孤児ゼロ |
+| エラーの可視化 | ✅ `code=40002` と `request_id` が CLI まで届いた |
+| identity 取得 | ✅ 動作。**`BC_AUTH_TT` が主流**と判明 |
+| 入稿後の読み返し（`list --resource ads`） | ✅ 動作。ただし `fields` 未指定で `landing_page_url` / `ad_text` / `identity_id` が空だったので明示するよう直した |
+| lint | ✅ ERROR 2件を事前に検出（`urlParamsEnabled: false` の宣言で解消） |
+| 地域ID | ❌ **決め打ちの `1210023` は無効**。`regions` / `adgroups` で引く形に直した |
+| 広告グループ以降の作成 | ⏳ **未達**（地域IDで落ちたため）。地域を取り直して再テストする |
+
+### 実 API 検証で確かめること
+
+初回入稿の前に、この節を読んで手順を確認する。
+
+- identity が広告アカウント配下で取れるか（Business Center 配下にしか出ないアカウントがあるかもしれない）
+- 動画アップロード直後に広告へ使えるか（処理待ちが必要か）
+- `/campaign/status/update/` の `operation_status=DELETE` でロールバックが通るか
+- 地域の `location_id` の実値（日本のIDが `1210023` で正しいか）
+- 最低予算（通貨ごとに違う。20 以上という記述があるが JPY での実値は未確認）
 
 ***
 
@@ -312,7 +473,9 @@ skills/ad-ops/scripts/adops.sh open yda <accountId> campaigns
 | アカウント一覧             | `npx -y addashboard-cli@latest list --platform <yda\|meta\|google\|smartnews\|bytedance> --resource accounts` |
 | キャンペーン一覧            | `npx -y addashboard-cli@latest list --platform <媒体> --resource campaigns --account-id <id>`                   |
 | **広告一覧 (YDA)**          | `npx -y addashboard-cli@latest list --platform yda --resource ads --account-id <id> --campaign-id <cpId>`（広告グループで絞るなら `--ad-group-ids <id1,id2>`。どちらか必須） |
-| 登録画像一覧 (YDA)          | `npx -y addashboard-cli@latest list --platform yda --resource media --account-id <id>`                         |
+| 登録画像一覧 (YDA)          | `npx -y addashboard-cli@latest list --platform yda --resource media --account-id <id>`（審査状況 `approvalStatus` と否認理由コード `disapprovalReasonCodes` 付き） |
+| **掲載不可の画像だけ抽出 (YDA)** | `npx -y addashboard-cli@latest list --platform yda --resource media --account-id <id> --approval-status PRE_DISAPPROVED,DISAPPROVED` |
+| **入稿後の状態確認 (Google)** | `npx -y addashboard-cli@latest list --platform google --resource ads --account-id <id> [--campaign-id <cpId>]`（CP/広告グループ/広告の status を名前で返す） |
 | 登録画像一覧 (Meta)         | `npx -y addashboard-cli@latest list --platform meta --resource image-library --account-id act_<id>`（imageHash） |
 | 登録動画一覧 (Meta)         | `npx -y addashboard-cli@latest list --platform meta --resource video-library --account-id act_<id>`（videoId）   |
 | 汎用入稿 (JSON) dry-run | `npx -y addashboard-cli@latest submit --platform <媒体> --json-file <path>`                                     |
@@ -320,6 +483,12 @@ skills/ad-ops/scripts/adops.sh open yda <accountId> campaigns
 | 入稿計画 順次入稿 dry-run | `npx -y addashboard-cli@latest submit-plan --plan-file <入稿計画.json>`（yda / meta。`plan.platform` 未記載は yda 扱い） |
 | 入稿計画 順次入稿 実入稿   | `npx -y addashboard-cli@latest submit-plan --plan-file <入稿計画.json> --no-dry-run --yes`（1CPずつ・再開可能） |
 
+**【重要】画像が「掲載不可」でも広告は「承認済み」のままになる。** 広告単位の審査状況（`--resource ads` の `approvalStatus`）が全件 APPROVED でも、画像単位で掲載不可になっていることがある。**画像の掲載可否は `--resource media` でしか分からない**ので、入稿後の確認は両方を見る。掲載不可があったら「別名で再アップロード → 差し替え広告を追加」する（同名で上げ直しても否認判定が引き継がれる）。
+
+- `approvalStatus` の実測値は `APPROVED` と `PRE_DISAPPROVED`（= 管理画面の「掲載不可」）
+- `disapprovalReasonCodes` は理由コードの配列。**空配列なら否認なし**。コードの意味は Yahoo の公式リファレンスを引く（CLI は説明文を持たない）
+- 差し替え画像のサイズ合わせ用に `width` / `height` / `fileSize` / `aspectRatio` / `mediaAdFormat` も返る
+
 **【重要】本実行がタイムアウトしたら「失敗」と決めつけない。** CLI の進捗は `unknown`（成否不明）になる。backend は入稿を続けており、**キャンペーンと広告が作成済みのことがある**（実測あり）。この状態で再実行すると二重入稿になるため `unknown` は自動でスキップされる。媒体の管理画面を確認し、作成済みなら計画ファイルの `status` を `"submitted"`、未作成なら `"pending"` に直してから再実行する（exit code は 3）。
 | 「予実」「予実管理」「今月の予実」「着地予測」「予実サマリ」 | `npx -y addashboard-cli@latest pl summary`（月指定は `pl summary --month YYYY-MM`） |
 | 「案件別の予実」「案件ごとの損益」 | `npx -y addashboard-cli@latest pl projects`（`--month` / `--status` / `--platform` で絞り込み可） |
@@ -330,7 +499,7 @@ skills/ad-ops/scripts/adops.sh open yda <accountId> campaigns
 
 ***
 
-## 入稿プランナー（YDA / Meta 媒体切替・JSON入稿）
+## 入稿プランナー（YDA / Meta / Google / TikTok 媒体切替・JSON入稿）
 
 動画の API 入稿とは別に、**一括入稿を計画・確認する**ためのシングルHTMLツール。2026-07-16 / 07-21 定例フィードバックを反映。**2026-07-23 に CSV 書き出しを廃止し、保存・入稿受け渡しを JSON に統一**。**2026-07-30 に媒体スキーマ駆動化（`PLATFORMS` レジストリ）して Meta に対応**。
 
@@ -414,6 +583,7 @@ skills/ad-ops/scripts/adops.sh open yda <accountId> campaigns
 | `status: ACTIVE` | 確認前に配信・課金が始まる |
 | 日予算の桁間違い | 想定外の課金 |
 | CP名に「テスト」等が残存 | 本番アカウントに検証用の名前が残る |
+| **CP名がアカウントの既存CPと同名 (Google)** | **Google は同名CPを拒否する**。dry-run は通り、本実行の作成で落ちる。lint が ERROR で拾う |
 | `imagePaths` のファイルが存在しない | 本実行のアップロードで初めて落ちる。lint は ERROR で拾う（`~` 展開・相対の基準は計画JSONのディレクトリ） |
 | `paramCode` が特定できない | 計測パラメータ無しの広告が入稿される。パラメータ無し運用なら `urlParamsEnabled: false` を入れる（WARN 止まりになる） |
 | `smartTargeting: false` | 配信が伸びない。方針は常時 ON なので lint が WARN で拾う |
@@ -648,5 +818,5 @@ npx -y addashboard-cli@latest list --platform yda --resource ads \
 - **命名規則の統一**: `【】内の数字`のみ共通で、キャンペーン名/広告名は担当者差がある → システム命名に寄せられるようにする。
 - ~~**Meta広告対応**（GUI未対応）~~ → **プランナーGUI 対応完了（2026-07-30）**: `PLATFORMS` 媒体スキーマ駆動化により、統合プルダウンで Meta の案件を選ぶと専用の列・enum・命名規則・検証・入稿ボディ変換に切り替わる。backend は Meta Marketing API 公式Docs 照合で 12 ギャップを修正（APIバージョン集約 / zodスキーマ一本化と 400 応答 / `instagram_user_id` / `promoted_object` / JPY の currency offset / `bid_amount` 必須条件 / 動画サムネ hash / 特別広告カテゴリ / JST ISO8601 / `success` 判定 など）。CLI は `submit-plan` の meta 対応と `list --resource image-library|video-library` を追加。
 - **Meta の残タスク（未対応）**: 本番アカウントへの入稿 PoC（未実施）、カルーセル／コレクション等の複数素材フォーマット、カスタムオーディエンス／類似オーディエンスの ID 解決、地域ターゲティング細分化（現状は国単位）、既存キャンペーンの複製テンプレート運用の GUI 化。
-- **TikTok / ByteDance のプランナー対応**: 未着手（`PLATFORMS` に媒体定義を追加すれば載る設計）。
+- **TikTok / ByteDance の拡張**: CV最適化（`WEB_CONVERSIONS` + pixel）/ 画像広告（`SINGLE_IMAGE`）/ カルーセル / Spark Ads / プランナーからのローカル動画アップロード / 配信期間 / `refs-import` は未対応。
 - **未確定（要実機確認）**: CTA既定（画像=もっとみる / 動画=詳細を見る）と `buttonText` enum、画像レスポンシブAPI入稿（PR #82）の実疎通、新規時に CP/AG ID 未払出でどう入稿するか、画像サムネURLの入手経路。