addashboard-cli 0.8.1 → 0.9.1

package/skills/ad-ops/ad-planner.html

@@ -677,6 +677,82 @@ finalUrl = baseURL + paramCode + "?ad=" + paramCode + "&creative=" + …
         </ul>
       </div></details>
       </div><!-- /mt-meta -->
+
+      <div id="mt-google" style="display:none">
+      <div class="eyebrow">Google Ads (Demand Gen) — 対応範囲・要件一覧</div>
+      <h1 class="title">Google 広告入稿 <span class="pill green" style="vertical-align:middle">実 API 確認済み</span></h1>
+      <p class="sub">2026-08-23 更新。<b>実 API での入稿を確認済み</b>（PAUSED で 1 キャンペーン）。<b>配信オン（ENABLED）では入稿できない</b> — 意図しない配信・課金を防ぐため backend が 400 で拒否する。<b>配信オフで入稿し、管理画面で確認してから手でオンにする</b>運用。Google Ads API v23 の proto 定義に照合して実装。</p>
+
+      <details class="sec" open><summary><span class="num">1</span><span class="stitle">概要 — なぜ Demand Gen なのか</span><span class="chev"></span></summary>
+      <div class="body">
+        <p class="lead"><b>Google Ads API では動画（VIDEO）キャンペーンを新規作成できない</b>（公式明記）。API から YouTube 面へ広告を出す経路は <b>Demand Gen キャンペーンだけ</b>。</p>
+        <p>Demand Gen は YouTube（インストリーム / インフィード / ショート）・Discover・Gmail・ディスプレイに配信できる。画像広告と動画広告を同じキャンペーンで扱えるため、広告行の「形式」列で切り替える（Meta と同じ作り）。</p>
+        <table class="g"><thead><tr><th>レイヤ</th><th>状態</th><th>内容</th></tr></thead><tbody>
+          <tr><td>backend</td><td><span class="pill green">実装済み</span></td><td><code>/api/submission/google</code> + <code>GoogleSubmissionConnector</code>。Demand Gen キャンペーン / 広告グループ / 動画・画像広告 / 目標CPA入札 / 地域・言語ターゲティング / 配信面の制御</td></tr>
+          <tr><td>CLI</td><td><span class="pill green">実 API 確認済み</span></td><td><code>webgram submit-plan</code> が Google に対応（dry-run / 本実行とも）。2026-08-23 に PAUSED で入稿を確認した。初回は <b>PAUSED・1キャンペーン・最小予算</b>で流し、管理画面で目視確認する。広告が1件も作れなかったキャンペーンは自動で削除される</td></tr>
+          <tr><td>プランナーGUI</td><td><span class="pill green">実装済み</span></td><td>ヘッダーの統合プルダウンで Google に切替。シート（広告 / 広告グループ / キャンペーン）・ツリー・参照データ・入稿JSON書き出しに対応</td></tr>
+          <tr><td>実 API 検証</td><td><span class="pill green">実施済み</span></td><td>2026-08-23 に本番アカウントで Demand Gen 画像広告を PAUSED 入稿し、作成を確認した。developer token のアクセスレベルは Basic 以上（読み取りが通っているため）。<b>ただし配信オン（ENABLED）での実配信は未検証</b>。また<b>アカウントによって書き込み可否が違う</b>（停止・未有効化のものがある）</td></tr>
+        </tbody></table>
+      </div></details>
+
+      <details class="sec" open><summary><span class="num">2</span><span class="stitle">動画広告 — YouTube 動画IDを人が用意する</span><span class="chev"></span></summary>
+      <div class="body">
+        <p class="lead"><b>動画ファイルのアップロードは未対応。</b>YouTube に上げた動画のIDを使う。Google Ads API には窓口（<code>YouTubeVideoUploadService</code>）があるが、使っている Node ライブラリが非対応のため、運用者が YouTube へ手で上げる。<b>手で上げた場合、動画IDはアップロード直後に URL から取得できる</b>（処理完了を待つ必要はない）。</p>
+        <p>参照データの「クリエイティブ」に <code>video</code> として YouTube 動画ID（例 <code>dQw4w9WgXcQ</code>）を登録し、広告行の形式を <code>VIDEO</code> にして番号で参照する。</p>
+        <table class="g"><thead><tr><th>項目</th><th>必須</th><th>制約</th></tr></thead><tbody>
+          <tr><td>YouTube動画ID</td><td><span class="pill green">必須</span></td><td>事前に YouTube へアップロードしておく</td></tr>
+          <tr><td>見出し</td><td><span class="pill green">必須</span></td><td>表示幅30まで</td></tr>
+          <tr><td><b>長見出し</b></td><td><span class="pill green">必須</span></td><td>表示幅90まで。<b>動画広告だけが持つ項目</b>（画像広告にはない）</td></tr>
+          <tr><td>説明文</td><td><span class="pill green">必須</span></td><td>表示幅90まで</td></tr>
+          <tr><td>ブランド名</td><td><span class="pill green">必須</span></td><td>案件設定で指定。表示幅25まで</td></tr>
+          <tr><td>ロゴ</td><td>任意</td><td>1:1・128x128以上。将来のAPIバージョンで必須化される予定</td></tr>
+        </tbody></table>
+      </div></details>
+
+      <details class="sec" open><summary><span class="num">3</span><span class="stitle">画像広告 — ロゴが必須</span><span class="chev"></span></summary>
+      <div class="body">
+        <table class="g"><thead><tr><th>項目</th><th>必須</th><th>制約</th></tr></thead><tbody>
+          <tr><td>横長画像 / 正方形画像</td><td><span class="pill green">どちらか必須</span></td><td>横長 = 1.91:1・600x314以上 / 正方形 = 1:1・300x300以上。合計20枚まで</td></tr>
+          <tr><td><b>ロゴ</b></td><td><span class="pill green">必須</span></td><td>1〜5枚。1:1・128x128以上。<b>案件設定の「ロゴアセット」で指定する</b></td></tr>
+          <tr><td>見出し / 説明文 / ブランド名</td><td><span class="pill green">必須</span></td><td>動画広告と同じ</td></tr>
+          <tr><td>CTA</td><td>任意</td><td>案件設定の CTA がそのままボタン文言になる</td></tr>
+        </tbody></table>
+        <p>画像は事前に Google Ads へ IMAGE アセットとして登録し、その <code>resource_name</code> を参照データに入れる。</p>
+      </div></details>
+
+      <details class="sec" open><summary><span class="num">4</span><span class="stitle">ターゲティング — 地域を入れないと全世界配信</span><span class="chev"></span></summary>
+      <div class="body">
+        <p class="lead"><b>地域を指定しないと全世界に配信される。</b>広告グループ行の「地域」を必ず確認する（未指定のときは警告が出る）。</p>
+        <table class="g"><thead><tr><th>項目</th><th>置き場所</th><th>内容</th></tr></thead><tbody>
+          <tr><td>地域</td><td>広告グループ行</td><td>日本 = criterion ID 2392</td></tr>
+          <tr><td>言語</td><td>広告グループ行</td><td>日本語 = 1005 / 英語 = 1000</td></tr>
+          <tr><td>配信面</td><td>広告グループ行</td><td>YouTube を選ぶとインストリーム・インフィード・ショートの3面が有効になる。「すべて」なら Google の既定に任せる</td></tr>
+        </tbody></table>
+        <p>Demand Gen は地域・言語を<b>広告グループ階層</b>に持つ（キャンペーン階層ではない）。デモグラフィック・オーディエンスのターゲティングは今回のスコープ外。</p>
+      </div></details>
+
+      <details class="sec" open><summary><span class="num">5</span><span class="stitle">予算と入札</span><span class="chev"></span></summary>
+      <div class="body">
+        <table class="g"><thead><tr><th>項目</th><th>置き場所</th><th>内容</th></tr></thead><tbody>
+          <tr><td>日予算</td><td><b>キャンペーン行</b></td><td>Meta と違い予算はキャンペーン階層（Google の CampaignBudget）</td></tr>
+          <tr><td>目標CPA</td><td>キャンペーン行</td><td>入れると目標CPA入札。<b>空欄ならコンバージョン数の最大化</b></td></tr>
+          <tr><td>広告グループ入札</td><td>—</td><td>Demand Gen は自動入札のため広告グループに入札を持たない</td></tr>
+        </tbody></table>
+      </div></details>
+
+      <details class="sec" open><summary><span class="num">6</span><span class="stitle">運用手順</span><span class="chev"></span></summary>
+      <div class="body">
+        <ol>
+          <li>YouTube に動画をアップロードし、動画IDを控える（画像広告なら Google Ads に画像アセットを登録する）</li>
+          <li>参照データに 見出し / 長見出し / 説明文 / クリエイティブ を登録する</li>
+          <li>案件設定で <b>ブランド名</b>（必須）と <b>ロゴアセット</b>（画像広告なら必須）を入れる</li>
+          <li>シートで キャンペーン（日予算・目標CPA）→ 広告グループ（地域・言語・配信面）→ 広告 を組む</li>
+          <li>「入稿JSON書き出し」→ <code>webgram submit-plan --plan-file &lt;file&gt;</code> で dry-run</li>
+        </ol>
+        <p class="sub">dry-run で計画の不備（必須項目・文字数・チャネルと広告タイプの不整合）を潰したら <code>--no-dry-run --yes</code> で本実行できる。<b>CTA は英語の表示テキスト</b>（<code>Learn more</code> 形式。<code>Learn More</code> のような大文字表記・日本語・<code>LEARN_MORE</code> は弾かれる）。<b>使える値はアカウントによって違い</b>、弾かれると入稿時に <code>Invalid call to action text.</code> が返る。<b>広告が1件も作れなかったキャンペーンは自動で削除される</b>（作りかけの孤児を残さない）。</p>
+        <p class="sub"><b>既存キャンペーン・既存広告グループへの広告追加は未対応。</b>毎回あたらしいキャンペーンを作る形になる。</p>
+      </div></details>
+      </div><!-- /mt-google -->
     </div>
   </section>
 
@@ -856,7 +932,19 @@ const EC = {
   BUDGET_MISSING:'BUDGET_MISSING',     PIXEL_MISSING:'PIXEL_MISSING',
   /* 配信日時 (媒体が日時列を持つ場合に使う。空欄はエラーにしない = 未指定は上位へフォールバック) */
   START_TIME_INVALID:'START_TIME_INVALID', END_TIME_INVALID:'END_TIME_INVALID',
-  END_BEFORE_START:'END_BEFORE_START'
+  END_BEFORE_START:'END_BEFORE_START',
+  /* Google (Demand Gen) 固有 */
+  LONG_HEADLINE_UNRESOLVED:'LONG_HEADLINE_UNRESOLVED',
+  LONG_HEADLINE_TOO_LONG:'LONG_HEADLINE_TOO_LONG',
+  LONG_HEADLINE_MISSING:'LONG_HEADLINE_MISSING' /* 動画広告は長見出しが必須 */,
+  BUSINESS_NAME_MISSING:'BUSINESS_NAME_MISSING' /* proto 上 REQUIRED */,
+  LOGO_MISSING:'LOGO_MISSING'                   /* 画像広告はロゴ 1-5 件が必須 */,
+  LOCATION_EMPTY:'LOCATION_EMPTY'               /* 地域未指定。google は全世界配信 (warn) / bytedance は入稿不可 (err) */,
+  /* ByteDance (TikTok) 固有 */
+  IDENTITY_MISSING:'IDENTITY_MISSING'  /* 広告主として表示する TikTok アカウント未設定 = 広告が作れない */,
+  IDENTITY_BC_MISSING:'IDENTITY_BC_MISSING' /* identityType=BC_AUTH_TT なのに BC ID が無い (実運用の identity はほぼ BC_AUTH_TT) */,
+  COVER_MISSING:'COVER_MISSING'        /* SINGLE_VIDEO はカバー画像が必須 */,
+  REGION_UNRESOLVED:'REGION_UNRESOLVED'/* 地域名を location_id に解決できない (refs.regions 未取込) */
 };
 
 /* ---- refs (VLOOKUP代替) ----
@@ -879,7 +967,8 @@ function pf(){ return PLATFORMS[curPf]; }
 /* ---- S11: 媒体切替はヘッダーの統合プルダウン (#accSelect) に一本化 ----
    媒体要件ビューは選択中の媒体のドキュメントだけを表示する。
    媒体を切り替えると state は当該媒体の既定値で作り直す (プランは媒体をまたげない)。 */
-function showMediaDoc(id){ ['yda','meta'].forEach(k=>{ const el=document.getElementById('mt-'+k); if(el) el.style.display = (k===id?'':'none'); }); }
+/* 媒体を増やしたときに列挙を書き換え忘れると、その媒体だけドキュメントが出ないまま気づけない */
+function showMediaDoc(id){ Object.keys(PLATFORMS).forEach(k=>{ const el=document.getElementById('mt-'+k); if(el) el.style.display = (k===id?'':'none'); }); }
 function renderPlatformTabs(){
   showMediaDoc(curPf);
   renderChrome();
@@ -3262,6 +3351,1118 @@ PLATFORMS.meta = {
   docTabs:[{id:'overview',label:'概要'},{id:'image',label:'画像広告'},
            {id:'video',label:'動画広告'},{id:'param',label:'パラメータ'},{id:'guide',label:'運用手順'}]
 };
+
+/* ============================================================
+   PLATFORMS.google — Google (Demand Gen) の媒体スキーマ
+   ------------------------------------------------------------
+   YouTube 面へ動画を出す API 経路は Demand Gen だけ。VIDEO キャンペーンは
+   Google Ads API から新規作成できないため、キャンペーン型は DEMAND_GEN 固定にする。
+   Demand Gen は画像広告 (DEMAND_GEN_MULTI_ASSET_AD) と
+   動画広告 (DEMAND_GEN_VIDEO_RESPONSIVE_AD) を同じキャンペーンで扱えるので、
+   広告行の「形式」列で切り替える (Meta と同じ作り)。
+
+   【重要】列は backend の googleSubmitSchema が受け取れる項目だけを置く。
+   GUI にあるのに入稿JSONへ載らない列を作ると、運用者が設定したつもりの
+   条件が黙って無視される (YDA のターゲティング列で実際に起きている)。
+   ============================================================ */
+const GOOGLE_REF_TABLES = {
+  titles:{ key:'titles', label:'見出し', countLabel:'見出し', editable:true, copyable:true, required:true,
+    keyKind:'number', keyLabel:'番号', keyWidth:'70px', dropEmpty:true,
+    addSub:'番号→見出し。表示幅30まで',
+    emptyMsg:'該当する見出しがありません',
+    lengthLimit:{warn:30, err:40},
+    valueFields:[{k:'text', label:'文言'}],
+    keyCell:no=>'<td class="mono">'+esc(no)+'</td>',
+    columns:[
+      {label:'見出し', cls:'reftext', attr:(no,v)=>' title="'+esc(v)+'"', cell:(no,v)=>esc(v)},
+      {label:'文字数', width:'70px', cls:(no,v)=>'reflen '+refLenCls(GOOGLE_REF_TABLES.titles,v), cell:(no,v)=>glen(v)}
+    ],
+    optionLabel:v=>String(v==null?'':v) },
+  longHeadlines:{ key:'longHeadlines', label:'長見出し', countLabel:'長見出し', editable:true, copyable:true, required:false,
+    keyKind:'number', keyLabel:'番号', keyWidth:'70px', dropEmpty:true,
+    addSub:'番号→長見出し（動画広告で使用・表示幅90まで）',
+    emptyMsg:'該当する長見出しがありません',
+    lengthLimit:{warn:90, err:120},
+    valueFields:[{k:'text', label:'文言'}],
+    keyCell:no=>'<td class="mono">'+esc(no)+'</td>',
+    columns:[
+      {label:'長見出し', cls:'reftext', attr:(no,v)=>' title="'+esc(v)+'"', cell:(no,v)=>esc(v)},
+      {label:'文字数', width:'70px', cls:(no,v)=>'reflen '+refLenCls(GOOGLE_REF_TABLES.longHeadlines,v), cell:(no,v)=>glen(v)}
+    ],
+    optionLabel:v=>String(v==null?'':v) },
+  descriptions:{ key:'descriptions', label:'説明文', countLabel:'説明文', editable:true, copyable:true, required:true,
+    keyKind:'number', keyLabel:'番号', keyWidth:'70px', dropEmpty:true,
+    addSub:'番号→説明文（表示幅90まで）',
+    emptyMsg:'該当する説明文がありません',
+    lengthLimit:{warn:90, err:120},
+    valueFields:[{k:'text', label:'文言'}],
+    keyCell:no=>'<td class="mono">'+esc(no)+'</td>',
+    columns:[
+      {label:'説明文', cls:'reftext', attr:(no,v)=>' title="'+esc(v)+'"', cell:(no,v)=>esc(v)},
+      {label:'文字数', width:'70px', cls:(no,v)=>'reflen '+refLenCls(GOOGLE_REF_TABLES.descriptions,v), cell:(no,v)=>glen(v)}
+    ],
+    optionLabel:v=>String(v==null?'':v) },
+  /* image / square は IMAGE アセットの resource_name、video は YouTube 動画ID。
+     動画は Google Ads API へアップロードできないため、人が YouTube に上げた動画IDを使う。 */
+  media:{ key:'media', label:'クリエイティブ', countLabel:'クリエイティブ', editable:true, required:true,
+    keyKind:'number', keyLabel:'番号', keyWidth:'80px',
+    addSub:'番号→横長画像 / 正方形画像のアセット名、YouTube動画ID',
+    emptyMsg:'該当するクリエイティブがありません',
+    valueFields:[{k:'image', label:'横長画像 (1.91:1) アセット', editLabel:'横長画像アセット'},
+                 {k:'square', label:'正方形画像 (1:1) アセット',  editLabel:'正方形画像アセット'},
+                 {k:'video', label:'YouTube動画ID',              editLabel:'YouTube動画ID'}],
+    keyCell:no=>'<td><span class="sw" style="display:inline-flex;width:26px;height:26px;vertical-align:middle">'+esc(no)+'</span> '+newBadge('media',no)+'</td>',
+    columns:[
+      {label:'横長画像',       cls:'mono', cell:(no,v)=>esc(v&&v.image||'—')},
+      {label:'正方形画像',     cls:'mono', cell:(no,v)=>esc(v&&v.square||'—')},
+      {label:'YouTube動画ID', cls:'mono', cell:(no,v)=>esc(v&&v.video||'—')}
+    ],
+    optionLabel:v=>(((v&&(v.image||v.square))?'IMG':'')+((v&&(v.image||v.square)&&v.video)?'/':'')+((v&&v.video)?'VID':'')),
+    drawerLabel:v=>'IMG '+esc(v&&(v.image||v.square)||'—')+' ／ VID '+esc(v&&v.video||'—') },
+  adGroups:{ key:'adGroups', label:'広告グループ', countLabel:'広告グループ', editable:false, required:false,
+    keyKind:'string', keyLabel:'広告グループID', keyWidth:'130px',
+    emptyMsg:'既存の広告グループがありません（アカウントJSONの refs.adGroups）',
+    valueFields:[{k:'name',label:'名'},{k:'paramCode',label:'paramCode'},{k:'campaignId',label:'キャンペーンID'}],
+    keyCell:no=>'<td class="mono">'+esc(no)+'</td>',
+    columns:[
+      {label:'広告グループ名', cls:'reftext', attr:(no,v)=>' title="'+esc(v&&v.name||'')+'"', cell:(no,v)=>esc(v&&v.name||'')},
+      {label:'paramCode', width:'130px', cls:'mono', cell:(no,v)=>esc(v&&v.paramCode||'')},
+      {label:'キャンペーンID', width:'130px', cls:'mono', cell:(no,v)=>esc(v&&v.campaignId||'')}
+    ] },
+  campaigns:{ key:'campaigns', label:'キャンペーン', countLabel:'キャンペーン', editable:false, required:false,
+    keyKind:'string', keyLabel:'キャンペーンID', keyWidth:'130px',
+    emptyMsg:'既存のキャンペーンがありません（アカウントJSONの refs.campaigns）',
+    valueFields:[{k:'name',label:'名'}],
+    keyCell:no=>'<td class="mono">'+esc(no)+'</td>',
+    columns:[
+      {label:'キャンペーン名', cls:'reftext', attr:(no,v)=>' title="'+esc(v&&v.name||'')+'"', cell:(no,v)=>esc(v&&v.name||'')}
+    ] }
+};
+
+const GOOGLE_COLS = {
+  ads:[
+    {field:'format', label:'形式', kind:'select', options:['IMAGE','VIDEO'], minWidth:'70px',
+     coerce:v=>(String(v).toUpperCase()==='VIDEO'?'VIDEO':'IMAGE'),
+     title:'IMAGE = Demand Gen 画像広告 / VIDEO = Demand Gen 動画広告（YouTube）'},
+    {field:'imageNo', label:'クリエイティブ番号', kind:'refcombo', refTable:'media', drawerType:'media', mediaAxis:'format',
+     width:'6ch', sequenceable:true, errCodes:[EC.IMAGE_UNRESOLVED],
+     ghostKey:'media', ddTitle:'登録クリエイティブから選択',
+     ghostTitle:r=>(r.mediaKind==='VIDEO'?'YouTube動画ID ':'画像アセット ')+r.mediaId,
+     ghost:(r,a)=>{ if(!a.imageNo) return '<span class="idpill" style="color:var(--faint)">—</span>';
+       if(r.mediaId!=='') return '<span class="idpill">'+(r.mediaKind==='VIDEO'?'VID ':'IMG ')+esc(r.mediaId)+'</span>';
+       if(r.pendingImage) return '<span class="idpill warn" title="アカウント未登録。入稿前にアップロードして新規登録">🆕未登録</span>';
+       return '<span class="idpill err">#N/A</span>'; }},
+    {field:'titleNo', label:'見出し番号', kind:'refcombo', refTable:'titles', drawerType:'titles',
+     width:'6ch', sequenceable:true, errCodes:[EC.TITLE_UNRESOLVED, EC.TITLE_TOO_LONG],
+     ghostKey:'title', ddTitle:'見出し一覧から選択', ghostTitle:r=>r.titleText,
+     ghost:r=>r.errCodes.includes(EC.TITLE_UNRESOLVED)?'<span class="err">未解決</span>':esc(r.titleText.slice(0,40))},
+    /* 長見出しは動画広告だけが持つ (DemandGenVideoResponsiveAdInfo.long_headlines)。
+       画像広告では送らないので、IMAGE 行では空のままでよい。 */
+    {field:'longNo', label:'長見出し番号', kind:'refcombo', refTable:'longHeadlines', drawerType:'titles',
+     width:'6ch', sequenceable:true, errCodes:[EC.LONG_HEADLINE_UNRESOLVED, EC.LONG_HEADLINE_TOO_LONG, EC.LONG_HEADLINE_MISSING],
+     ghostKey:'longHeadline', ddTitle:'長見出し一覧から選択', ghostTitle:r=>r.longText,
+     title:'動画広告（VIDEO）で必須。画像広告では使いません',
+     ghost:r=>r.errCodes.includes(EC.LONG_HEADLINE_UNRESOLVED)?'<span class="err">未解決</span>'
+            :r.errCodes.includes(EC.LONG_HEADLINE_MISSING)?'<span class="err">動画は必須</span>'
+            :esc(r.longText.slice(0,40))},
+    {field:'descNo', label:'説明文番号', kind:'refcombo', refTable:'descriptions', drawerType:'titles',
+     width:'6ch', sequenceable:true, errCodes:[EC.DESC_UNRESOLVED, EC.DESC_TOO_LONG],
+     ghostKey:'desc', ddTitle:'説明文一覧から選択', ghostTitle:r=>r.descText,
+     ghost:r=>r.errCodes.includes(EC.DESC_UNRESOLVED)?'<span class="err">— 未解決</span>':esc(r.descText.slice(0,44))},
+    {field:'paramCode', label:'paramCode(広告グループ)', kind:'mono', width:'120px',
+     scope:'parentGroup', sequenceable:true, readonlyOnExisting:true, errCodes:[EC.PARAM_CODE_EMPTY],
+     title:'広告グループ共通（変更で同グループ全広告に反映）。最終URLは 記事URL?ad={paramCode}',
+     hidden:p=>urlParamsOff(p),
+     roStyle:'input', roTitle:'既存広告グループのため編集不可'},
+    {field:'finalUrl', label:'最終リンク先URL', kind:'mono', width:'240px',
+     alwaysReadonly:true, roStyle:'input',
+     roTitle:'自動生成（編集不可）。変えるときは 案件設定の記事URL / paramCode を直します',
+     get:(row,ctx)=>ctx.r?ctx.r.finalUrl:''},
+    {field:'adName', label:'広告名', kind:'mono', width:'170px',
+     title:'空欄なら自動生成（{番号}{i|v}-{見出し番号}L{説明文番号}-{paramCode}）',
+     placeholder:ctx=>ctx.r?ctx.r.autoAdName:''},
+    {field:'adGroupId', label:'CP / AG ID', kind:'derived',
+     derive:(a,ctx)=>'<span class="idpill '+(ctx.r.resolvedGroup?'':'warn')+'" data-d="'+a.uid+'-ids">'+esc(ctx.r.adGroupId?('AG '+ctx.r.adGroupId):'新規')+'</span>'}
+  ],
+  adGroups:[
+    {field:'adGroupId', label:'広告グループID', kind:'badge', alwaysReadonly:true},
+    {field:'name', label:'広告グループ名', kind:'text', width:'150px', required:true,
+     readonlyOnExisting:true, roTitle:'既存広告グループのため編集不可'},
+    {field:'paramCode', label:'paramCode', kind:'mono', width:'120px', required:true,
+     sequenceable:true, readonlyOnExisting:true, hidden:p=>urlParamsOff(p),
+     title:'URL生成用のパラメータ（広告グループ紐づけには不使用）'},
+    /* Demand Gen は upgraded_targeting が既定 true のため、地域・言語は広告グループ層に置く。
+       ここが空だと全世界配信になるので resolve で警告を出す。 */
+    {field:'tg_location', label:'地域', kind:'tgpick', tgKey:'tg_location', readonlyOnExisting:true, roEmptyDash:true,
+     title:'未指定だと全世界配信になります'},
+    {field:'tg_language', label:'言語', kind:'tgpick', tgKey:'tg_language', readonlyOnExisting:true, roEmptyDash:true},
+    {field:'tg_channel', label:'配信面', kind:'tgpick', tgKey:'tg_channel', readonlyOnExisting:true, roEmptyDash:true,
+     title:'YouTube だけに出したい場合はここで絞る。「すべて」なら Google の既定に任せる'},
+    {field:'deliveryStatus', label:'配信', kind:'select', options:['','オフ','オン'], minWidth:'66px',
+     readonlyOnExisting:true, roEmptyDash:true, coerce:v=>{const s=String(v).trim(); return (s==='オフ'||s==='オン')?s:'';}}
+  ],
+  campaigns:[
+    {field:'campaignId', label:'キャンペーンID', kind:'badge', alwaysReadonly:true},
+    {field:'name', label:'キャンペーン名', kind:'text', width:'170px', required:true,
+     readonlyOnExisting:true, roTitle:'既存キャンペーンのため編集不可'},
+    /* budgetLevel='campaign' → 予算はキャンペーン行が持つ (Google の CampaignBudget) */
+    {field:'dailyBudget', label:'日予算(円)', kind:'number', width:'84px', required:true,
+     coerce:numOrNull, readonlyOnExisting:true, roEmptyDash:true, errCodes:[EC.BUDGET_MISSING],
+     placeholder:()=>String(pf().defaults.newCampaignBudget)},
+    {field:'targetCpa', label:'目標CPA(円)', kind:'number', width:'84px', coerce:numOrNull,
+     readonlyOnExisting:true, roEmptyDash:true,
+     title:'入れると TARGET_CPA 入札。空欄なら MAXIMIZE_CONVERSIONS（コンバージョン数の最大化）',
+     placeholder:()=>String(pf().defaults.targetCpa)},
+    {field:'urlNumber', label:'リンク番号', kind:'mono', width:'54px', hideOnExisting:true}
+  ]
+};
+
+PLATFORMS.google = {
+  id:'google', displayName:'Google', brandTitle:'Google入稿プランナー',
+
+  account:{
+    idPattern:/^\d{10}$/, idHint:'Google 広告アカウントID（ハイフン無し10桁）', dir:'アカウント/google',
+    apply(obj, project){
+      if(obj.accountId!=null) project.accountId = String(obj.accountId).replace(/-/g,'');
+      if(obj.name!=null) project.accountName=String(obj.name);
+      if(obj.principal!=null) project.principal=String(obj.principal);
+      if(obj.businessName!=null) project.businessName=String(obj.businessName);
+      if(obj.logoAsset!=null) project.logoAsset=String(obj.logoAsset);
+      if(obj.consoleMcc!=null) project.consoleMcc=String(obj.consoleMcc).replace(/-/g,'');
+      if(obj.projectName) project.name=obj.projectName;
+      if(obj.baseArticleUrl) project.baseArticleUrl=obj.baseArticleUrl;
+      if(obj.urlParamsEnabled!=null) project.urlParams=!!obj.urlParamsEnabled; else delete project.urlParams;
+    },
+    schemaLines(opts){
+      const o=opts||{};
+      return ['{','  "accountJsonVersion": 1,','  "platform": "google",','  "accountId": "<10桁のCustomer ID（ハイフン無し）>",',
+        '  "name": "'+(o.nameHint||'<アカウント名>')+'",',
+        '  "consoleMcc": "<MCCのCustomer ID（管理画面URL用・任意）>",',
+        '  "businessName": "<広告に出すブランド名（25字以内）>",',
+        '  "logoAsset": "<ロゴ画像アセットの resource_name>",']
+        .concat(o.updatedAt===false?[]:['  "updatedAt": "<ISO8601>",'])
+        .concat([
+        '  "refs": {',
+        '    "titles": {"1": "見出し（表示幅30まで）"},',
+        '    "longHeadlines": {"1": "長見出し（動画広告用・表示幅90まで）"},',
+        '    "descriptions": {"1": "説明文（表示幅90まで）"},',
+        '    "media": {"1": {"image": "<横長画像アセット>", "square": "<正方形画像アセット>", "video": "<YouTube動画ID>"}},',
+        '    "campaigns": {"<campaignId>": {"name": "CP名"}},',
+        '    "adGroups": {"<adGroupId>": {"name": "広告グループ名", "campaignId": "<campaignId>", "paramCode": "<code>"}}',
+        '  }','}']);
+    }
+  },
+
+  levels:{
+    campaign:{label:'キャンペーン', childKey:'adGroups', planKey:'adGroups'},
+    adGroup :{label:'広告グループ', childKey:'ads',      planKey:'ads'},
+    ad      :{label:'広告'}
+  },
+  budgetLevel:'campaign',
+  consoleUrl:'https://ads.google.com/aw/{resource}?ocid=&__c={mcc}&__u={accountId}',
+  consoleResourceMap:{campaigns:'campaigns', adGroups:'adgroups', ads:'ads'},
+
+  mediaFormats:[
+    {id:'IMAGE', crSuffix:'i', mediaKey:'image', apiMediaKind:'IMAGE', label:'画像アセット'},
+    {id:'VIDEO', crSuffix:'v', mediaKey:'video', apiMediaKind:'VIDEO', label:'YouTube動画ID'}
+  ],
+  fmtOf(ad){ const F=PLATFORMS.google.mediaFormats; return F.find(x=>x.id===(ad&&ad.format)) || F[0]; },
+
+  refTables:GOOGLE_REF_TABLES,
+  sheets:GOOGLE_COLS,
+
+  projectFields:[
+    {key:'businessName', label:'ブランド名', kind:'text', width:'14ch', fallback:'',
+     title:'広告に表示される広告主名。Demand Gen 広告では必須（表示幅25まで）'},
+    {key:'logoAsset', label:'ロゴアセット', kind:'text', width:'18ch', fallback:'',
+     title:'ロゴ画像アセットの resource_name。画像広告では必須（1:1・128x128以上）'},
+    {key:'cta', label:'CTA', kind:'select',
+     options:['詳しくはこちら','購入する','登録する','ダウンロード','お問い合わせ','今すぐ申し込む',
+              '予約する','見積もりを取得','購読する','インストール','サイトへアクセス','もっと見る','ボタンなし'],
+     title:'画像広告のボタン文言。使える値はアカウントによって違い、弾かれると入稿時にエラーが出ます。動画広告ではアセット登録が要るため今は送りません'},
+    {key:'deliveryStatus', label:'配信', kind:'select', options:['オフ','オン']},
+    {key:'baseArticleUrl', label:'記事URL', kind:'text', width:'16ch', fallback:''},
+    {key:'urlParams', label:'URLパラメータ', kind:'toggle', fallback:true,
+     title:'OFF にすると最終リンク先URLに ?ad= を付けません（案件単位）'}
+  ],
+  fixedType:[{label:'キャンペーン型',value:'Demand Gen（YouTube / Discover / Gmail）'}],
+
+  targeting:{
+    tg_location:{label:'地域', multi:true, allLabel:'指定なし（全世界）', opts:['指定なし（全世界）','日本']},
+    tg_language:{label:'言語', multi:true, allLabel:'指定なし', opts:['指定なし','日本語','英語']},
+    tg_channel:{label:'配信面', multi:true, allLabel:'すべて（Google既定）',
+      opts:['すべて（Google既定）','YouTube','Discover','Gmail','ディスプレイ']}
+  },
+
+  enums:{
+    /* criterion ID は Google の公式データ表 (geotargets / codes-formats) 由来 */
+    location:{'日本':'2392'},
+    language:{'日本語':'1005','英語':'1000'},
+    /* call_to_action_text は公式 Call-to-Action Text Translations の **en-GB 表記**。
+       2026-08-23 実測: en 表記 (Learn More) も日本語 (詳細) も enum 名 (LEARN_MORE) も全滅し、
+       en-GB 表記だけが通った。**使える値はアカウントによって違う**（あるアカウントでは
+       Shop now が弾かれ、別アカウントでは通った）ので、ここでは表記だけ正しく変換する。 */
+    cta:{'詳しくはこちら':'Learn more','購入する':'Shop now','登録する':'Sign up',
+         'ダウンロード':'Download','お問い合わせ':'Contact us','今すぐ申し込む':'Apply now',
+         '予約する':'Book now','見積もりを取得':'Get quote','購読する':'Subscribe',
+         'インストール':'Install','サイトへアクセス':'Visit site','もっと見る':'See more',
+         'ボタンなし':''},
+    statusOn:'ENABLED', statusOff:'PAUSED',
+    advertisingChannelType:'DEMAND_GEN',
+    adTypeOf:{IMAGE:'DEMAND_GEN_MULTI_ASSET_AD', VIDEO:'DEMAND_GEN_VIDEO_RESPONSIVE_AD'}
+  },
+
+  mappers:{
+    status(s, P){ return s==='オン'?P.enums.statusOn:P.enums.statusOff; },
+    locationIds(s, P){ return mapByEnum(s, P.enums.location, P.targeting.tg_location.allLabel); },
+    languageIds(s, P){ return mapByEnum(s, P.enums.language, P.targeting.tg_language.allLabel); },
+    /* 配信面。「すべて」= 指定しない (キー自体を出さず Google 既定に任せる)。
+       YouTube を選ぶと in-stream / in-feed / shorts の3面がまとめて ON になる。 */
+    channels(s, P){
+      const l=tgList(s);
+      if(!l.length || l.indexOf(P.targeting.tg_channel.allLabel)>=0) return null;
+      const yt=l.indexOf('YouTube')>=0;
+      return {youtubeInStream:yt, youtubeInFeed:yt, youtubeShorts:yt,
+              discover:l.indexOf('Discover')>=0, gmail:l.indexOf('Gmail')>=0,
+              display:l.indexOf('ディスプレイ')>=0};
+    },
+    cta(label, P){ const v=P.enums.cta[String(label||'').trim()]; return v==null?'':v; }
+  },
+
+  defaults:{
+    newCampaignBudget:12000,
+    targetCpa:8500,
+    project:{
+      businessName:'', logoAsset:'', cta:'詳しくはこちら',
+      deliveryStatus:'オフ'
+    },
+    ad:{format:'VIDEO', imageNo:'', titleNo:'', longNo:'', descNo:'', adName:''},
+    adGroup:{name:'', paramCode:'', isExisting:false,
+             tg_location:'日本', tg_language:'日本語', tg_channel:'YouTube', deliveryStatus:''},
+    campaign:{name:'新規キャンペーン', campaignId:'', isExisting:false,
+              dailyBudget:12000, targetCpa:8500, urlNumber:''}
+  },
+  factories:{
+    newAd(seed){ return Object.assign({uid:uid('a')}, PLATFORMS.google.defaults.ad, seed||{}); },
+    newAdGroup(c, i){ const P=PLATFORMS.google;
+      return Object.assign({uid:uid('g')}, P.defaults.adGroup,
+        {name:'AG'+((i!=null?i:(c?c.adGroups.length:0))+1), ads:[P.factories.newAd()]}); },
+    newCampaign(seed){ const P=PLATFORMS.google;
+      return Object.assign({uid:uid('c')}, P.defaults.campaign,
+        {adGroups:[P.factories.newAdGroup(null,0)]}, seed||{}); },
+    existingCampaign(cpId, name){ const P=PLATFORMS.google;
+      return Object.assign({uid:uid('c')}, P.defaults.campaign,
+        {name:name!=null?name:'', campaignId:String(cpId), isExisting:true, urlNumber:'', adGroups:[]}); },
+    existingAdGroup(agId, meta){ const P=PLATFORMS.google, m=meta||{};
+      return Object.assign({uid:uid('g')}, P.defaults.adGroup,
+        {name:m.name||('AG '+agId), paramCode:m.paramCode||'', adGroupId:String(agId),
+         isExisting:true, ads:[P.factories.newAd()]}); }
+  },
+
+  /* 命名規則は YDA / Meta 踏襲 (形式記号は mediaFormats.crSuffix = i/v) */
+  naming:{
+    crName(ad, P){ return String(ad.imageNo||'') + P.fmtOf(ad).crSuffix; },
+    adName(ad, group, crName, project){
+      const head = crName + '-' + (ad.titleNo??'') + 'L' + (ad.descNo??'');
+      if(project && project.urlParams===false) return head;
+      return head + '-' + (group.paramCode||'');
+    },
+    /* Meta と同じ形（記事URL + ?ad={paramCode}）。creative= は付けない */
+    finalUrl(ad, group, adName, project){
+      const base = (project.baseArticleUrl||'');
+      if(project.urlParams===false) return base;
+      const sep = base.indexOf('?')>=0 ? '&' : '?';
+      return base + sep + 'ad=' + urlq(group.paramCode||'');
+    },
+    campaignName(urlNumber, firstAd, P){
+      const cr = firstAd ? (String(firstAd.imageNo||'CR') + P.fmtOf(firstAd).crSuffix) : 'CR';
+      return String(urlNumber) + '_' + cr + '_' + today();
+    }
+  },
+  creativeFields:['imageNo','titleNo','longNo','descNo'],
+  notSubmittedFields:[],
+  labels:{submitButton:'完成 → 保存して入稿', paramCodeLabel:'paramCode', tgDroppedWarn:''},
+
+  tree:{
+    campaignBadges(c, P, p){
+      return '<span class="chip">Demand Gen</span>'
+        + (c.dailyBudget!=null&&c.dailyBudget!=='' ? '<span class="chip">¥'+esc(c.dailyBudget)+'/日</span>' : '')
+        + (c.targetCpa!=null&&c.targetCpa!=='' ? '<span class="chip">tCPA ¥'+esc(c.targetCpa)+'</span>' : '');
+    },
+    groupBadges(g){ return '<span class="pill mono">【'+esc(g.paramCode||'—')+'】</span>'
+      + '<span class="chip">'+esc(g.tg_channel||'—')+'</span>'; },
+    adBadge(a, r){ return '<span class="cbadge">'+esc(a.imageNo||'—')+((a.format==='VIDEO')?'v':'i')+'</span>'; },
+    adSub(a, r){ return esc(a.titleNo)+'L'+esc(a.descNo); }
+  },
+
+  resolve(ad, group, ctx){
+    const P=PLATFORMS.google, p=ctx.project, refs=ctx.refs;
+    const fmt=P.fmtOf(ad);
+    const crName=P.naming.crName(ad, P);
+    const autoAdName=P.naming.adName(ad, group, crName, p);
+    const adName=String(ad.adName||'').trim() || autoAdName;
+    const me = refs.media[String(ad.imageNo)];
+    /* 画像広告は横長・正方形のどちらかがあれば作れる。表示用には先に見つかったほうを出す。 */
+    const mediaId = me ? (fmt.id==='VIDEO' ? me.video : (me.image || me.square)) : undefined;
+    const imageAsset = me ? me.image : undefined;
+    const squareAsset = me ? me.square : undefined;
+    const titleText = refs.titles[ad.titleNo];
+    const longText = (refs.longHeadlines||{})[ad.longNo];
+    const descText = (refs.descriptions||{})[ad.descNo];
+    const finalUrl = P.naming.finalUrl(ad, group, adName, p);
+    const errs=[], warns=[], errCodes=[], warnCodes=[];
+    const pushErr=(label,code)=>{ errs.push(label); errCodes.push(code); };
+    const pushWarn=(label,code)=>{ warns.push(label); warnCodes.push(code); };
+    const noStr=String(ad.imageNo||'').trim();
+    const pendingImage = (noStr!=='' && (mediaId===undefined || mediaId===''));
+    const T=P.refTables.titles.lengthLimit, L=P.refTables.longHeadlines.lengthLimit,
+          D=P.refTables.descriptions.lengthLimit;
+    if(noStr==='') pushErr('クリエイティブ未解決', EC.IMAGE_UNRESOLVED);
+    if(String(ad.titleNo||'').trim()!=='' && titleText===undefined) pushErr('見出し未解決', EC.TITLE_UNRESOLVED);
+    if(String(ad.longNo||'').trim()!=='' && longText===undefined) pushErr('長見出し未解決', EC.LONG_HEADLINE_UNRESOLVED);
+    if(String(ad.descNo||'').trim()!=='' && descText===undefined) pushErr('説明文未解決', EC.DESC_UNRESOLVED);
+    /* 動画広告は long_headlines が要る (画像広告は持たない) */
+    if(fmt.id==='VIDEO' && longText===undefined) pushErr('動画広告は長見出しが必須', EC.LONG_HEADLINE_MISSING);
+    if(titleText!==undefined && glen(titleText)>T.err) pushErr('見出し'+T.err+'字超', EC.TITLE_TOO_LONG);
+    else if(titleText!==undefined && glen(titleText)>T.warn) pushWarn('見出し'+T.warn+'字超', EC.TITLE_LONG_WARN);
+    if(longText!==undefined && glen(longText)>L.err) pushErr('長見出し'+L.err+'字超', EC.LONG_HEADLINE_TOO_LONG);
+    if(descText!==undefined && glen(descText)>D.err) pushErr('説明文'+D.err+'字超', EC.DESC_TOO_LONG);
+    else if(descText!==undefined && glen(descText)>D.warn) pushWarn('説明文'+D.warn+'字超', EC.DESC_LONG_WARN);
+    if(p.urlParams!==false && String(group.paramCode||'').trim()==='') pushErr('paramCode未入力', EC.PARAM_CODE_EMPTY);
+    /* Demand Gen の必須 (proto: business_name は REQUIRED / 画像広告の logo_images は 1-5 件) */
+    if(String(p.businessName||'').trim()==='') pushErr('ブランド名未入力', EC.BUSINESS_NAME_MISSING);
+    if(fmt.id==='IMAGE' && String(p.logoAsset||'').trim()==='') pushErr('ロゴアセット未入力', EC.LOGO_MISSING);
+    /* 地域未指定は全世界配信になる。作成自体は通るのでエラーではなく警告 */
+    if(!P.mappers.locationIds(group.tg_location, P).length) pushWarn('地域未指定（全世界配信）', EC.LOCATION_EMPTY);
+    if(pendingImage) pushWarn(fmt.id==='VIDEO'?'YouTube動画ID未登録':'画像アセット未登録', EC.MEDIA_MISSING);
+    const aid=String(group.adGroupId||'').trim();
+    return {crName, adName, autoAdName, campaignId:'', adGroupId:aid, mediaKind:fmt.apiMediaKind, imageNo:noStr,
+      mediaId:mediaId||'', imageAsset:imageAsset||'', squareAsset:squareAsset||'', pendingImage,
+      titleText:titleText===undefined?'':titleText,
+      longText:longText===undefined?'':longText,
+      descText:descText===undefined?'':descText,
+      finalUrl, errs, warns, errCodes, warnCodes, resolvedGroup:!!aid};
+  },
+
+  validateRow(row, level, ctx){
+    const errCodes=[], warnCodes=[];
+    /* budgetLevel='campaign' なので予算はキャンペーン行が持つ */
+    if(level==='campaign' && !isExistingCampaign(row)){
+      if(!(Number(row.dailyBudget)>0)) errCodes.push(EC.BUDGET_MISSING);
+    }
+    if(level==='adGroup' && !isExistingGroup(row)){
+      if(!PLATFORMS.google.mappers.locationIds(row.tg_location, PLATFORMS.google).length)
+        warnCodes.push(EC.LOCATION_EMPTY);
+    }
+    return {errCodes, warnCodes};
+  },
+
+  validateProject(p, state){
+    const errs=[];
+    if(!String((p&&p.businessName)||'').trim())
+      errs.push({code:EC.BUSINESS_NAME_MISSING, msg:'ブランド名を共通設定に入力してください（Demand Gen 広告で必須）'});
+    /* 画像広告を1件でも含むならロゴが要る (動画だけなら任意) */
+    const hasImageAd=((state&&state.campaigns)||[]).some(c=>(c.adGroups||[]).some(g=>(g.ads||[]).some(a=>a.format!=='VIDEO')));
+    if(hasImageAd && !String((p&&p.logoAsset)||'').trim())
+      errs.push({code:EC.LOGO_MISSING, msg:'画像広告があるためロゴアセットが必須です（1:1・128x128以上）'});
+    /* 予算はキャンペーン階層。コアの書き出しは広告グループ行しか検証しないため、
+       ここで見ないと budgetAmountYen:0 のまま書き出され dry-run まで気づけない。 */
+    ((state&&state.campaigns)||[]).forEach(c=>{
+      if(isExistingCampaign(c)) return;
+      if(!(Number(c.dailyBudget)>0))
+        errs.push({code:EC.BUDGET_MISSING, msg:'キャンペーン「'+String(c.name||'')+'」の日予算を入力してください'});
+    });
+    return errs;
+  },
+
+  buildPlan:{
+    campaign(c, ctx){
+      const P=PLATFORMS.google, p=ctx.project;
+      const cp={
+        name:c.name,
+        status:P.mappers.status(p.deliveryStatus, P),
+        budgetAmountYen:Number(c.dailyBudget)||0,
+        advertisingChannelType:P.enums.advertisingChannelType
+      };
+      /* 目標CPA があれば TARGET_CPA 入札。無ければ backend 側が MAXIMIZE_CONVERSIONS を選ぶ */
+      if(Number(c.targetCpa)>0) cp.targetCpaYen=Number(c.targetCpa);
+      /* 既存キャンペーンへの追加は未対応。campaignId を載せても backend の zod が落とすため、
+         「指定したのに新規作成される」誤解を生まないよう最初から出さない。 */
+      return cp;
+    },
+    adGroup(g, c, ctx){
+      const P=PLATFORMS.google, p=ctx.project;
+      const ag={
+        name:g.name,
+        status:P.mappers.status(g.deliveryStatus||p.deliveryStatus, P)
+      };
+      /* 地域・言語は広告グループ層 (Demand Gen は upgraded_targeting=true が既定) */
+      const loc=P.mappers.locationIds(g.tg_location, P); if(loc.length) ag.locationIds=loc;
+      const lang=P.mappers.languageIds(g.tg_language, P); if(lang.length) ag.languageIds=lang;
+      const ch=P.mappers.channels(g.tg_channel, P); if(ch) ag.demandGenChannels=ch;
+      /* 既存広告グループへの追加は未対応 (キャンペーンと同じ理由で adGroupId を出さない) */
+      return ag;
+    },
+    ad(a, r, g, ctx){
+      const P=PLATFORMS.google, p=ctx.project;
+      const isVideo = r.mediaKind==='VIDEO';
+      const out={
+        type:P.enums.adTypeOf[isVideo?'VIDEO':'IMAGE'],
+        adName:r.adName,
+        status:P.mappers.status(g.deliveryStatus||p.deliveryStatus, P),
+        businessName:String(p.businessName||''),
+        headlines:r.titleText?[String(r.titleText)]:[],
+        descriptions:r.descText?[String(r.descText)]:[],
+        finalUrls:[r.finalUrl]
+      };
+      const logo=String(p.logoAsset||'').trim();
+      if(isVideo){
+        out.youtubeVideoId=String(r.mediaId);
+        out.longHeadlines=r.longText?[String(r.longText)]:[];
+        if(logo) out.logoImages=[logo];
+      } else {
+        /* 画像は横長・正方形のうち登録があるものだけ送る (proto: どちらか必須) */
+        if(r.imageAsset) out.marketingImages=[String(r.imageAsset)];
+        if(r.squareAsset) out.squareMarketingImages=[String(r.squareAsset)];
+        out.logoImages=logo?[logo]:[];
+        const cta=P.mappers.cta(p.cta, P); if(cta) out.callToActionText=cta;
+      }
+      return out;
+    }
+  },
+
+  output:{
+    planVersion:1,
+    planDir:'.claude/skills/ad-ops/入稿計画',
+    samplePlanFile:'サンプルプラン_google.json',
+    fileNamePrefix:p=>(p.name||'plan')+'_Google入稿計画_',
+    submitCommand:(rel,opts)=>'webgram submit-plan --plan-file "'+rel+'"'+((opts&&opts.dryRun===false)?' --no-dry-run --yes':'')
+  },
+
+  prompts:{
+    importAccount(ctx){
+      const P=PLATFORMS.google, c=ctx||{}, mode=c.mode||'help';
+      const name=c.name||'', accId=c.accountId||'', idArg=accId||'<10桁のCustomer ID>';
+      const headName = mode==='help' ? '<アカウント名（日本語OK）>' : (name||'<アカウント名>');
+      const fileName = mode==='help' ? '<アカウント名>' : (name||'<アカウント名>');
+      const dir=P.account.dir;
+      const shape=['   - media は 管理番号 → {image(横長画像アセット), square(正方形画像アセット), video(YouTube動画ID)}',
+        '   - 動画は Google Ads API へアップロードできないため、YouTube に上げた動画のIDを入れる',
+        '   - campaigns/adGroups は campaignId/adGroupId をキーに（adGroups.paramCode はURLパラメータ）'];
+      const lines=[];
+      if(mode==='ai'){
+        lines.push('Google入稿プランナー用に、新規アカウントの参照データJSONを生成してください。','',
+          '1. まず対象アカウントを対話で決めてください:',
+          '   - webgram list --platform google --resource accounts で候補一覧を取得し、どのアカウントを追加するか私に確認して アカウント名・accountId(10桁) を確定する',
+          '2. 確定したアカウントの既存キャンペーン/広告グループを取得:',
+          '   webgram list --platform google --resource campaigns --account-id '+idArg,
+          '3. 取得結果を下記スキーマに整形し、'+dir+'/<アカウント名>.json として書き出す:');
+        shape.forEach(l=>lines.push(l));
+      } else {
+        lines.push('Google入稿プランナー用に、アカウント「'+headName+'」'+(mode==='import'&&accId?('（accountId: '+accId+'）'):'')+'の参照データJSONを生成してください。','',
+          '手順:',
+          '1. webgram CLI で対象アカウントの既存キャンペーン/広告グループを取得:',
+          '   webgram list --platform google --resource campaigns --account-id '+idArg,
+          '2. 取得結果を下記スキーマに整形して '+dir+'/'+fileName+'.json として書き出す:');
+        shape.forEach(l=>lines.push(l));
+      }
+      lines.push('', 'スキーマ:');
+      P.account.schemaLines({updatedAt:mode!=='help',
+        nameHint:mode==='help'?'<アカウント名（日本語OK）>':'<アカウント名>'}).forEach(l=>lines.push(l));
+      lines.push('');
+      lines.push(mode==='ai' ? '書き出したら、プランナー右上のアカウントプルダウン →「＋新規追加」→「📄 ファイルから追加」で その JSON を読み込めます。'
+        : mode==='import' ? '書き出したら、プランナーで「📁 フォルダ」を再接続 or アカウントセレクトを開くと自動で一覧に出ます。'
+        : '書き出したら、プランナーで「＋新規追加 →📄 ファイルから追加」or「📁 フォルダ」再接続で一覧に出ます。');
+      return lines.join('\n');
+    },
+    strategy(){
+      return ['Google広告（Demand Gen / YouTube）の入稿プランを一緒に作りたいです。まず戦略を壁打ちさせてください。','',
+        '# 前提','- アカウント: <アカウント名（日本語OK）>','- 商材 / LP: <商材名・URL>',
+        '- 予算・目標CPA: <キャンペーンの日予算 / 目標CPA>',
+        '- 動画: <YouTube にアップロード済みの動画URL または動画ID>',
+        '- 訴求したいポイント: <強み・オファー・ターゲット層>','',
+        '# お願い',
+        '1. 上記をもとに配信面（YouTube / Discover / Gmail）・キャンペーン/広告グループ構成・訴求軸を提案してください。',
+        '2. 私が「OK」と言ったら、その戦略を ad-ops Skill の「サンプルプラン_google.json」に書き出して（上書きして）ください。',
+        '   - 保存先: .claude/skills/ad-ops/サンプルプラン_google.json',
+        '   - フォーマット: {"schemaVersion":'+SCHEMA_VERSION+', "platform":"google", "accountId":"<10桁のCustomer ID>", "campaigns":[ ... ]}',
+        '   - campaigns には キャンペーン(dailyBudget / targetCpa) → 広告グループ(paramCode / 地域 / 言語 / 配信面) → 広告(形式 IMAGE|VIDEO / クリエイティブ番号 / 見出し番号 / 長見出し番号 / 説明文番号) の構成を入れてください。',
+        '   - 動画広告（VIDEO）は長見出しが必須です。',
+        '3. 書き出したら、プランナーを開き直す（またはリロードして媒体を Google に切り替える）と内容が自動で表示されます。'].join('\n');
+    },
+    submitHelp(ctx){
+      const P=PLATFORMS.google, c=ctx||{}, rel=c.savedRel, dir=P.output.planDir;
+      const lines=['入稿を試みてください。手順:',
+        '1) 入稿計画JSON（'+c.fileName+'）を ad-ops Skill の入稿計画フォルダに置く（保存先: '+rel+'）。',
+        '   ・入稿計画フォルダ（'+dir+'/）に無ければ、ダウンロードフォルダ（~/Downloads/'+c.fileName+'）を探して上記パスへ移動する。',
+        (c.wrote? '   ・プランナーからは既に入稿計画フォルダへ保存済みのはず。' : '   ・フォルダ未接続のためダウンロード済み。~/Downloads から移動してください。'),
+        '2) 置いたパスで dry-run 入稿を実行:',
+        '   '+P.output.submitCommand(rel,{dryRun:true}),
+        '',
+        '※ Google は実 API での入稿検証が未了です。初回は PAUSED・1キャンペーン・最小予算で流し、管理画面で目視確認してください。'];
+      return lines.join('\n');
+    },
+    afterSave(ctx){
+      const P=PLATFORMS.google, c=ctx||{};
+      return 'プラン「'+c.name+'」v'+c.versionId+' を保存しました。\n入稿するには「入稿JSON書き出し」を押し、生成された *_Google入稿計画_*.json を指定して dry-run してください:\n\n'
+        + P.output.submitCommand('<入稿計画JSONのパス>',{dryRun:true});
+    }
+  },
+  docTabs:[{id:'overview',label:'概要'},{id:'video',label:'動画広告'},
+           {id:'image',label:'画像広告'},{id:'param',label:'パラメータ'},{id:'guide',label:'運用手順'}]
+};
+
+/* ============================================================
+   ByteDance (TikTok) — 記事LP誘導の最小構成
+   objective_type=TRAFFIC / promotion_type=WEBSITE / optimization_goal=CLICK
+   billing_event=CPC / ad_format=SINGLE_VIDEO / creative_material_mode=CUSTOM
+   ------------------------------------------------------------
+   CV最適化 (WEB_CONVERSIONS + pixel) ・画像広告 (SINGLE_IMAGE) ・カルーセル・
+   Spark Ads は対象外。動画とカバー画像は**アップロード済みのID**を refs に持つ
+   (プランナーからのローカルアップロードは未対応。CLI 側の videoPath /
+   coverImagePath は手書きの計画ファイルからは使える)。
+   ============================================================ */
+const BYTEDANCE_REF_TABLES = {
+  /* TikTok の広告文は 1 本 (ad_text)。見出し/説明文の 2 段構えを持たない */
+  titles:{ key:'titles', label:'広告文', countLabel:'広告文', editable:true, copyable:true, required:true,
+    keyKind:'number', keyLabel:'番号', keyWidth:'70px', dropEmpty:true,
+    addSub:'番号→広告文（100字まで）',
+    emptyMsg:'該当する広告文がありません',
+    lengthLimit:{warn:80, err:100},
+    valueFields:[{k:'text', label:'文言'}],
+    keyCell:no=>'<td class="mono">'+esc(no)+'</td>',
+    columns:[
+      {label:'広告文', cls:'reftext', attr:(no,v)=>' title="'+esc(v)+'"', cell:(no,v)=>esc(v)},
+      {label:'文字数', width:'70px', cls:(no,v)=>'reflen '+refLenCls(BYTEDANCE_REF_TABLES.titles,v), cell:(no,v)=>glen(v)}
+    ],
+    optionLabel:v=>String(v==null?'':v) },
+  /* video = アセットライブラリの video_id、cover = カバー画像の image_id。
+     SINGLE_VIDEO は**カバー画像が必須**なので、動画だけでは広告を作れない。 */
+  media:{ key:'media', label:'クリエイティブ', countLabel:'クリエイティブ', editable:true, required:true,
+    keyKind:'number', keyLabel:'番号', keyWidth:'80px',
+    addSub:'番号→動画ID / カバー画像ID',
+    emptyMsg:'該当するクリエイティブがありません',
+    valueFields:[{k:'video', label:'動画ID (video_id)', editLabel:'動画ID'},
+                 {k:'cover', label:'カバー画像ID (image_id)', editLabel:'カバー画像ID'}],
+    keyCell:no=>'<td><span class="sw" style="display:inline-flex;width:26px;height:26px;vertical-align:middle">'+esc(no)+'</span> '+newBadge('media',no)+'</td>',
+    columns:[
+      {label:'動画ID',       cls:'mono', cell:(no,v)=>esc(v&&v.video||'—')},
+      {label:'カバー画像ID', cls:'mono', cell:(no,v)=>esc(v&&v.cover||'—')}
+    ],
+    optionLabel:v=>((v&&v.video)?'VID':'')+((v&&v.video&&v.cover)?'/':'')+((v&&v.cover)?'COV':''),
+    drawerLabel:v=>'VID '+esc(v&&v.video||'—')+' ／ COV '+esc(v&&v.cover||'—') },
+  /**
+   * 地域名 → location_id。**TikTok の地域IDは独自採番で公開一覧が無い**ので、
+   * `webgram list --platform bytedance --resource regions` で引いてここに入れる。
+   * 決め打ちの値（`1210023`）は本番で invalid だった。
+   */
+  regions:{ key:'regions', label:'地域', countLabel:'地域', editable:true, required:false,
+    keyKind:'string', keyLabel:'地域名', keyWidth:'140px',
+    addSub:'地域名→location_id（webgram list --resource regions で取得）',
+    emptyMsg:'地域がありません（webgram list --platform bytedance --resource regions で取り込む）',
+    valueFields:[{k:'id', label:'location_id', editLabel:'location_id'}],
+    keyCell:no=>'<td>'+esc(no)+'</td>',
+    columns:[
+      {label:'location_id', cls:'mono', cell:(no,v)=>esc(typeof v==='string'?v:(v&&v.id)||'—')}
+    ],
+    optionLabel:v=>String(typeof v==='string'?v:(v&&v.id)||'') },
+  adGroups:{ key:'adGroups', label:'広告グループ', countLabel:'広告グループ', editable:false, required:false,
+    keyKind:'string', keyLabel:'広告グループID', keyWidth:'130px',
+    emptyMsg:'既存の広告グループがありません（アカウントJSONの refs.adGroups）',
+    valueFields:[{k:'name',label:'名'},{k:'paramCode',label:'paramCode'},{k:'campaignId',label:'キャンペーンID'}],
+    keyCell:no=>'<td class="mono">'+esc(no)+'</td>',
+    columns:[
+      {label:'広告グループ名', cls:'reftext', attr:(no,v)=>' title="'+esc(v&&v.name||'')+'"', cell:(no,v)=>esc(v&&v.name||'')},
+      {label:'paramCode', width:'130px', cls:'mono', cell:(no,v)=>esc(v&&v.paramCode||'')},
+      {label:'キャンペーンID', width:'130px', cls:'mono', cell:(no,v)=>esc(v&&v.campaignId||'')}
+    ] },
+  campaigns:{ key:'campaigns', label:'キャンペーン', countLabel:'キャンペーン', editable:false, required:false,
+    keyKind:'string', keyLabel:'キャンペーンID', keyWidth:'130px',
+    emptyMsg:'既存のキャンペーンがありません（アカウントJSONの refs.campaigns）',
+    valueFields:[{k:'name',label:'名'}],
+    keyCell:no=>'<td class="mono">'+esc(no)+'</td>',
+    columns:[
+      {label:'キャンペーン名', cls:'reftext', attr:(no,v)=>' title="'+esc(v&&v.name||'')+'"', cell:(no,v)=>esc(v&&v.name||'')}
+    ] }
+};
+
+const BYTEDANCE_COLS = {
+  ads:[
+    {field:'imageNo', label:'クリエイティブ番号', kind:'refcombo', refTable:'media', drawerType:'media',
+     width:'6ch', sequenceable:true, errCodes:[EC.IMAGE_UNRESOLVED, EC.COVER_MISSING],
+     ghostKey:'media', ddTitle:'登録クリエイティブから選択',
+     ghostTitle:r=>'動画 '+r.mediaId+(r.coverId?(' / カバー '+r.coverId):''),
+     ghost:(r,a)=>{ if(!a.imageNo) return '<span class="idpill" style="color:var(--faint)">—</span>';
+       if(r.errCodes.includes(EC.COVER_MISSING)) return '<span class="idpill err" title="SINGLE_VIDEO はカバー画像が必須">カバー無し</span>';
+       if(r.mediaId!=='') return '<span class="idpill">VID '+esc(r.mediaId)+'</span>';
+       if(r.pendingImage) return '<span class="idpill warn" title="アカウント未登録。入稿前にアップロードして新規登録">🆕未登録</span>';
+       return '<span class="idpill err">#N/A</span>'; }},
+    {field:'titleNo', label:'広告文番号', kind:'refcombo', refTable:'titles', drawerType:'titles',
+     width:'6ch', sequenceable:true, errCodes:[EC.TITLE_UNRESOLVED, EC.TITLE_TOO_LONG],
+     ghostKey:'title', ddTitle:'広告文一覧から選択', ghostTitle:r=>r.titleText,
+     ghost:r=>r.errCodes.includes(EC.TITLE_UNRESOLVED)?'<span class="err">未解決</span>':esc(r.titleText.slice(0,40))},
+    {field:'paramCode', label:'paramCode(広告グループ)', kind:'mono', width:'120px',
+     scope:'parentGroup', sequenceable:true, readonlyOnExisting:true, errCodes:[EC.PARAM_CODE_EMPTY],
+     title:'広告グループ共通（変更で同グループ全広告に反映）。最終URLは 記事URL?ad={paramCode}',
+     hidden:p=>urlParamsOff(p),
+     roStyle:'input', roTitle:'既存広告グループのため編集不可'},
+    {field:'finalUrl', label:'最終リンク先URL', kind:'mono', width:'240px',
+     alwaysReadonly:true, roStyle:'input',
+     roTitle:'自動生成（編集不可）。変えるときは 案件設定の記事URL / paramCode を直します',
+     get:(row,ctx)=>ctx.r?ctx.r.finalUrl:''},
+    /* 未登録クリエイティブ用のローカルパス。**本実行の直前に CLI がアップロードして
+       videoId / imageIds に解決する** (dry-run では上げない)。Meta / YDA と同じ運用。 */
+    {field:'videoPath', label:'動画パス', kind:'mono', width:'150px',
+     title:'クリエイティブ番号が参照データに無い（未登録）ときだけ使う。入稿前に CLI が自動アップロードして動画IDに解決する',
+     errCodes:[EC.IMAGE_PATH_MISSING], placeholder:()=>'例: media/ad.mp4'},
+    {field:'coverImagePath', label:'カバー画像パス', kind:'mono', width:'150px',
+     title:'カバー画像が未登録のときだけ使う。SINGLE_VIDEO はカバー画像が必須なので、動画だけでは入稿できない',
+     errCodes:[EC.COVER_MISSING], placeholder:()=>'例: media/cover.jpg'},
+    {field:'adName', label:'広告名', kind:'mono', width:'170px',
+     title:'空欄なら自動生成（{番号}v-{広告文番号}-{paramCode}）',
+     placeholder:ctx=>ctx.r?ctx.r.autoAdName:''},
+    {field:'adGroupId', label:'CP / AG ID', kind:'derived',
+     derive:(a,ctx)=>'<span class="idpill '+(ctx.r.resolvedGroup?'':'warn')+'" data-d="'+a.uid+'-ids">'+esc(ctx.r.adGroupId?('AG '+ctx.r.adGroupId):'新規')+'</span>'}
+  ],
+  adGroups:[
+    {field:'adGroupId', label:'広告グループID', kind:'badge', alwaysReadonly:true},
+    {field:'name', label:'広告グループ名', kind:'text', width:'150px', required:true,
+     readonlyOnExisting:true, roTitle:'既存広告グループのため編集不可'},
+    {field:'paramCode', label:'paramCode', kind:'mono', width:'120px', required:true,
+     sequenceable:true, readonlyOnExisting:true, hidden:p=>urlParamsOff(p),
+     title:'URL生成用のパラメータ（広告グループ紐づけには不使用）'},
+    /* budgetLevel='adGroup' → 予算・入札・最適化は広告グループが持つ (TikTok の必須項目) */
+    {field:'dailyBudget', label:'日予算(円)', kind:'number', width:'84px', required:true,
+     coerce:numOrNull, readonlyOnExisting:true, roEmptyDash:true, errCodes:[EC.BUDGET_MISSING],
+     placeholder:()=>String(pf().defaults.newAdGroupBudget)},
+    {field:'tg_location', label:'地域', kind:'tgpick', tgKey:'tg_location', readonlyOnExisting:true, roEmptyDash:true,
+     title:'TikTok は地域を 1 つ以上指定しないと入稿できません'},
+    {field:'tg_placement', label:'配信面', kind:'tgpick', tgKey:'tg_placement', readonlyOnExisting:true, roEmptyDash:true,
+     title:'自動配置なら TikTok が配信先を決めます。TikTok のみに絞ることもできます'},
+    {field:'deliveryStatus', label:'配信', kind:'select', options:['','オフ','オン'], minWidth:'66px',
+     readonlyOnExisting:true, roEmptyDash:true, coerce:v=>{const s=String(v).trim(); return (s==='オフ'||s==='オン')?s:'';}}
+  ],
+  campaigns:[
+    {field:'campaignId', label:'キャンペーンID', kind:'badge', alwaysReadonly:true},
+    {field:'name', label:'キャンペーン名', kind:'text', width:'170px', required:true,
+     readonlyOnExisting:true, roTitle:'既存キャンペーンのため編集不可'},
+    {field:'urlNumber', label:'リンク番号', kind:'mono', width:'54px', hideOnExisting:true}
+  ]
+};
+
+PLATFORMS.bytedance = {
+  id:'bytedance', displayName:'TikTok', brandTitle:'TikTok入稿プランナー',
+
+  account:{
+    idPattern:/^\d+$/, idHint:'TikTok 広告アカウントID（advertiser_id・数値）', dir:'アカウント/bytedance',
+    apply(obj, project){
+      if(obj.accountId!=null) project.accountId = String(obj.accountId);
+      if(obj.name!=null) project.accountName=String(obj.name);
+      if(obj.principal!=null) project.principal=String(obj.principal);
+      if(obj.identityId!=null) project.identityId=String(obj.identityId);
+      if(obj.identityType!=null) project.identityType=String(obj.identityType);
+      /* BC_AUTH_TT では identity_authorized_bc_id が必須。**本番実測で identity は
+         ほぼ BC_AUTH_TT**（4アカウントで各14件。CUSTOMIZED_USER は 0〜2件）なので、
+         これが無いと実運用で使える identity を選べない */
+      if(obj.identityAuthorizedBcId!=null) project.identityAuthorizedBcId=String(obj.identityAuthorizedBcId);
+      if(obj.projectName) project.name=obj.projectName;
+      if(obj.baseArticleUrl) project.baseArticleUrl=obj.baseArticleUrl;
+      if(obj.urlParamsEnabled!=null) project.urlParams=!!obj.urlParamsEnabled; else delete project.urlParams;
+    },
+    schemaLines(opts){
+      const o=opts||{};
+      return ['{','  "accountJsonVersion": 1,','  "platform": "bytedance",','  "accountId": "<advertiser_id（数値）>",',
+        '  "name": "'+(o.nameHint||'<アカウント名>')+'",',
+        '  "identityId": "<identity_id（webgram list --resource identities）>",',
+        '  "identityType": "BC_AUTH_TT",',
+        '  "identityAuthorizedBcId": "<BC_AUTH_TT のとき必須。identities の authorizedBcId>",']
+        .concat(o.updatedAt===false?[]:['  "updatedAt": "<ISO8601>",'])
+        .concat([
+        '  "refs": {',
+        '    "titles": {"1": "広告文（100字まで）"},',
+        '    "media": {"1": {"video": "<video_id>", "cover": "<カバー画像の image_id>"}},',
+        '    "regions": {"日本": "<location_id（webgram list --resource regions）>"},',
+        '    "campaigns": {"<campaignId>": {"name": "CP名"}},',
+        '    "adGroups": {"<adGroupId>": {"name": "広告グループ名", "campaignId": "<campaignId>", "paramCode": "<code>"}}',
+        '  }','}']);
+    }
+  },
+
+  levels:{
+    campaign:{label:'キャンペーン', childKey:'adGroups', planKey:'adGroups'},
+    adGroup :{label:'広告グループ', childKey:'ads',      planKey:'ads'},
+    ad      :{label:'広告'}
+  },
+  budgetLevel:'adGroup',
+  consoleUrl:'https://ads.tiktok.com/i18n/perf/creative?aadvid={accountId}',
+  consoleResourceMap:{campaigns:'campaign', adGroups:'adgroup', ads:'ad'},
+
+  /* SINGLE_VIDEO のみ。画像広告 (SINGLE_IMAGE) とカルーセルは対象外 */
+  mediaFormats:[
+    {id:'VIDEO', crSuffix:'v', mediaKey:'video', apiMediaKind:'VIDEO', label:'動画'}
+  ],
+  fmtOf(){ return PLATFORMS.bytedance.mediaFormats[0]; },
+
+  refTables:BYTEDANCE_REF_TABLES,
+  sheets:BYTEDANCE_COLS,
+
+  projectFields:[
+    {key:'identityId', label:'identity ID', kind:'text', width:'18ch', fallback:'',
+     title:'広告主として表示される TikTok アカウントの identity_id。webgram list --platform bytedance --resource identities で取得。**未入力では広告が作れません**'},
+    {key:'identityType', label:'identity種別', kind:'select',
+     options:['BC_AUTH_TT','CUSTOMIZED_USER','TT_USER','AUTH_CODE'],
+     title:'本番実測ではほぼ BC_AUTH_TT（Business Center 経由で認可された TikTok アカウント）。BC_AUTH_TT では下の BC ID が必須'},
+    {key:'identityAuthorizedBcId', label:'BC ID', kind:'text', width:'18ch', fallback:'',
+     title:'identity種別が BC_AUTH_TT のとき必須。identities の authorizedBcId をそのまま入れる'},
+    {key:'cta', label:'CTA', kind:'select',
+     options:['詳しくはこちら','今すぐ購入','登録する','ダウンロード','お問い合わせ','今すぐ申し込む',
+              '予約する','注文する','今すぐ見る','続きを読む','購読する'],
+     title:'広告のボタン文言'},
+    {key:'deliveryStatus', label:'配信', kind:'select', options:['オフ','オン'],
+     title:'TikTok は実 API 検証が未了のため、オンでは入稿できません（backend が拒否します）'},
+    {key:'baseArticleUrl', label:'記事URL', kind:'text', width:'16ch', fallback:''},
+    {key:'urlParams', label:'URLパラメータ', kind:'toggle', fallback:true,
+     title:'OFF にすると最終リンク先URLに ?ad= を付けません（案件単位）'}
+  ],
+  fixedType:[{label:'キャンペーン目的',value:'TRAFFIC（ウェブサイトへの誘導）'}],
+
+  targeting:{
+    tg_location:{label:'地域', multi:true, allLabel:'', opts:['日本']},
+    tg_placement:{label:'配信面', multi:false, allLabel:'自動配置', opts:['自動配置','TikTok のみ']}
+  },
+
+  enums:{
+    /**
+     * **地域は enum を持たない**。location_id は TikTok 独自の採番で、公開ドキュメントに
+     * 一覧が無い（`1210023` を決め打ちしていたところ、本番で
+     * `code=40002 At least 1 location ID is invalid` になった）。
+     * アカウントJSONの `refs.regions`（`{地域名: location_id}`）を正とし、
+     * `webgram list --platform bytedance --resource regions` で取り込む。
+     */
+    /* CTA は TikTok の call_to_action enum */
+    cta:{'詳しくはこちら':'LEARN_MORE','今すぐ購入':'SHOP_NOW','登録する':'SIGN_UP',
+         'ダウンロード':'DOWNLOAD','お問い合わせ':'CONTACT_US','今すぐ申し込む':'APPLY_NOW',
+         '予約する':'BOOK_NOW','注文する':'ORDER_NOW','今すぐ見る':'WATCH_NOW',
+         '続きを読む':'READ_MORE','購読する':'SUBSCRIBE'},
+    /* TikTok の配信オンは ENABLE (yda/meta は ACTIVE / google は ENABLED) */
+    statusOn:'ENABLE', statusOff:'DISABLE',
+    objectiveType:'TRAFFIC',
+    promotionType:'WEBSITE',
+    optimizationGoal:'CLICK',
+    billingEvent:'CPC',
+    creativeMaterialMode:'CUSTOM',
+    adFormat:'SINGLE_VIDEO',
+    identityType:'BC_AUTH_TT'
+  },
+
+  mappers:{
+    status(s, P){ return s==='オン'?P.enums.statusOn:P.enums.statusOff; },
+    /**
+     * 地域名 → location_id。**参照データ (`refs.regions`) から引く**。
+     * refs が渡らない呼び出し（`validateRow`）では解決できないので空を返す。
+     * その場合の地域チェックは `resolve` 側（REGION_UNRESOLVED）で行う。
+     */
+    locationIds(s, P, refs){
+      const table=(refs && refs.regions) || {};
+      return tgList(s)
+        .filter(n=>n!==P.targeting.tg_location.allLabel)
+        /* 参照データは {"日本": "123"} でも {"日本": {"id": "123"}} でも受ける */
+        .map(n=>{ const v=table[n]; return (v && typeof v==='object') ? v.id : v; })
+        .filter(v=>v!=null && String(v).trim()!=='')
+        .map(String);
+    },
+    /* 自動配置なら placements キーを出さない (PLACEMENT_TYPE_NORMAL のときだけ必須) */
+    placement(s, P){
+      const l=tgList(s);
+      if(!l.length || l.indexOf(P.targeting.tg_placement.allLabel)>=0) {
+        return {placementType:'PLACEMENT_TYPE_AUTOMATIC'};
+      }
+      return {placementType:'PLACEMENT_TYPE_NORMAL', placements:['PLACEMENT_TIKTOK']};
+    },
+    cta(label, P){ const v=P.enums.cta[String(label||'').trim()]; return v==null?'':v; }
+  },
+
+  defaults:{
+    newAdGroupBudget:5000,
+    project:{
+      identityId:'', identityType:'BC_AUTH_TT', identityAuthorizedBcId:'', cta:'詳しくはこちら',
+      deliveryStatus:'オフ'
+    },
+    ad:{imageNo:'', titleNo:'', videoPath:'', coverImagePath:'', adName:''},
+    adGroup:{name:'', paramCode:'', isExisting:false, dailyBudget:5000,
+             tg_location:'日本', tg_placement:'自動配置', deliveryStatus:''},
+    campaign:{name:'新規キャンペーン', campaignId:'', isExisting:false, urlNumber:''}
+  },
+  factories:{
+    newAd(seed){ return Object.assign({uid:uid('a')}, PLATFORMS.bytedance.defaults.ad, seed||{}); },
+    newAdGroup(c, i){ const P=PLATFORMS.bytedance;
+      return Object.assign({uid:uid('g')}, P.defaults.adGroup,
+        {name:'AG'+((i!=null?i:(c?c.adGroups.length:0))+1), ads:[P.factories.newAd()]}); },
+    newCampaign(seed){ const P=PLATFORMS.bytedance;
+      return Object.assign({uid:uid('c')}, P.defaults.campaign,
+        {adGroups:[P.factories.newAdGroup(null,0)]}, seed||{}); },
+    existingCampaign(cpId, name){ const P=PLATFORMS.bytedance;
+      return Object.assign({uid:uid('c')}, P.defaults.campaign,
+        {name:name!=null?name:'', campaignId:String(cpId), isExisting:true, urlNumber:'', adGroups:[]}); },
+    existingAdGroup(agId, meta){ const P=PLATFORMS.bytedance, m=meta||{};
+      return Object.assign({uid:uid('g')}, P.defaults.adGroup,
+        {name:m.name||('AG '+agId), paramCode:m.paramCode||'', adGroupId:String(agId),
+         isExisting:true, ads:[P.factories.newAd()]}); }
+  },
+
+  /* 命名規則は YDA / Meta / Google 踏襲。TikTok は説明文を持たないので L 区間が無い */
+  naming:{
+    crName(ad, P){ return String(ad.imageNo||'') + P.fmtOf(ad).crSuffix; },
+    adName(ad, group, crName, project){
+      const head = crName + '-' + (ad.titleNo??'');
+      if(project && project.urlParams===false) return head;
+      return head + '-' + (group.paramCode||'');
+    },
+    /* Meta / Google と同じ形（記事URL + ?ad={paramCode}） */
+    finalUrl(ad, group, adName, project){
+      const base = (project.baseArticleUrl||'');
+      if(project.urlParams===false) return base;
+      const sep = base.indexOf('?')>=0 ? '&' : '?';
+      return base + sep + 'ad=' + urlq(group.paramCode||'');
+    },
+    campaignName(urlNumber, firstAd, P){
+      const cr = firstAd ? (String(firstAd.imageNo||'CR') + P.fmtOf(firstAd).crSuffix) : 'CR';
+      return String(urlNumber) + '_' + cr + '_' + today();
+    }
+  },
+  creativeFields:['imageNo','titleNo','videoPath','coverImagePath'],
+  notSubmittedFields:[],
+  labels:{submitButton:'完成 → 保存して入稿', paramCodeLabel:'paramCode', tgDroppedWarn:''},
+
+  tree:{
+    campaignBadges(c, P, p){ return '<span class="chip">TRAFFIC</span>'; },
+    groupBadges(g){ return '<span class="pill mono">【'+esc(g.paramCode||'—')+'】</span>'
+      + (g.dailyBudget!=null&&g.dailyBudget!=='' ? '<span class="chip">¥'+esc(g.dailyBudget)+'/日</span>' : '')
+      + '<span class="chip">'+esc(g.tg_placement||'—')+'</span>'; },
+    adBadge(a, r){ return '<span class="cbadge">'+esc(a.imageNo||'—')+'v</span>'; },
+    adSub(a, r){ return esc(a.titleNo); }
+  },
+
+  resolve(ad, group, ctx){
+    const P=PLATFORMS.bytedance, p=ctx.project, refs=ctx.refs;
+    const crName=P.naming.crName(ad, P);
+    const autoAdName=P.naming.adName(ad, group, crName, p);
+    const adName=String(ad.adName||'').trim() || autoAdName;
+    const me = refs.media[String(ad.imageNo)];
+    const mediaId = me ? me.video : undefined;
+    const coverId = me ? me.cover : undefined;
+    const titleText = refs.titles[ad.titleNo];
+    const finalUrl = P.naming.finalUrl(ad, group, adName, p);
+    const errs=[], warns=[], errCodes=[], warnCodes=[];
+    const pushErr=(label,code)=>{ errs.push(label); errCodes.push(code); };
+    const pushWarn=(label,code)=>{ warns.push(label); warnCodes.push(code); };
+    const noStr=String(ad.imageNo||'').trim();
+    const pendingImage = (noStr!=='' && (mediaId===undefined || mediaId===''));
+    /* 未登録クリエイティブ用のローカルパス。本実行の直前に CLI がアップロードして解決する */
+    const videoPath=String(ad.videoPath||'').trim();
+    const coverPath=String(ad.coverImagePath||'').trim();
+    const hasVideo = (mediaId!==undefined && mediaId!=='') || videoPath!=='';
+    const hasCover = (coverId!==undefined && coverId!=='') || coverPath!=='';
+    const T=P.refTables.titles.lengthLimit;
+    if(noStr==='') pushErr('クリエイティブ未解決', EC.IMAGE_UNRESOLVED);
+    /* 未登録なのにローカルパスも無ければ、アップロードするものが無い = 入稿できない。
+       YDA は warn 止まりだが、TikTok は素材が無いと広告そのものが作れないので err にする */
+    else if(!hasVideo) pushErr('動画パス未入力（未登録クリエイティブ）', EC.IMAGE_PATH_MISSING);
+    /* SINGLE_VIDEO はカバー画像が必須。動画だけでは広告を作れない */
+    if(noStr!=='' && hasVideo && !hasCover) pushErr('カバー画像未登録（パス未入力）', EC.COVER_MISSING);
+    /* 解決済みなのにパスも入っていると、CLI が余計にアップロードして課金対象の素材が増える */
+    if(mediaId!==undefined && mediaId!=='' && videoPath!=='')
+      pushWarn('動画パス無視（クリエイティブ番号が解決済み）', EC.IMAGE_PATH_IGNORED);
+    if(coverId!==undefined && coverId!=='' && coverPath!=='')
+      pushWarn('カバー画像パス無視（登録済み）', EC.IMAGE_PATH_IGNORED);
+    if(String(ad.titleNo||'').trim()!=='' && titleText===undefined) pushErr('広告文未解決', EC.TITLE_UNRESOLVED);
+    if(String(ad.titleNo||'').trim()==='') pushErr('広告文未解決', EC.TITLE_UNRESOLVED);
+    if(titleText!==undefined && glen(titleText)>T.err) pushErr('広告文'+T.err+'字超', EC.TITLE_TOO_LONG);
+    else if(titleText!==undefined && glen(titleText)>T.warn) pushWarn('広告文'+T.warn+'字超', EC.TITLE_LONG_WARN);
+    if(p.urlParams!==false && String(group.paramCode||'').trim()==='') pushErr('paramCode未入力', EC.PARAM_CODE_EMPTY);
+    /* identity は広告作成の必須項目 (Meta の pageId 相当)。無いと必ず落ちる */
+    if(String(p.identityId||'').trim()==='') pushErr('identity ID 未入力', EC.IDENTITY_MISSING);
+    /* BC_AUTH_TT は identity_authorized_bc_id が必須。実運用の identity はほぼこれ */
+    if(String(p.identityType||'')==='BC_AUTH_TT' && String(p.identityAuthorizedBcId||'').trim()==='')
+      pushErr('BC ID 未入力（identity種別 BC_AUTH_TT）', EC.IDENTITY_BC_MISSING);
+    /* TikTok は地域を 1 つ以上指定しないと入稿できない (未指定は全世界配信ではなく API エラー)。
+       location_id は参照データから引くので、名前を選んでいても未取込なら解決できない */
+    if(!tgList(group.tg_location).filter(n=>n!==P.targeting.tg_location.allLabel).length)
+      pushErr('地域未指定', EC.LOCATION_EMPTY);
+    else if(!P.mappers.locationIds(group.tg_location, P, refs).length)
+      pushErr('地域IDが未解決（参照データの regions を取り込んでください）', EC.REGION_UNRESOLVED);
+    if(pendingImage) pushWarn('動画ID未登録', EC.MEDIA_MISSING);
+    const aid=String(group.adGroupId||'').trim();
+    return {crName, adName, autoAdName, campaignId:'', adGroupId:aid, mediaKind:'VIDEO', imageNo:noStr,
+      mediaId:mediaId||'', coverId:coverId||'', pendingImage, videoPath, coverPath,
+      titleText:titleText===undefined?'':titleText,
+      finalUrl, errs, warns, errCodes, warnCodes, resolvedGroup:!!aid};
+  },
+
+  validateRow(row, level, ctx){
+    const errCodes=[], warnCodes=[];
+    const P=PLATFORMS.bytedance;
+    /* budgetLevel='adGroup' なので予算は広告グループ行が持つ */
+    if(level==='adGroup' && !isExistingGroup(row)){
+      if(!(Number(row.dailyBudget)>0)) errCodes.push(EC.BUDGET_MISSING);
+      /* ここは refs を受け取れないので「選んでいるか」だけを見る。
+         location_id に解決できるかは resolve が REGION_UNRESOLVED で拾う */
+      if(!tgList(row.tg_location).filter(n=>n!==P.targeting.tg_location.allLabel).length)
+        errCodes.push(EC.LOCATION_EMPTY);
+    }
+    return {errCodes, warnCodes};
+  },
+
+  validateProject(p, state){
+    const errs=[];
+    if(!String((p&&p.identityId)||'').trim())
+      errs.push({code:EC.IDENTITY_MISSING,
+        msg:'identity ID を共通設定に入力してください（webgram list --platform bytedance --resource identities で取得）'});
+    if(String((p&&p.identityType)||'')==='BC_AUTH_TT' && !String((p&&p.identityAuthorizedBcId)||'').trim())
+      errs.push({code:EC.IDENTITY_BC_MISSING,
+        msg:'identity種別が BC_AUTH_TT なので BC ID が必須です（identities の authorizedBcId）'});
+    return errs;
+  },
+
+  buildPlan:{
+    campaign(c, ctx){
+      const P=PLATFORMS.bytedance, p=ctx.project;
+      return {
+        name:c.name,
+        objectiveType:P.enums.objectiveType,
+        /* 予算は広告グループ側で持つ。CP 側は無制限 */
+        budgetMode:'BUDGET_MODE_INFINITE',
+        operationStatus:P.mappers.status(p.deliveryStatus, P)
+      };
+    },
+    adGroup(g, c, ctx){
+      const P=PLATFORMS.bytedance, p=ctx.project;
+      const first=(g.ads||[])[0];
+      const ag={
+        name:g.name,
+        promotionType:P.enums.promotionType,
+        optimizationGoal:P.enums.optimizationGoal,
+        billingEvent:P.enums.billingEvent,
+        creativeMaterialMode:P.enums.creativeMaterialMode,
+        budgetMode:'BUDGET_MODE_DAY',
+        budget:Number(g.dailyBudget)||0,
+        landingPageUrl:P.naming.finalUrl(first||{}, g, '', p),
+        operationStatus:P.mappers.status(g.deliveryStatus||p.deliveryStatus, P)
+      };
+      const loc=P.mappers.locationIds(g.tg_location, P, ctx.refs); if(loc.length) ag.locationIds=loc;
+      Object.assign(ag, P.mappers.placement(g.tg_placement, P));
+      return ag;
+    },
+    ad(a, r, g, ctx){
+      const P=PLATFORMS.bytedance, p=ctx.project;
+      const out={
+        adName:r.adName,
+        identityId:String(p.identityId||''),
+        identityType:String(p.identityType||P.enums.identityType),
+        /* BC_AUTH_TT では必須。**出さないと backend の zod が 400 を返す**
+           （実運用の identity はほぼ BC_AUTH_TT なので、これが無いと入稿できない） */
+        ...(String(p.identityType||P.enums.identityType)==='BC_AUTH_TT' && String(p.identityAuthorizedBcId||'').trim()
+          ? {identityAuthorizedBcId:String(p.identityAuthorizedBcId).trim()} : {}),
+        adFormat:P.enums.adFormat,
+        adText:String(r.titleText||''),
+        callToAction:P.mappers.cta(p.cta, P),
+        landingPageUrl:r.finalUrl,
+        operationStatus:P.mappers.status(g.deliveryStatus||p.deliveryStatus, P)
+      };
+      /* 解決済みなら ID、未登録ならローカルパスを出す。**両方を同時に載せない** —
+         CLI は videoPath / coverImagePath があると必ずアップロードするので、
+         ID が既にある行にパスを添えると素材が二重に増える (差し替えたいときは番号を空にする) */
+      if(r.mediaId) out.videoId=String(r.mediaId);
+      else if(r.videoPath) out.videoPath=r.videoPath;
+      if(r.coverId) out.imageIds=[String(r.coverId)];
+      else if(r.coverPath) out.coverImagePath=r.coverPath;
+      return out;
+    }
+  },
+
+  output:{
+    planVersion:1,
+    planDir:'.claude/skills/ad-ops/入稿計画',
+    samplePlanFile:'サンプルプラン_bytedance.json',
+    fileNamePrefix:p=>(p.name||'plan')+'_TikTok入稿計画_',
+    submitCommand:(rel,opts)=>'webgram submit-plan --plan-file "'+rel+'"'+((opts&&opts.dryRun===false)?' --no-dry-run --yes':'')
+  },
+
+  prompts:{
+    importAccount(ctx){
+      const P=PLATFORMS.bytedance, c=ctx||{}, mode=c.mode||'help';
+      const name=c.name||'', accId=c.accountId||'', idArg=accId||'<advertiser_id>';
+      const headName = mode==='help' ? '<アカウント名（日本語OK）>' : (name||'<アカウント名>');
+      const fileName = mode==='help' ? '<アカウント名>' : (name||'<アカウント名>');
+      const dir=P.account.dir;
+      const shape=['   - identityId は 広告主として表示される TikTok アカウント。**無いと広告が作れない**',
+        '   - media は 管理番号 → {video(動画ID), cover(カバー画像ID)}。SINGLE_VIDEO はカバー画像が必須',
+        '   - campaigns/adGroups は campaignId/adGroupId をキーに（adGroups.paramCode はURLパラメータ）'];
+      const lines=[];
+      if(mode==='ai'){
+        lines.push('TikTok入稿プランナー用に、新規アカウントの参照データJSONを生成してください。','',
+          '1. まず対象アカウントを対話で決めてください:',
+          '   - webgram list --platform bytedance --resource accounts で候補一覧を取得し、どのアカウントを追加するか私に確認して アカウント名・accountId を確定する',
+          '2. 確定したアカウントの identity と素材を取得:',
+          '   webgram list --platform bytedance --resource identities --account-id '+idArg,
+          '   webgram list --platform bytedance --resource resources  --account-id '+idArg,
+          '3. 取得結果を下記スキーマに整形し、'+dir+'/<アカウント名>.json として書き出す:');
+        shape.forEach(l=>lines.push(l));
+      } else {
+        lines.push('TikTok入稿プランナー用に、アカウント「'+headName+'」'+(mode==='import'&&accId?('（accountId: '+accId+'）'):'')+'の参照データJSONを生成してください。','',
+          '手順:',
+          '1. webgram CLI で identity と素材を取得:',
+          '   webgram list --platform bytedance --resource identities --account-id '+idArg,
+          '   webgram list --platform bytedance --resource resources  --account-id '+idArg,
+          '2. 取得結果を下記スキーマに整形して '+dir+'/'+fileName+'.json として書き出す:');
+        shape.forEach(l=>lines.push(l));
+      }
+      lines.push('', 'スキーマ:');
+      P.account.schemaLines({updatedAt:mode!=='help',
+        nameHint:mode==='help'?'<アカウント名（日本語OK）>':'<アカウント名>'}).forEach(l=>lines.push(l));
+      lines.push('');
+      lines.push(mode==='ai' ? '書き出したら、プランナー右上のアカウントプルダウン →「＋新規追加」→「📄 ファイルから追加」で その JSON を読み込めます。'
+        : mode==='import' ? '書き出したら、プランナーで「📁 フォルダ」を再接続 or アカウントセレクトを開くと自動で一覧に出ます。'
+        : '書き出したら、プランナーで「＋新規追加 →📄 ファイルから追加」or「📁 フォルダ」再接続で一覧に出ます。');
+      return lines.join('\n');
+    },
+    strategy(){
+      return ['TikTok広告の入稿プランを一緒に作りたいです。まず戦略を壁打ちさせてください。','',
+        '# 前提','- アカウント: <アカウント名（日本語OK）>','- 商材 / LP: <商材名・URL>',
+        '- 予算: <広告グループの日予算>',
+        '- 動画: <アセットライブラリにアップロード済みの動画ID / カバー画像ID>',
+        '- 訴求したいポイント: <強み・オファー・ターゲット層>','',
+        '# お願い',
+        '1. 上記をもとにキャンペーン/広告グループ構成・訴求軸（広告文）を提案してください。',
+        '2. 私が「OK」と言ったら、その戦略を ad-ops Skill の「サンプルプラン_bytedance.json」に書き出して（上書きして）ください。',
+        '   - 保存先: .claude/skills/ad-ops/サンプルプラン_bytedance.json',
+        '   - フォーマット: {"schemaVersion":'+SCHEMA_VERSION+', "platform":"bytedance", "accountId":"<advertiser_id>", "campaigns":[ ... ]}',
+        '   - campaigns には キャンペーン → 広告グループ(paramCode / 日予算 / 地域 / 配信面) → 広告(クリエイティブ番号 / 広告文番号) の構成を入れてください。',
+        '   - 目的は TRAFFIC（記事LPへの誘導）固定、広告は単一動画のみです。',
+        '3. 書き出したら、プランナーを開き直す（またはリロードして媒体を TikTok に切り替える）と内容が自動で表示されます。'].join('\n');
+    },
+    submitHelp(ctx){
+      const P=PLATFORMS.bytedance, c=ctx||{}, rel=c.savedRel, dir=P.output.planDir;
+      const lines=['入稿を試みてください。手順:',
+        '1) 入稿計画JSON（'+c.fileName+'）を ad-ops Skill の入稿計画フォルダに置く（保存先: '+rel+'）。',
+        '   ・入稿計画フォルダ（'+dir+'/）に無ければ、ダウンロードフォルダ（~/Downloads/'+c.fileName+'）を探して上記パスへ移動する。',
+        (c.wrote? '   ・プランナーからは既に入稿計画フォルダへ保存済みのはず。' : '   ・フォルダ未接続のためダウンロード済み。~/Downloads から移動してください。'),
+        '2) 置いたパスで dry-run 入稿を実行:',
+        '   '+P.output.submitCommand(rel,{dryRun:true}),
+        '',
+        '※ TikTok は実 API での入稿検証が未了です。配信オン（ENABLE）は backend が拒否します。初回は 1キャンペーン・最小予算で流し、管理画面で目視確認してください。'];
+      return lines.join('\n');
+    },
+    afterSave(ctx){
+      const P=PLATFORMS.bytedance, c=ctx||{};
+      return 'プラン「'+c.name+'」v'+c.versionId+' を保存しました。\n入稿するには「入稿JSON書き出し」を押し、生成された *_TikTok入稿計画_*.json を指定して dry-run してください:\n\n'
+        + P.output.submitCommand('<入稿計画JSONのパス>',{dryRun:true});
+    }
+  },
+  docTabs:[{id:'overview',label:'概要'},{id:'video',label:'動画広告'},
+           {id:'param',label:'パラメータ'},{id:'guide',label:'運用手順'}]
+};
+
 /* DOM の data-st ('ads'|'groups'|'campaigns') と正規タブID ('ads'|'adGroups'|'campaigns') を橋渡し */
 function normTab(tab){ return tab==='groups'?'adGroups':(tab||'ads'); }
 /* 列記述子配列。引数省略時は現在のシートタブ */