addashboard-cli 0.9.3 → 0.9.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "addashboard-cli",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "description": "webgram CLI — ad-dashboard (https://macchiato.site) を Claude Code / Codex CLI から操作するための CLI",
   "bin": {
     "webgram": "./dist/index.js"

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

@@ -652,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>
@@ -853,7 +854,7 @@ finalUrl = baseURL + paramCode + "?ad=" + paramCode + "&creative=" + …
    （cli/test/unit/plannerVersion.test.ts が package.json との一致を検証するので、
    手で書き換えて放置するとテストが落ちる）。
    利用者が「どの版のプランナーを開いているか」を言えないと、不具合報告が噛み合わない。 */
-const APP_VERSION = '0.9.3'; /* version:sync */
+const APP_VERSION = '0.9.4'; /* version:sync */
 /* 案A: embed廃止。参照データ(refs)・初期プラン・共通設定は外部JSONから起動時に読み込む。
    同梱デフォルト: アカウント/<媒体>/index.json の先頭アカウント (refs+principal+projectName+baseArticleUrl) と サンプルプラン.json (project+campaigns)。
    固有名詞はハードコードせず、すべて外部JSON由来にする。 */
@@ -2820,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 に継承先を出す */
@@ -2974,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)
@@ -3088,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:''}
   },
@@ -3294,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解決が必要なため常に空 */