addashboard-cli 0.17.1 → 0.18.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -1
- package/dist/commands/report.js +55 -1
- package/dist/commands/report.js.map +1 -1
- package/package.json +1 -1
- package/skills/ad-ops/ad-planner.html +1 -1
package/README.md
CHANGED
|
@@ -39,13 +39,14 @@ webgram pl projects [--month YYYY-MM] [--status <s>] [--platform <p>] # 案件
|
|
|
39
39
|
webgram report yda --account-id <id> [--level <l>] [--from --to] [--format csv] # YDA の日別実績（DB の値）。列の意味・比率の出し方は --help
|
|
40
40
|
webgram report smartnews --account-id <id> [--level <l>] [--from --to] [--format csv] # SmartNews の日別実績（DB の値）。列の意味・数え方は --help
|
|
41
41
|
webgram report google --account-id <id> [--level <l>] [--from --to] [--format csv] # Google の日別実績（DB の値）。列の意味・制約は --help
|
|
42
|
+
webgram report bytedance --account-id <id> [--level <l>] [--from --to] [--format csv] # TikTok の日別実績（DB の値）。列の意味・制約は --help
|
|
42
43
|
```
|
|
43
44
|
|
|
44
45
|
`<p>` = 対応媒体 (`yda` / `meta` / `google` / `smartnews` / `bytedance`)。`submit-plan` は **`yda` / `meta`** 対応（入稿計画JSON の `plan.platform` で自動判別、未記載は `yda` 扱い）。
|
|
45
46
|
`--resource` の媒体制約: `resources` は smartnews 非対応 / `media` は yda のみ（登録画像 mediaId）/ `image-library`・`video-library` は meta のみ（imageHash / videoId。`--account-id` は `act_` 付き）。
|
|
46
47
|
`pl summary` / `pl projects` は JSON をそのまま出力する（要約は呼び出し側の Claude Code が行う）。
|
|
47
48
|
|
|
48
|
-
`report` は DB に貯めた実績を日別の行で返す（期間の合計や比率は返さない）。列の意味・既定の期間・比率の出し方・行数の上限は `webgram report <媒体> --help`（`yda` / `smartnews` / `google`）に書いてあり、ここには書き写さない。
|
|
49
|
+
`report` は DB に貯めた実績を日別の行で返す（期間の合計や比率は返さない）。列の意味・既定の期間・比率の出し方・行数の上限は `webgram report <媒体> --help`（`yda` / `smartnews` / `google` / `bytedance`）に書いてあり、ここには書き写さない。
|
|
49
50
|
|
|
50
51
|
`review` はチーム × 週で全案件の週次レビュー（課題・今週のアクションプラン）を 1 回で取得する (JSON 出力)。`--week` 省略時は先週の月曜 (JST) を自動採用。要約は Claude Code / Codex (LLM) 側で行う。
|
|
51
52
|
|
package/dist/commands/report.js
CHANGED
|
@@ -16,7 +16,7 @@ const apiError_1 = require("../lib/apiError");
|
|
|
16
16
|
*/
|
|
17
17
|
exports.REPORT_LEVELS = ['account', 'campaign', 'adgroup', 'ad'];
|
|
18
18
|
exports.REPORT_FORMATS = ['json', 'csv'];
|
|
19
|
-
exports.REPORT_PLATFORMS = ['yda', 'smartnews', 'google'];
|
|
19
|
+
exports.REPORT_PLATFORMS = ['yda', 'smartnews', 'google', 'bytedance'];
|
|
20
20
|
/** 長い期間はサーバーの集計に時間がかかるので、既定の 15 秒より長く待つ */
|
|
21
21
|
const REPORT_TIMEOUT_MS = 120000;
|
|
22
22
|
async function runReport(input) {
|
|
@@ -226,6 +226,59 @@ const GOOGLE_HELP = `
|
|
|
226
226
|
# 今月のキャンペーン別（日別）
|
|
227
227
|
webgram report google --level campaign --account-id 8265446505 --from 2026-10-01 --to 2026-10-16
|
|
228
228
|
`;
|
|
229
|
+
const BYTEDANCE_HELP = `
|
|
230
|
+
行の単位:
|
|
231
|
+
1行＝1日×--level の単位。実績のない日・単位の行は出ない（0 の行で埋めない）
|
|
232
|
+
account・campaign・adgroup Campaign テーブルの行（広告グループ×日）を合計した値
|
|
233
|
+
ad Creative テーブルの行（広告×日）
|
|
234
|
+
名前の列は、その日の行に入っている値。期間でまとめるときは ID（campaignId・adGroupId・adId）で束ねる
|
|
235
|
+
|
|
236
|
+
出力の列:
|
|
237
|
+
date 日付。広告アカウントのタイムゾーンでの日付（日本のアカウントは JST）
|
|
238
|
+
platform bytedance
|
|
239
|
+
accountId〜adName account・campaign・adGroup・ad の ID と名前。--level の階層とその上の列を出す
|
|
240
|
+
impressions 表示回数
|
|
241
|
+
clicks TikTok API の clicks。管理画面の「クリック数（遷移先）」と「クリック数（すべて）」の
|
|
242
|
+
どちらと同じかは確かめていない。CTR が他の媒体より高く出ることがある
|
|
243
|
+
cost 媒体の費用（円）。代理店の手数料（マージン）は含まない
|
|
244
|
+
conversions CV（媒体）。TikTok ピクセルで計測した CV（MCV ではない）
|
|
245
|
+
mcv 常に null。遷移はアドエビスで計測する値で、TikTok のデータにはない
|
|
246
|
+
crNumber --level ad のときだけ。CR番号（広告名に入れた MVT と数字。例 MVT5558）。
|
|
247
|
+
CR番号ごとの集計はこの列で束ねる。「MVT11修正2」のような版違いも同じ MVT11 になる。
|
|
248
|
+
広告名に MVT 番号が無い広告は null
|
|
249
|
+
CV（全体）・遷移数はアドエビスの値なので返さない
|
|
250
|
+
|
|
251
|
+
既知の制約:
|
|
252
|
+
広告文・リンク先・画像は返さない（TikTok の API が広告文・リンク先を返さず、画像は数時間で切れる URL のため）
|
|
253
|
+
配信ステータスは返さない。webgram list --platform bytedance --resource campaigns の operationStatus
|
|
254
|
+
（ENABLE＝配信中 / DISABLE＝停止）で確認し、campaignId で突き合わせる
|
|
255
|
+
管理画面の値と明らかに違うときや、値に違和感があるときは、ユーザーに開発者への報告を勧める
|
|
256
|
+
|
|
257
|
+
値の鮮度:
|
|
258
|
+
直近8日分は30分ごとに取り直すので、CV などが後から増えることがある。それより前の日は更新しない
|
|
259
|
+
|
|
260
|
+
比率の出し方:
|
|
261
|
+
期間の比率は合計どうしで割る（日ごとの比率を平均しない）。分母が 0 のときは計算しない
|
|
262
|
+
CTR=clicks/impressions CPC=cost/clicks CPA=cost/conversions
|
|
263
|
+
CVR=conversions/impressions（TikTok の管理画面の CVR と同じ） CVR（対クリック）=conversions/clicks
|
|
264
|
+
グロスCPA=CPA×係数（係数は案件で違う。1.2 や 1.25）
|
|
265
|
+
|
|
266
|
+
上限と長い期間:
|
|
267
|
+
10万行を超えるとエラー（途中までの行は返さない）。期間を短くするか、--campaign-id か上の --level で絞る
|
|
268
|
+
行が多いときは --format csv でファイルに保存し、スクリプトで集計する（行を文脈に読み込まない）
|
|
269
|
+
|
|
270
|
+
出力の形:
|
|
271
|
+
JSON：{ platform, level, from, to, rowCount, rows: [...] }。from / to は既定値を使ったときも実際の期間が入る
|
|
272
|
+
CSV：rows だけ。UTF-8、1行目がヘッダー、null は空欄
|
|
273
|
+
Windows PowerShell 5.1 の > は UTF-16 で書くので、| Out-File -Encoding utf8 ads.csv で保存する
|
|
274
|
+
エラーは stderr に「✗ 理由」を出して終了コード 1
|
|
275
|
+
|
|
276
|
+
例:
|
|
277
|
+
# 直近7日の広告別（CR番号ごとの集計は crNumber で束ねる）
|
|
278
|
+
webgram report bytedance --account-id 7631042580838563847 --format csv > ads.csv
|
|
279
|
+
# 期間を決めたキャンペーン別（日別）
|
|
280
|
+
webgram report bytedance --level campaign --account-id 7631042580838563847 --from 2026-10-05 --to 2026-10-12
|
|
281
|
+
`;
|
|
229
282
|
const parseYmd = (v) => {
|
|
230
283
|
// 2026-02-30 のような実在しない日付もここで止める（サーバーまで送らない）
|
|
231
284
|
const d = new Date(v + 'T00:00:00Z');
|
|
@@ -239,6 +292,7 @@ const PLATFORM_COMMANDS = {
|
|
|
239
292
|
yda: { label: 'YDA', help: YDA_HELP },
|
|
240
293
|
smartnews: { label: 'SmartNews', help: SMARTNEWS_HELP },
|
|
241
294
|
google: { label: 'Google', help: GOOGLE_HELP, accountIdHint: '（ハイフンなし。例 8265446505）' },
|
|
295
|
+
bytedance: { label: 'TikTok', help: BYTEDANCE_HELP },
|
|
242
296
|
};
|
|
243
297
|
/** report コマンドを program に登録する。help の文面をテストで確かめられるよう index.ts から分けている */
|
|
244
298
|
function registerReportCommand(program) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/commands/report.ts"],"names":[],"mappings":";;;AAkDA,8BAgCC;AAGD,sBAUC;
|
|
1
|
+
{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/commands/report.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -918,7 +918,7 @@ finalUrl = baseURL + paramCode + "?ad=" + paramCode + "&creative=" + …
|
|
|
918
918
|
（cli/test/unit/plannerVersion.test.ts が package.json との一致を検証するので、
|
|
919
919
|
手で書き換えて放置するとテストが落ちる）。
|
|
920
920
|
利用者が「どの版のプランナーを開いているか」を言えないと、不具合報告が噛み合わない。 */
|
|
921
|
-
const APP_VERSION = '0.
|
|
921
|
+
const APP_VERSION = '0.18.0'; /* version:sync */
|
|
922
922
|
/* 案A: embed廃止。参照データ(refs)・初期プラン・共通設定は外部JSONから起動時に読み込む。
|
|
923
923
|
同梱デフォルト: アカウント/<媒体>/index.json の先頭アカウント (refs+principal+projectName+baseArticleUrl) と サンプルプラン.json (project+campaigns)。
|
|
924
924
|
固有名詞はハードコードせず、すべて外部JSON由来にする。 */
|