addashboard-cli 0.9.2 → 0.9.4

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

@@ -35,6 +35,7 @@
   header.bar .brand{display:flex; align-items:baseline; gap:10px; margin-right:6px;}
   header.bar .brand .logo{font-size:15px; font-weight:800; letter-spacing:.02em;}
   header.bar .brand .pjname{font-size:12.5px; color:var(--muted);}
+  header.bar .brand .appver{font-size:11px; color:var(--muted); font-variant-numeric:tabular-nums; opacity:.8;}
   header.bar .acchdr{display:inline-flex; align-items:center; gap:6px; font-size:12px; color:var(--muted); margin-right:6px;} /* F-3: ヘッダーのアカウント切替 */
   header.bar .acchdr select{font-family:inherit; font-size:12.5px; border:1px solid var(--line); border-radius:7px; padding:4px 6px; background:#fff;}
   .seg{display:inline-flex; background:var(--soft); border:1px solid var(--line); border-radius:8px; padding:2px;}
@@ -328,8 +329,12 @@
   .mrow{display:grid; grid-template-columns:1fr 1fr; gap:12px;}
   .modal .mfoot{display:flex; justify-content:flex-end; gap:8px; padding:14px 20px 18px; border-top:1px solid var(--line2); margin-top:8px; position:sticky; bottom:0; background:#fff;}
   .hint{font-size:11.5px; color:var(--faint); margin-top:4px;}
-  .toast{position:fixed; bottom:22px; left:50%; transform:translateX(-50%); background:#111418; color:#fff; font-size:12.5px; padding:9px 16px; border-radius:9px; z-index:100; box-shadow:0 8px 24px rgba(0,0,0,.25); opacity:0; transition:opacity .2s, transform .2s;}
+  .toast{position:fixed; bottom:22px; left:50%; transform:translateX(-50%); background:#111418; color:#fff; font-size:12.5px; padding:9px 16px; border-radius:9px; z-index:100; box-shadow:0 8px 24px rgba(0,0,0,.25); opacity:0; transition:opacity .2s, transform .2s; max-width:min(720px,92vw); text-align:left; line-height:1.6;}
   .toast.show{opacity:1; transform:translateX(-50%) translateY(-2px);}
+  /* 書き出しをブロックしたときは自動で消さない。原因を読み返せないと直しようがない */
+  .toast.sticky{padding-right:34px; background:#3a1518; border:1px solid #a33; white-space:pre-wrap;}
+  .toast .tclose{position:absolute; top:4px; right:8px; cursor:pointer; font-size:15px; line-height:1; color:#fff9; padding:2px 4px;}
+  .toast .tclose:hover{color:#fff;}
   .empty{padding:40px; text-align:center; color:var(--faint); font-size:13px;}
   /* ── plan warning banner (accountId 不一致など) ── */
   .planwarn{display:flex; align-items:center; gap:10px; background:var(--amber-soft); color:#7a4d00; border-bottom:1px solid var(--amber); font-size:12.5px; padding:9px 16px;}
@@ -357,7 +362,7 @@
 </head>
 <body>
 <header class="bar">
-  <div class="brand"><span class="logo" id="brandLogo">YDA入稿プランナー</span><span class="pjname" id="pjLabel">—</span></div>
+  <div class="brand"><span class="logo" id="brandLogo">YDA入稿プランナー</span><span class="appver" id="appVer" title="このプランナーのバージョン（addashboard-cli と共通）"></span><span class="pjname" id="pjLabel">—</span></div>
   <!-- S11: 「案件 × 媒体」を1つで選ぶ統合プルダウン。option value = "<platform>::<アカウント名>"。
        旧 #pfSeg（媒体セレクタ）/ #mediaTabs（媒体要件タブ）は廃止し、媒体切替もここに一本化した (2026-08-05) -->
   <span class="acchdr" title="案件×媒体を切り替える（＋新規追加/編集もここから）"><select class="chipin" id="accSelect" style="min-width:18ch"></select></span>
@@ -647,6 +652,7 @@ finalUrl = baseURL + paramCode + "?ad=" + paramCode + "&creative=" + …
           <tr><td>曜日・時間帯</td><td>配信スケジュール</td></tr>
           <tr><td>デバイス</td><td>配信デバイス</td></tr>
           <tr><td>性別</td><td>—</td></tr>
+          <tr><td>Advantage+ オーディエンス</td><td>広告セット行の「Advantage+」列。<b>空欄・オンなら Meta が指定した年齢・性別を「出発点」として対象を広げる</b>／オフなら指定どおりに限定して配信する。<b>性別を指定する広告セットでは Meta 側でこの指定が必須</b>（無いと広告セット作成が <code>subcode 1870227</code> で落ちる。2026-09-03 に v26.0 の実 API で確認）。従来はこの列が無く、性別を指定した広告セットが全滅していた</td></tr>
           <tr><td>年齢</td><td>—</td></tr>
           <tr><td>オーディエンスリスト</td><td>どのデータ（カスタム/類似オーディエンス）に配布するか。<code>fetchAudiences</code> で取得可</td></tr>
           <tr><td>プレイスメント</td><td>配信面の指定</td></tr>
@@ -842,6 +848,13 @@ finalUrl = baseURL + paramCode + "?ad=" + paramCode + "&creative=" + …
 /* ============================================================
    YDA入稿プランナー — 単一state / シート・ツリー両ビュー投影
    ============================================================ */
+/* ---- バージョン ----
+   プランナーと CLI (addashboard-cli) は同じ npm パッケージで配られるので**同じ版数**を名乗る。
+   正は cli/package.json の version で、この行は `npm run version:sync` が書き換える
+   （cli/test/unit/plannerVersion.test.ts が package.json との一致を検証するので、
+   手で書き換えて放置するとテストが落ちる）。
+   利用者が「どの版のプランナーを開いているか」を言えないと、不具合報告が噛み合わない。 */
+const APP_VERSION = '0.9.4'; /* version:sync */
 /* 案A: embed廃止。参照データ(refs)・初期プラン・共通設定は外部JSONから起動時に読み込む。
    同梱デフォルト: アカウント/<媒体>/index.json の先頭アカウント (refs+principal+projectName+baseArticleUrl) と サンプルプラン.json (project+campaigns)。
    固有名詞はハードコードせず、すべて外部JSON由来にする。 */
@@ -916,7 +929,34 @@ const firstNonEmpty = (...vs) => { for(const v of vs){ const s=String(v==null?''
    **URL構造を壊す文字だけ**をパーセントエンコードし、日本語はそのまま残す
    (計測ツール上での可読性を優先。1パスなので %→%25 の二重エンコードは起きない)。 */
 const urlq = s => String(s==null?'':s).replace(/[%&#?=+\s]/g, c=>encodeURIComponent(c));
-function toast(m){ const t=document.getElementById('toast'); t.textContent=m; t.classList.add('show'); clearTimeout(t._h); t._h=setTimeout(()=>t.classList.remove('show'),2200); }
+/**
+ * 画面下の通知。既定は 2.2 秒で消える。
+ *
+ * `{sticky:true}` は**自動で消さない**。書き出しをブロックしたときに使う
+ * （原因を読み返せないと直しようがない）。閉じるボタンと Esc で消す。
+ */
+function toast(m, opts){
+  const t=document.getElementById('toast');
+  const sticky=!!(opts&&opts.sticky);
+  clearTimeout(t._h);
+  t.textContent=m;
+  t.classList.toggle('sticky', sticky);
+  t.classList.add('show');
+  if(sticky){
+    const x=document.createElement('span');
+    x.className='tclose'; x.textContent='×'; x.title='閉じる (Esc)';
+    x.onclick=()=>t.classList.remove('show');
+    t.appendChild(x);
+    return;
+  }
+  t._h=setTimeout(()=>t.classList.remove('show'),2200);
+}
+
+/** 自動で消えないトーストを閉じる（Esc / 閉じるボタン）。 */
+function dismissStickyToast(){
+  const t=document.getElementById('toast');
+  if(t && t.classList.contains('sticky')) t.classList.remove('show');
+}
 
 /* ---- エラー / 警告の安定コード (媒体非依存の語彙) ----
    S2: UI判定 (セル赤枠 / ghost / ツリーのドット) は日本語文字列ではなくこのコードで行う。
@@ -939,6 +979,10 @@ const EC = {
   LONG_HEADLINE_MISSING:'LONG_HEADLINE_MISSING' /* 動画広告は長見出しが必須 */,
   BUSINESS_NAME_MISSING:'BUSINESS_NAME_MISSING' /* proto 上 REQUIRED */,
   LOGO_MISSING:'LOGO_MISSING'                   /* 画像広告はロゴ 1-5 件が必須 */,
+  LOGO_FOREIGN_ACCOUNT:'LOGO_FOREIGN_ACCOUNT'   /* ロゴが別 Customer の asset = 入稿時に必ず落ちる */,
+  LOGO_SOURCE_CONFLICT:'LOGO_SOURCE_CONFLICT'   /* 登録済みIDとローカルパスの同時指定 = 二重にアセットを作る */,
+  CAMPAIGN_NAME_DUPLICATE:'CAMPAIGN_NAME_DUPLICATE'  /* 既存CPと同名。Google は同名を拒否する */,
+  CAMPAIGN_NAME_DUPLICATE_IN_PLAN:'CAMPAIGN_NAME_DUPLICATE_IN_PLAN' /* 同じ計画の中で新規CP名が重複 */,
   LOCATION_EMPTY:'LOCATION_EMPTY'               /* 地域未指定。google は全世界配信 (warn) / bytedance は入稿不可 (err) */,
   /* ByteDance (TikTok) 固有 */
   IDENTITY_MISSING:'IDENTITY_MISSING'  /* 広告主として表示する TikTok アカウント未設定 = 広告が作れない */,
@@ -1018,6 +1062,7 @@ function renderChrome(){
   const P=pf(); if(!P) return;
   try{ document.title = P.brandTitle+' / 媒体要件 — WEBGRAM'; }catch(e){}
   const bl=document.getElementById('brandLogo'); if(bl) bl.textContent=P.brandTitle;
+  const av=document.getElementById('appVer'); if(av) av.textContent='v'+APP_VERSION;
   const stLabel={ads:P.levels.ad.label, groups:P.levels.adGroup.label, campaigns:P.levels.campaign.label};
   document.querySelectorAll('#sheetTabs button[data-st]').forEach(b=>{
     const l=stLabel[b.dataset.st]; if(l) b.textContent=l;
@@ -1512,6 +1557,12 @@ PLATFORMS.yda = {
       const P=PLATFORMS.yda, p=ctx.project;
       const bidLabel=String(c.biddingStrategy||'').trim(); // A-1: キャンペーン個別値のみ (project既定へフォールバックしない)
       const biddingStrategy=P.enums.bidding[bidLabel]||bidLabel||P.enums.biddingFallback;
+      /* S15: 既存キャンペーン呼び出しは「広告追加専用」で、予算・入札はプランナー上で編集できない
+         (isExisting=true → 予算セルが未入力のまま)。それを Number(null)||0 で 0 として書き出すと
+         backend の zod (budget は正の整数) に引っかかり dry-run が budget must be > 0 で落ちる。
+         backend は既存CPでは budget/goal/入札を Yahoo 側へ送らない (ignoredFields) ので、
+         **持っていない値はキー自体を出さない**のが正しい。 */
+      const existing=isExistingCampaign(c);
       const cp={
         name:c.name,
         goal:p.goal||'CONVERSION',
@@ -1519,10 +1570,10 @@ PLATFORMS.yda = {
         /* S12/I-YDA-TIME: Yahoo Ads API は startDate(yyyyMMdd 相当) と startTime(HHmm) の2フィールド。
            日付と時刻を分けて送る (公式: startTime を指定するときは startDate が必須)。 */
         startDate:dateOnly(p.startDate)||defaultStart(),   /* 既定は翌日 */
-        budget:Number(c.budget)||0,   // A-1: キャンペーン個別値のみ
         biddingStrategy,
         adGroups:[]
       };
+      if(!existing) cp.budget=Number(c.budget)||0;   // A-1: キャンペーン個別値のみ
       /* 開始時刻 (HHmm)。案件設定が時刻を持たないときは既定 05:00 を使う。
          空欄になるのは「日付だけを明示的に入れた」ケースなので、そのときは startTime を送らない。 */
       const stTime = p.startDate ? timeHHmm(p.startDate) : timeHHmm(defaultStartDateTime());
@@ -1538,8 +1589,12 @@ PLATFORMS.yda = {
         cp.frequencyTimeUnit=fe.unit;
         cp.vImps=fe.count;
       }
-      if(bidLabel==='tCPA'){ cp.targetCpa=Number(c.tcpa)||0; }
-      else if(biddingStrategy==='CPC'){ cp.cpc=Number(c.adGroups[0]&&c.adGroups[0].bid)||0; }
+      /* 既存CPは入札もプランナー上で持たない (biddingStrategy は '')。0 を書き出しても
+         backend は無視するが、「反映される値」に見えるので出さない。 */
+      if(!existing){
+        if(bidLabel==='tCPA'){ cp.targetCpa=Number(c.tcpa)||0; }
+        else if(biddingStrategy==='CPC'){ cp.cpc=Number(c.adGroups[0]&&c.adGroups[0].bid)||0; }
+      }
       const cid=resolveCampaignIdOf(c); if(cid) cp.campaignId=cid; // Phase C: 既存はIDを出力(backendで作成スキップ)。新規はID無し=作成対象
       return cp;
     },
@@ -1973,7 +2028,23 @@ function renderTplChips(){
   };
   const num=(f,v,w,d)=>'<input class="chipin" type="number" data-proj="'+f+'" value="'+esc(v)+'" style="width:'+(w||'6ch')+'"'+hint(d)+'>';
   const sel=(f,v,opts)=>'<select class="chipin" data-proj="'+f+'">'+opts.map(o=>'<option'+(o===v?' selected':'')+'>'+esc(o)+'</option>').join('')+'</select>';
-  const selv=(f,v,opts)=>'<select class="chipin" data-proj="'+f+'">'+opts.map(o=>'<option value="'+esc(o.v)+'"'+(o.v===v?' selected':'')+'>'+esc(o.t)+'</option>').join('')+'</select>';
+  const selv=(f,v,opts,d)=>'<select class="chipin" data-proj="'+f+'"'+hint(d)+'>'+opts.map(o=>'<option value="'+esc(o.v)+'"'+(o.v===v?' selected':'')+'>'+esc(o.t)+'</option>').join('')+'</select>';
+  /* S15: kind:'refselect' = 参照表 (st.refs[refKey]) から選ぶチップ。
+     **参照表が空のあいだは従来のテキスト入力にフォールバックする**。refs-import 前や
+     参照表を持たないアカウントで「選べる候補がゼロのプルダウン」になると、値を入れる手段が
+     消えて後退するため。現在値が参照表に無いときは末尾に option として残す
+     （手打ちした値・旧プランの値を再描画で消さない）。 */
+  const refsel=(f,v,d)=>{
+    const table=(st.refs && st.refs[f.refKey]) || {};
+    const keys=Object.keys(table);
+    if(!keys.length) return txt(f.key, v, f.width, d);
+    const opts=[{v:'', t:'（未選択）'}];
+    keys.forEach(k=>opts.push({v:k, t:(f.optionLabel? f.optionLabel(k, table[k]) : k)}));
+    const cur=String(v||'');
+    if(cur && !Object.prototype.hasOwnProperty.call(table, cur))
+      opts.push({v:cur, t:cur+'（一覧に無い値）'});
+    return selv(f.key, cur, opts, d);
+  };
   /* C1: kind:'toggle' = チェックボックス。値は真偽で持ち、**未定義は fallback**（欠落=従来挙動）。
      `p[key]||fallback` では false が fallback(true) に化けるので、toggle だけは別扱いにする。 */
   const tgl=(f,v,d)=>'<input class="chipin" type="checkbox" data-proj="'+f+'"'+(v?' checked':'')+hint(d)+'>';
@@ -2013,6 +2084,7 @@ function renderTplChips(){
     const ctrl = f.kind==='freq' ? freq(f)
       : f.kind==='toggle' ? tgl(f.key, v, f)
       : f.kind==='datetime' ? dt(f.key, v, f)
+      : f.kind==='refselect' ? refsel(f, v, f)
       : f.kind==='selectv' ? selv(f.key, v, f.options)
       : f.kind==='select' ? sel(f.key, v, f.options)
       : f.kind==='number' ? num(f.key, v, f.width, f)
@@ -2749,6 +2821,16 @@ const META_COLS = {
      },
      title:'空欄にすると上限なし（age_max を送りません）。特別広告カテゴリ選択時は 65 固定となり上限なしは無視されます'},
     {field:'tg_gender', label:'性別', kind:'tgpick', tgKey:'tg_gender', readonlyOnExisting:true, roEmptyDash:true},
+    /* S16: Advantage+ オーディエンス (targeting.targeting_automation.advantage_audience)。
+       **性別を指定するときは Meta が必須にする**（無いと広告セット作成が 1870227 で落ちる。
+       2026-09-03 に v26.0 の実 API で確認）。空欄 = オン(1) で、これは従来 Meta が暗黙に
+       付けていた値と同じ。オフ(0) にすると指定した年齢・性別どおりに限定して配信される。 */
+    {field:'advantageAudience', label:'Advantage+', kind:'select', options:['','オン','オフ'], minWidth:'78px',
+     readonlyOnExisting:true, roEmptyDash:true,
+     coerce:v=>{const t=String(v==null?'':v).trim(); return (t==='オン'||t==='オフ')?t:'';},
+     title:'Advantage+ オーディエンス。空欄・オンなら Meta が指定した年齢・性別・オーディエンスを'
+          +'「出発点」として対象を広げます。オフにすると指定どおりに限定して配信します。'
+          +'（性別を指定する広告セットでは Meta 側でこの指定が必須です）'},
     {field:'tg_device', label:'デバイス', kind:'tgpick', tgKey:'tg_device', readonlyOnExisting:true, roEmptyDash:true},
     {field:'tg_placement', label:'配置', kind:'tgpick', tgKey:'tg_placement', readonlyOnExisting:true, roEmptyDash:true},
     /* 配信日時: 空欄 = 案件設定チップの値を継承（buildPlan 側で解決）。placeholder に継承先を出す */
@@ -2903,6 +2985,8 @@ PLATFORMS.meta = {
   mappers:{
     devices(s, P){ return mapByEnum(s, P.enums.device, P.targeting.tg_device.allLabel); },
     genders(s, P){ return mapByEnum(s, P.enums.gender, P.targeting.tg_gender.allLabel); },
+    /* S16: 空欄・未知の値・旧プラン(キー無し)はオン(1)。'オフ' のときだけ 0 */
+    advantageAudience(v){ return String(v==null?'':v).trim()==='オフ' ? 0 : 1; },
     placements(s, P){
       const l=tgList(s);
       if(!l.length || l.indexOf(P.targeting.tg_placement.allLabel)>=0)
@@ -3017,7 +3101,7 @@ PLATFORMS.meta = {
     ad:{format:'IMAGE', imageNo:'', titleNo:'', descNo:'', adName:'', paramCode:''},
     adGroup:{name:'', paramCode:'', isExisting:false, dailyBudget:1000, bidAmount:null,
              ageMin:18, ageMax:65, tg_gender:'すべて', tg_device:'すべてのデバイス',
-             tg_placement:'自動配置', startDate:'', endDate:'', deliveryStatus:''},
+             tg_placement:'自動配置', advantageAudience:'', startDate:'', endDate:'', deliveryStatus:''},
     campaign:{name:'新規キャンペーン', campaignId:'', isExisting:false,
               objective:'OUTCOME_SALES', specialAdCategory:'NONE', urlNumber:''}
   },
@@ -3223,6 +3307,10 @@ PLATFORMS.meta = {
               : (String(g.ageMax==null?'':g.ageMax).trim()!=='' && Number(g.ageMax)>0
                    ? {ageMax:Number(g.ageMax)} : {})),
         genders: constrained?[]:P.mappers.genders(g.tg_gender, P),
+        /* S16: Advantage+ オーディエンスは**常に送る**。性別を指定した広告セットだけ
+           1870227 で落ちる、という条件付きの不具合を再発させないため。
+           旧プラン（キー無し）・空欄はオン(1) = 従来 Meta が暗黙に付けていた値。 */
+        advantageAudience: P.mappers.advantageAudience(g.advantageAudience),
         devicePlatforms:P.mappers.devices(g.tg_device, P),
         placements:P.mappers.placements(g.tg_placement, P),
         customAudiences:[], excludedAudiences:[],    /* ID解決が必要なため常に空 */
@@ -3436,6 +3524,19 @@ const GOOGLE_REF_TABLES = {
     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||'')}
+    ] },
+  /* ロゴは番号を振らず resource_name をキーにする。asset の resource_name は
+     Google 側で一意なので、番号を振ると同じロゴに2つの番号が生まれて参照がぶれる。
+     取り込みは `adops.sh refs-import google <accountId> --write`。 */
+  logos:{ key:'logos', label:'ロゴ', countLabel:'ロゴ', editable:false, required:false,
+    keyKind:'string', keyLabel:'アセット', keyWidth:'260px',
+    emptyMsg:'ロゴがありません（refs-import google で取り込むか、ロゴアセットを手で入力してください）',
+    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||'')},
+      {label:'サイズ', width:'100px', cls:'mono',
+       cell:(no,v)=>esc(v&&v.width? String(v.width)+'x'+String(v.height) : '')}
     ] }
 };
 
@@ -3527,7 +3628,13 @@ PLATFORMS.google = {
       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);
+      /* ロゴはアカウント固有。切替時に前のアカウントの値を持ち越すと、
+         **別 Customer に削除できないアセットを作る**。
+         logoAsset は別Customer検証で止まるが、ローカルパスには効かない
+         (パスは resource_name ではないので所有者を判定できない)。
+         どちらもアカウントJSONの値で置き換え、無ければ空に戻す。 */
+      project.logoAsset = obj.logoAsset!=null ? String(obj.logoAsset) : '';
+      project.logoImagePath = '';
       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;
@@ -3574,8 +3681,25 @@ PLATFORMS.google = {
   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以上）'},
+    /* 参照表 refs.logos があれば選択、無ければ従来どおり手打ち（refselect のフォールバック）。
+       resource_name は長く手写しで取り違えやすいので、取り込み済みなら選ばせる。 */
+    {key:'logoAsset', label:'ロゴアセット', kind:'refselect', width:'18ch', fallback:'',
+     refKey:'logos',
+     optionLabel:(rn, row)=>{
+       const size=(row&&row.width)? row.width+'x'+row.height : '';
+       const name=(row&&row.name)||rn.split('/').pop();
+       return name+(size? ' ('+size+')' : '');
+     },
+     title:'ロゴ画像アセットの resource_name。画像広告では必須（1:1・128x128以上）。'
+          +'候補は refs-import google で取り込む'},
+    /* ロゴが未登録のアカウント向け。本実行の直前に CLI がアップロードして
+       resource_name に解決する（dry-run では上げない）。上の「ロゴアセット」と
+       同時に入れると二重にアセットを作るので、書き出しで止める。 */
+    {key:'logoImagePath', label:'ロゴ画像パス', kind:'text', width:'16ch', fallback:'',
+     placeholder:'素材/ロゴ.png',
+     title:'ロゴが未登録のときに使う。ローカル画像のパス（入稿計画JSONからの相対 or 絶対）。'
+          +'入稿時に自動でアップロードされます。1:1・128x128以上・GIF/JPEG/PNG。'
+          +'カンマか改行で複数指定可（最大5件）。「ロゴアセット」と同時には使えません'},
     {key:'cta', label:'CTA', kind:'select',
      options:['詳しくはこちら','購入する','登録する','ダウンロード','お問い合わせ','今すぐ申し込む',
               '予約する','見積もりを取得','購読する','インストール','サイトへアクセス','もっと見る','ボタンなし'],
@@ -3614,6 +3738,10 @@ PLATFORMS.google = {
 
   mappers:{
     status(s, P){ return s==='オン'?P.enums.statusOn:P.enums.statusOff; },
+    /* 1つのテキスト欄で複数のロゴを受ける。カンマ・改行のどちらでも区切れる */
+    logoImagePaths(v){
+      return String(v||'').split(/[,\n]/).map(x=>x.trim()).filter(Boolean);
+    },
     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 既定に任せる)。
@@ -3633,7 +3761,7 @@ PLATFORMS.google = {
     newCampaignBudget:12000,
     targetCpa:8500,
     project:{
-      businessName:'', logoAsset:'', cta:'詳しくはこちら',
+      businessName:'', logoAsset:'', logoImagePath:'', cta:'詳しくはこちら',
       deliveryStatus:'オフ'
     },
     ad:{format:'VIDEO', imageNo:'', titleNo:'', longNo:'', descNo:'', adName:''},
@@ -3731,7 +3859,12 @@ PLATFORMS.google = {
     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);
+    /* 登録済みID・ローカルパスのどちらか。未登録アカウントはパスだけで入稿できる
+       （両方あるのは validateProject が書き出し前に止める） */
+    if(fmt.id==='IMAGE'
+       && String(p.logoAsset||'').trim()===''
+       && !P.mappers.logoImagePaths(p.logoImagePath).length)
+      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);
@@ -3763,8 +3896,34 @@ PLATFORMS.google = {
       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以上）'});
+    const logo=String((p&&p.logoAsset)||'').trim();
+    const logoPaths=PLATFORMS.google.mappers.logoImagePaths(p&&p.logoImagePath);
+    if(hasImageAd && !logo && !logoPaths.length)
+      errs.push({code:EC.LOGO_MISSING,
+        msg:'画像広告があるためロゴが必須です。登録済みなら「ロゴアセット」、未登録なら「ロゴ画像パス」を入れてください（1:1・128x128以上）'});
+    /* 両方あると CLI が余計にアップロードし、削除できないアセットが増える */
+    if(logo && logoPaths.length)
+      errs.push({code:EC.LOGO_SOURCE_CONFLICT,
+        msg:'「ロゴアセット」と「ロゴ画像パス」は同時に指定できません（どちらか一方にしてください）'});
+    if(logoPaths.length>5)
+      errs.push({code:EC.LOGO_SOURCE_CONFLICT,
+        msg:'ロゴ画像パスは 5 件までです（received '+logoPaths.length+'）'});
+    /* asset は Customer をまたいで参照できない。別アカウントの resource_name を貼ると
+       入稿時に必ず落ちるので、書き出しの手前で止める。アカウントJSONを取り違えたまま
+       ロゴだけ前のアカウントの値が残る、が実際に起こりうる経路。
+       **ローカルパスはこの検査に掛けない**（./logo.png を「別アカウント」と誤判定する）。 */
+    if(logo){
+      /* 終端まで締める。前方一致だと customers/<id>/assets/ や .../assets/abc が
+         通り、形式は合っているのに入稿で落ちる値を書き出してしまう。 */
+      const m=/^customers\/(\d+)\/assets\/(\d+)$/.exec(logo);
+      const acc=String((p&&p.accountId)||'').trim();
+      if(!m)
+        errs.push({code:EC.LOGO_FOREIGN_ACCOUNT,
+          msg:'ロゴアセットの形式が違います（customers/<アカウントID>/assets/<ID>）: '+logo});
+      else if(acc && m[1]!==acc)
+        errs.push({code:EC.LOGO_FOREIGN_ACCOUNT,
+          msg:'ロゴアセットが別アカウント（'+m[1]+'）のものです。現在のアカウントは '+acc+' です'});
+    }
     /* 予算はキャンペーン階層。コアの書き出しは広告グループ行しか検証しないため、
        ここで見ないと budgetAmountYen:0 のまま書き出され dry-run まで気づけない。 */
     ((state&&state.campaigns)||[]).forEach(c=>{
@@ -3772,6 +3931,87 @@ PLATFORMS.google = {
       if(!(Number(c.dailyBudget)>0))
         errs.push({code:EC.BUDGET_MISSING, msg:'キャンペーン「'+String(c.name||'')+'」の日予算を入力してください'});
     });
+    errs.push(...PLATFORMS.google.checkCampaignNames(state));
+    return errs;
+  },
+
+  /**
+   * キャンペーン名の重複を見る。**Google は同名キャンペーンを拒否する**
+   * （実測: Trying to modify the name of an active or paused campaign,
+   * where the name is already assigned to another active or paused campaign.）。
+   * dry-run は実 API を叩かないので通ってしまい、本実行で初めて落ちる。
+   *
+   * 見るのは 2 種類:
+   *   1. アカウントの既存CP（`refs.campaigns`）との衝突。**スナップショットなので
+   *      古いと取りこぼす** — 実データとの突き合わせは CLI / backend が本実行の直前に行う
+   *   2. 同じ計画の中での衝突。こちらは鮮度と無関係にローカルで確定する
+   *
+   * **既存CP行も対象にする。** Google は既存CPへの広告追加が未対応で、`buildPlan.campaign`
+   * は `campaignId` を出さない（backend の zod が落とすため）。つまり「既存CPに足す」
+   * つもりの行も**同名の新規CPとして書き出される**ので、除外すると
+   * 「プランナーは通るのに CLI / backend で落ちる」経路が残る。
+   */
+  checkCampaignNames(state){
+    const errs=[];
+    const known=new Map(); // 正規化名 → 元の表記
+    Object.values((state&&state.refs&&state.refs.campaigns)||{}).forEach(v=>{
+      /* stale = 媒体側から消えたCP。削除済みの名前は再利用できるので、
+         残したままだと使える名前を「重複」と誤判定する */
+      if(v && v.stale) return;
+      const n=String((v&&v.name)||'').trim();
+      if(n) known.set(n.toLowerCase(), n);
+    });
+
+    /* **手つかずの行は判定しない。** コアは広告が1件も解決しないキャンペーンを
+       書き出しから落とす（stats.emptyCampaigns）。既定のCP名は固定文字列なので、
+       「＋ 新規キャンペーン」を2回押しただけで送られもしない行どうしが重複扱いになり、
+       **完成している他のキャンペーンごと書き出しがブロックされていた**。
+       ただし「中身はあるが別の理由で解決していない」行は対象に残す
+       （ブランド名未入力などで一時的に全滅しているだけ、を取りこぼさないため）。 */
+    const DA=PLATFORMS.google.defaults.ad;
+    const pristineAd=a=>Object.keys(DA).every(k=>{
+      const d=DA[k];
+      if(d && typeof d==='object') return true;   // 入れ子は見ない
+      return String((a&&a[k])==null?'':a[k])===String(d==null?'':d);
+    });
+    const hasContent=c=>(((c&&c.adGroups)||[]).some(g=>(((g&&g.ads)||[]).some(a=>!pristineAd(a)))));
+    const newCps=((state&&state.campaigns)||[]).filter(hasContent);
+    const planNames=new Set(newCps.map(c=>String(c.name||'').trim().toLowerCase()).filter(Boolean));
+    /* 提案が既存とも計画内とも衝突しないことを保証する。片方だけ見ると
+       「提案どおりに直したらプラン内で重複した」が起きる。
+       **出した候補も taken に足す** — 足さないと同名2行に同じ候補を出してしまい、
+       両方とも提案どおりに直すと重複が再発する。 */
+    const taken=new Set([...known.keys(), ...planNames]);
+    const suggest=(base)=>{
+      const stem=base.replace(/_(\d+)$/,'');   // 既に _2 なら _3 以降から
+      const out=[];
+      for(let i=2; out.length<3 && i<100; i++){
+        const cand=stem+'_'+i;
+        if(!taken.has(cand.toLowerCase())){ out.push(cand); taken.add(cand.toLowerCase()); }
+      }
+      return out;
+    };
+
+    const seen=new Map();
+    newCps.forEach(c=>{
+      const raw=String(c.name||'').trim();
+      if(!raw) return;
+      const key=raw.toLowerCase();
+      if(known.has(key)){
+        const alt=suggest(raw);
+        errs.push({code:EC.CAMPAIGN_NAME_DUPLICATE,
+          msg:'キャンペーン名「'+raw+'」はアカウントの既存キャンペーンと同じです。'
+             +'Google は既存キャンペーンへの広告追加に未対応で、この行も新規作成として送られます'
+             +'（同名は拒否されるため入稿時に落ちます）。'
+             +(alt.length?('代替候補: '+alt.join(' / ')):'別の名前を付けてください')});
+      }
+      if(seen.has(key)){
+        errs.push({code:EC.CAMPAIGN_NAME_DUPLICATE_IN_PLAN,
+          msg:'キャンペーン名「'+raw+'」がこの計画の中で重複しています（2件以上）。'
+             +'まとめて入稿すると2件目以降が落ちます'});
+      }
+      seen.set(key, true);
+    });
     return errs;
   },
 
@@ -3816,15 +4056,21 @@ PLATFORMS.google = {
         finalUrls:[r.finalUrl]
       };
       const logo=String(p.logoAsset||'').trim();
+      const logoPaths=P.mappers.logoImagePaths(p.logoImagePath);
       if(isVideo){
         out.youtubeVideoId=String(r.mediaId);
         out.longHeadlines=r.longText?[String(r.longText)]:[];
         if(logo) out.logoImages=[logo];
+        /* 動画広告のロゴは v23 では任意。ローカルパスからの作成は画像広告に絞る
+           （動画のためだけに消せないアセットを増やさない） */
       } else {
         /* 画像は横長・正方形のうち登録があるものだけ送る (proto: どちらか必須) */
         if(r.imageAsset) out.marketingImages=[String(r.imageAsset)];
         if(r.squareAsset) out.squareMarketingImages=[String(r.squareAsset)];
-        out.logoImages=logo?[logo]:[];
+        /* 登録済みIDが優先。両方あるのは validateProject が書き出し前に止める */
+        if(logo) out.logoImages=[logo];
+        else if(logoPaths.length) out.logoImagePaths=logoPaths;
+        else out.logoImages=[];
         const cta=P.mappers.cta(p.cta, P); if(cta) out.callToActionText=cta;
       }
       return out;
@@ -5819,7 +6065,7 @@ function showPromptModal(opts){
   root.innerHTML='<div class="overlay"><div class="modal"><h3>'+esc(opts.title)+'</h3>'
     +(opts.sub?'<div class="msub">'+esc(opts.sub)+'</div>':'')
     +'<div class="mbody">'+(opts.infoHtml||'')
-    +'<div class="mfield"><label>Claudeに貼るプロンプト</label>'
+    +'<div class="mfield"><label>'+esc(opts.promptLabel||'Claudeに貼るプロンプト')+'</label>'
     +'<textarea id="promptText" readonly style="min-height:120px; font-family:var(--mono); font-size:12px; white-space:pre-wrap">'+esc(opts.prompt)+'</textarea>'
     +(opts.hint?'<div class="hint">'+esc(opts.hint)+'</div>':'')+'</div>'
     +'</div><div class="mfoot"><button class="act" data-mo="cancel">閉じる</button><button class="act primary" id="btnCopyPrompt">📋 プロンプトをコピー</button></div></div></div>';
@@ -5907,15 +6153,20 @@ async function exportSubmitJson(){
   /* S10: 媒体スキーマの accountId 書式ガード (Meta は act_ 付き必須) */
   const idPat=P.account&&P.account.idPattern;
   if(idPat && !idPat.test(String(plan.accountId))){
-    toast('アカウントIDの形式が不正です（'+P.account.idHint+'）'); return;
+    toast('アカウントIDの形式が不正です（'+P.account.idHint+'）', {sticky:true}); return;
   }
   /* S10: 媒体固有のプロジェクト単位ガード (Meta の pageId / pixelId 必須) */
   if(P.validateProject){
     const perrs=P.validateProject(st.project, st)||[];
-    if(perrs.length){ toast(perrs[0].msg); return; }
+    /* 複数まとめて出す。1件ずつ直して押し直す往復を減らす */
+    if(perrs.length){
+      const head=perrs.length>1 ? ('書き出しできません（'+perrs.length+'件）\n') : '';
+      toast(head+perrs.map(e=>'・'+e.msg).join('\n'), {sticky:true});
+      return;
+    }
   }
   const n=stats.exported;
-  if(n===0){ toast('入稿対象の広告が0件です（空入稿を防止しました）'); return; }
+  if(n===0){ toast('入稿対象の広告が0件です（空入稿を防止しました）', {sticky:true}); return; }
   const json=JSON.stringify(plan,null,2);
   // 完成したプランは「新規ファイル」として保存する(上書きしない・毎回タイムスタンプ付き)。
   //   接続済み入稿計画フォルダがあればそこへ、無ければダウンロード。Finderは出さない。
@@ -5941,7 +6192,7 @@ async function exportSubmitJson(){
   //   S7: 文言・コマンドは pf().prompts.submitHelp / pf().output.submitCommand (媒体スキーマ)
   const prompt=pf().prompts.submitHelp({fileName, savedRel, wrote,
     pendingImages:stats.pendingImages, pendingImageNos:stats.pendingImageNos});
-  showPromptModal({title:'入稿計画JSONを保存しました', sub:'このプロンプトをClaude Codeに貼って入稿してください', infoHtml:info, prompt, hint:'submit-plan は1キャンペーンずつ入稿・進捗書き戻しで再開可（submitted済みはスキップ）'});
+  showPromptModal({title:'入稿計画JSONを保存しました', sub:'このままClaude Codeが続き（dry-run）を実行します。自動で進まないときだけ下のプロンプトを貼ってください', infoHtml:info, prompt, promptLabel:'自動で進まないとき用のプロンプト', hint:'submit-plan は1キャンペーンずつ入稿・進捗書き戻しで再開可（submitted済みはスキップ）'});
 }
 
 /* ---- JSON読込 (v1/v2 両対応) ---- */
@@ -6132,6 +6383,9 @@ document.addEventListener('copy',e=>{
 });
 document.addEventListener('paste',e=>{ if(activeView!=='sheet'||planMode!=='sheet') return; if(!selRange()) return; const txt=(e.clipboardData||window.clipboardData).getData('text'); if(txt==null) return; e.preventDefault(); pasteGrid(txt); });
 document.addEventListener('keydown',e=>{
+  /* 自動で消えないトーストはどのビューからでも出る（書き出しボタンは常設ヘッダー）。
+     ビューのガードより手前で閉じないと、title の「閉じる (Esc)」と食い違う */
+  if(e.key==='Escape') dismissStickyToast();
   if(activeView!=='sheet'||planMode!=='sheet') return;
   if(e.key==='Escape'){ closeDrawer(); clearSel(); return; }
   if(e.shiftKey && selB && ['ArrowUp','ArrowDown','ArrowLeft','ArrowRight'].includes(e.key)){

package/skills/ad-ops/scripts/adops.sh

@@ -4,9 +4,12 @@
 #   adops.sh preflight <platform> <accountId>   フェーズ0: ログイン + アカウント疎通確認
 #   adops.sh planner [--platform <媒体> --account <案件名>] [--stop]
 #                                               フェーズ2: プランナーをHTTPで開く (file:// 禁止)
-#   adops.sh plan [<入稿計画.json>]              フェーズ3: DL回収 + 要約 + lint + 合意との差分
+#   adops.sh plan [--wait] [<入稿計画.json>]     フェーズ3: DL回収 + 要約 + lint + 合意との差分
+#                                               --wait は入稿ボタンが押されるまで待ってから処理する
 #   adops.sh open <platform> <accountId> [resource]  管理画面を開く (URLを手で組み立てない)
 #   adops.sh refs-import <platform> <accountId> [--write]  実アカウントから参照表を取り込む
+#   adops.sh refs-import google <accountId> --from-plan <入稿計画.json> [--write]
+#                                                        入稿で作ったロゴを取り込む（実APIを叩かない）
 #
 # 覚えるコマンドを1本に畳むためのラッパー。個別の python3 -c / curl / ls -t を書かない。
 set -uo pipefail
@@ -26,6 +29,32 @@ CLI="${WEBGRAM_CLI:-npx -y addashboard-cli@latest}"
 
 die() { echo "✗ $*" >&2; exit 1; }
 
+# ------------------------------------------------------------- ensure_login
+# 未ログインなら auth login を起動して完了まで待ち、そのまま処理を続ける。
+# 以前は「ターミナルで auth login を実行してください」と案内して止めていたため、
+# ユーザーが自分でコマンドを打ち、改めて指示を出し直す往復が必要だった。
+#
+# ローカルのデスクトップ環境では CLI がブラウザを自動で開く (loopback)。
+# CI / SSH / コンテナでは URL + コード提示 (device flow) に自動で落ちる。
+# パスワードはここでも CLI 側でも扱わない (Google SSO の画面操作は本人が行う)。
+#
+# 成功時は whoami の JSON を stdout に出す。進捗表示は stderr に出して混ぜない。
+ensure_login() {
+  local who
+  echo "▸ ログイン確認..." >&2
+  if who="$($CLI auth whoami 2>/dev/null)"; then
+    printf '%s\n' "$who"
+    return 0
+  fi
+
+  echo "▸ 未ログインのためログインを開始します（ブラウザが開きます）..." >&2
+  $CLI auth login >&2 || die "ログインに失敗しました"
+
+  who="$($CLI auth whoami 2>&1)" \
+    || die "ログイン直後に whoami が失敗しました: $who"
+  printf '%s\n' "$who"
+}
+
 # ---------------------------------------------------------------- preflight
 # フェーズ4の本実行で初めて 401 Account not found に気づく事故を防ぐ。
 # 戦略壁打ちを始める前にこれを通し、落ちたら戦略を練らずに止める。
@@ -34,12 +63,8 @@ cmd_preflight() {
   [ -n "$platform" ] && [ -n "$account" ] \
     || die "usage: adops.sh preflight <platform> <accountId>"
 
-  echo "▸ ログイン確認..."
   local who
-  who="$($CLI auth whoami 2>&1)" || {
-    echo "$who" >&2
-    die "未ログイン、または認証が期限切れです。ターミナルで '$CLI auth login' を実行してください（Google SSO は本人が操作）"
-  }
+  who="$(ensure_login)" || exit 1
   python3 -c 'import json,sys; d=json.load(sys.stdin); print("  ✓", d.get("email"), "/ role:", d.get("role"))' <<<"$who" \
     || die "whoami の応答を解釈できません: $who"
 
@@ -48,11 +73,14 @@ cmd_preflight() {
   accounts="$($CLI list --platform "$platform" --resource accounts 2>&1)" \
     || { echo "$accounts" >&2; die "アカウント一覧の取得に失敗しました"; }
 
-  ACCOUNT_ID="$account" python3 - <<'PY' <<<"$accounts"
+  # JSON は環境変数で渡す。stdin は python 本体が使うので、ここに <<< を足すと
+  # ヒアドキュメントを上書きして「JSON をスクリプトとして実行」になる
+  # （JSON は dict リテラルとして構文が通るので、照合されないまま exit 0 で素通りしていた）。
+  ACCOUNT_ID="$account" ACCOUNTS_JSON="$accounts" python3 - <<'PY'
 import json, os, sys
 want = os.environ["ACCOUNT_ID"]
 try:
-    accounts = json.load(sys.stdin).get("accounts", [])
+    accounts = json.loads(os.environ["ACCOUNTS_JSON"]).get("accounts", [])
 except Exception as e:
     sys.exit(f"✗ アカウント一覧を解釈できません: {e}")
 hit = next((a for a in accounts if str(a.get("id")) == want), None)
@@ -281,11 +309,13 @@ usage:
                                               フェーズ2: プランナーをHTTPで開く
                                               --platform/--account を渡すと「作業中プラン」を
                                               設定してから開く（省略時は前回の設定を引き継ぐ）
-  adops.sh plan [<入稿計画.json>]              フェーズ3: DL回収 + 要約 + lint + 合意との差分
+  adops.sh plan [--wait] [<入稿計画.json>]     フェーズ3: DL回収 + 要約 + lint + 合意との差分
+                                              --wait は入稿ボタンが押されるまで待ってから処理する
   adops.sh open <platform> <accountId> [campaigns|adgroups|ads] [--dry]
                                               管理画面を開く（URLを手で組み立てない）
                                               中間層は YDA=adgroups / Meta=adsets に自動変換
   adops.sh refs-import <platform> <accountId> [--write] [--campaign-id <id>]
+  adops.sh refs-import google <accountId> --from-plan <入稿計画.json> [--write]
                                               実アカウントから参照表を取り込む（既定 dry-run）
 EOF
     exit 2 ;;