adyou 0.3.0 → 0.5.0

package/dist/adapters/meta.d.ts

@@ -15,6 +15,8 @@ export declare class MetaConnector implements Connector {
     ensurePixel(name: string): Promise<string>;
     inventory(): Promise<InventoryRow[]>;
     private findByName;
+    /** 영상 업로드(multipart source) → 처리 완료(ready)까지 대기 → video_id. 🔴 크리에이티브는 video_status 가 ready 여야 만들 수 있다 */
+    private uploadVideo;
     private uploadImage;
     build(input: BuildInput): Promise<BuildResult>;
     preview(placements: Placement[]): Promise<{

package/dist/adapters/meta.js

@@ -2,7 +2,7 @@
 //   예산=계정 통화 최소 단위 · Advantage+ 오디언스에선 age_max 금지 · DCO 광고세트엔 광고 1개(컨셉=광고세트) · instagram_user_id · WITH_ISSUES 2446984는 조치 불필요
 //   앱 개발 모드면 크리에이티브 생성 100 오류 · 픽셀 트래픽 권한 밖 도메인은 이벤트 조용히 폐기(signals/config blockReason)
 import fs from 'node:fs';
-import { MediumError, nameTag, utm } from './types.js';
+import { abKey, langGroups, localizedCopy, MediumError, nameTag, utm } from './types.js';
 const G = 'https://graph.facebook.com/v23.0';
 const REQUIRED_SCOPES = ['ads_management', 'ads_read', 'business_management', 'pages_show_list', 'pages_read_engagement', 'pages_manage_ads'];
 const COUNTRY_INTERESTS = {};
@@ -145,6 +145,29 @@ export class MetaConnector {
         const d = await this.call('GET', `${this.c.adAccountId}/${edge}`, { fields: 'id,name,status', limit: 500, filtering: [{ field: 'name', operator: 'CONTAIN', value: name.slice(0, 60) }], ...extra });
         return d.data.find((x) => x.name === name) || null;
     }
+    /** 영상 업로드(multipart source) → 처리 완료(ready)까지 대기 → video_id. 🔴 크리에이티브는 video_status 가 ready 여야 만들 수 있다 */
+    async uploadVideo(file, title, log) {
+        const fd = new FormData();
+        fd.set('access_token', this.c.accessToken);
+        fd.set('title', title.slice(0, 200));
+        fd.set('source', new Blob([fs.readFileSync(file)], { type: 'video/mp4' }), 'ad.mp4');
+        const res = await fetch(`${G}/${this.c.adAccountId}/advideos`, { method: 'POST', body: fd, signal: AbortSignal.timeout(600_000) });
+        const d = (await res.json().catch(() => ({})));
+        if (!res.ok || d.error || !d.id)
+            throw this.wrap(d.error || { message: `영상 업로드 실패 ${res.status}` }, 'advideos');
+        const t0 = Date.now();
+        while (Date.now() - t0 < 10 * 60_000) {
+            const st = await this.call('GET', d.id, { fields: 'status' });
+            const vs = st.status?.video_status;
+            if (vs === 'ready')
+                return d.id;
+            if (vs === 'error')
+                throw new MediumError('meta', '메타가 영상을 처리하지 못했어요(코덱·길이 확인)');
+            await new Promise((r) => setTimeout(r, 5000));
+        }
+        log('  ⚠ 영상 처리 대기 10분 초과 — 그대로 진행');
+        return d.id;
+    }
     async uploadImage(file) {
         const d = await this.call('POST', `${this.c.adAccountId}/adimages`, { bytes: fs.readFileSync(file).toString('base64') });
         const first = Object.values(d.images)[0];
@@ -156,7 +179,7 @@ export class MetaConnector {
         const log = input.log || (() => { });
         const warnings = [];
         const placements = [...input.existing];
-        const has = (kind, concept) => placements.find((p) => p.medium === 'meta' && p.kind === kind && (concept ? p.concept === concept : true));
+        const has = (kind, concept, format = 'image', lang) => placements.find((p) => p.medium === 'meta' && p.kind === kind && (concept ? p.concept === concept && (p.format || 'image') === format && (!lang || (p.lang || '') === (lang || '')) : true));
         const tag = nameTag(input.slug);
         if (!this.c.pageId)
             throw new MediumError('meta', '페이지 id가 없어요', '`adpilot connect meta --page <페이지 id>`');
@@ -180,46 +203,100 @@ export class MetaConnector {
         // 타겟: 시장 국가 · Advantage+ 오디언스(age_max 금지)
         const targeting = { geo_locations: { countries: input.markets.map((m) => m.country.toUpperCase()) }, age_min: 18, targeting_automation: { advantage_audience: 1 }, ...(input.markets.length === 1 && input.markets[0].language ? { locales: undefined } : {}) };
         const domain = new URL(input.landingUrl).hostname;
-        for (const c of input.concepts) {
-            const imgs = input.assets.filter((a) => a.concept === c.key && (a.medium === 'meta' || a.medium === 'both'));
-            if (!imgs.length) {
-                warnings.push(`${c.key}: 메타용 소재가 없어 건너뜀`);
-                continue;
-            }
-            let adset = has('adset', c.key);
-            if (!adset) {
-                const name = `${tag} ${c.key} · ${input.markets.map((m) => m.country).join('+')} · DCO`;
-                const found = await this.findByName('adsets', name);
-                const id = found?.id || (await this.call('POST', `${this.c.adAccountId}/adsets`, { name, campaign_id: camp.externalId, optimization_goal: optimization, billing_event: 'IMPRESSIONS', targeting, status: 'PAUSED', is_dynamic_creative: true, ...(input.pixelId ? { promoted_object: { pixel_id: input.pixelId, custom_event_type: eventType } } : {}) })).id;
-                adset = { medium: 'meta', kind: 'adset', concept: c.key, externalId: id, name, status: 'PAUSED', createdAt: new Date().toISOString() };
-                placements.push(adset);
-                log(`  meta 광고세트 ${c.key} ${found ? '재사용' : '생성'} ${id}`);
-            }
-            let creative = has('creative', c.key);
-            if (!creative) {
-                const hashes = [];
-                for (const a of imgs.filter((x) => [1080].includes(x.w)))
-                    hashes.push(await this.uploadImage(a.file));
-                const name = `${tag} ${c.key} · DCO`;
-                const d = await this.call('POST', `${this.c.adAccountId}/adcreatives`, {
-                    name,
-                    object_story_spec: { page_id: this.c.pageId, ...(this.c.instagramActorId ? { instagram_user_id: this.c.instagramActorId } : {}) },
-                    asset_feed_spec: {
-                        images: hashes.map((h) => ({ hash: h })), bodies: c.bodies.slice(0, 5).map((t) => ({ text: t })), titles: c.headlines.slice(0, 5).map((t) => ({ text: t })), descriptions: c.descriptions.slice(0, 2).map((t) => ({ text: t })),
-                        link_urls: [{ website_url: utm(input.landingUrl, 'meta', input.utmCampaign, c.key), display_url: domain }], call_to_action_types: [c.cta], ad_formats: ['SINGLE_IMAGE'],
-                    },
-                });
-                creative = { medium: 'meta', kind: 'creative', concept: c.key, externalId: d.id, name, status: 'OK', createdAt: new Date().toISOString() };
-                placements.push(creative);
-                log(`  meta 크리에이티브 ${c.key} 생성 ${d.id} (이미지 ${hashes.length})`);
-            }
-            if (!has('ad', c.key)) {
-                const name = `${tag} ${c.key}`;
-                const d = await this.call('POST', `${this.c.adAccountId}/ads`, { name, adset_id: adset.externalId, creative: { creative_id: creative.externalId }, status: 'PAUSED', ...(input.pixelId ? { conversion_domain: domain } : {}) });
-                placements.push({ medium: 'meta', kind: 'ad', concept: c.key, externalId: d.id, name, status: 'PAUSED', createdAt: new Date().toISOString() });
-                log(`  meta 광고 ${c.key} 생성 ${d.id}`);
+        // 언어 그룹 — 같은 언어를 쓰는 나라끼리 광고세트를 나눠 그 언어 문구·자막 소재만 넣는다(언어 섞임 방지 · 시장별 성과 비교)
+        const groups = langGroups(input.markets, input.brief.language);
+        for (const c of input.concepts)
+            for (const g of groups) {
+                const L = g.lang;
+                const lt = groups.length > 1 ? ` · ${L}` : '';
+                const cc = localizedCopy(c, L);
+                const forLang = (a) => (a.lang || input.brief.language) === L || (!a.lang && L === input.brief.language);
+                const imgs = input.assets.filter((a) => a.concept === c.key && (a.medium === 'meta' || a.medium === 'both') && (a.type || 'image') === 'image' && forLang(a));
+                const vids = input.assets.filter((a) => a.concept === c.key && (a.medium === 'meta' || a.medium === 'both') && a.type === 'video' && forLang(a));
+                if (!imgs.length && !vids.length) {
+                    warnings.push(`${c.key}${lt}: 메타용 소재가 없어 건너뜀`);
+                    continue;
+                }
+                const gTargeting = { ...targeting, geo_locations: { countries: g.countries } };
+                const gl = groups.length > 1 ? L : undefined;
+                if (imgs.length) {
+                    let adset = has('adset', c.key, 'image', gl);
+                    if (!adset) {
+                        const name = `${tag} ${c.key} · ${g.countries.join('+')} · DCO`;
+                        const found = await this.findByName('adsets', name);
+                        const id = found?.id || (await this.call('POST', `${this.c.adAccountId}/adsets`, { name, campaign_id: camp.externalId, optimization_goal: optimization, billing_event: 'IMPRESSIONS', targeting: gTargeting, status: 'PAUSED', is_dynamic_creative: true, ...(input.pixelId ? { promoted_object: { pixel_id: input.pixelId, custom_event_type: eventType } } : {}) })).id;
+                        adset = { medium: 'meta', kind: 'adset', concept: c.key, ...(gl ? { lang: gl } : {}), externalId: id, name, status: 'PAUSED', createdAt: new Date().toISOString() };
+                        placements.push(adset);
+                        log(`  meta 광고세트 ${c.key}${lt} ${found ? '재사용' : '생성'} ${id}`);
+                    }
+                    let creative = has('creative', c.key, 'image', gl);
+                    if (!creative) {
+                        const hashes = [];
+                        for (const a of imgs.filter((x) => [1080].includes(x.w)))
+                            hashes.push(await this.uploadImage(a.file));
+                        const name = `${tag} ${c.key}${lt} · DCO`;
+                        const d = await this.call('POST', `${this.c.adAccountId}/adcreatives`, {
+                            name,
+                            object_story_spec: { page_id: this.c.pageId, ...(this.c.instagramActorId ? { instagram_user_id: this.c.instagramActorId } : {}) },
+                            asset_feed_spec: {
+                                images: hashes.map((h) => ({ hash: h })), bodies: cc.bodies.slice(0, 5).map((t) => ({ text: t })), titles: cc.headlines.slice(0, 5).map((t) => ({ text: t })), descriptions: cc.descriptions.slice(0, 2).map((t) => ({ text: t })),
+                                link_urls: [{ website_url: utm(input.landingUrl, 'meta', input.utmCampaign, abKey(c.key, 'image', gl)), display_url: domain }], call_to_action_types: [c.cta], ad_formats: ['SINGLE_IMAGE'],
+                            },
+                        });
+                        creative = { medium: 'meta', kind: 'creative', concept: c.key, ...(gl ? { lang: gl } : {}), externalId: d.id, name, status: 'OK', createdAt: new Date().toISOString() };
+                        placements.push(creative);
+                        log(`  meta 크리에이티브 ${c.key}${lt} 생성 ${d.id} (이미지 ${hashes.length})`);
+                    }
+                    if (!has('ad', c.key, 'image', gl)) {
+                        const name = `${tag} ${c.key}${lt}`;
+                        const d = await this.call('POST', `${this.c.adAccountId}/ads`, { name, adset_id: adset.externalId, creative: { creative_id: creative.externalId }, status: 'PAUSED', ...(input.pixelId ? { conversion_domain: domain } : {}) });
+                        placements.push({ medium: 'meta', kind: 'ad', concept: c.key, ...(gl ? { lang: gl } : {}), externalId: d.id, name, status: 'PAUSED', createdAt: new Date().toISOString() });
+                        log(`  meta 광고 ${c.key}${lt} 생성 ${d.id}`);
+                    }
+                }
+                // 영상 광고 — 컨셉마다 별도 DCO 광고세트(형태 A/B: 이미지 vs 영상) · 9:16 원본 + 파생 비율을 한 크리에이티브의 변형으로
+                if (vids.length) {
+                    let adset = has('adset', c.key, 'video', gl);
+                    if (!adset) {
+                        const name = `${tag} ${c.key} · ${g.countries.join('+')} · VIDEO`;
+                        const found = await this.findByName('adsets', name);
+                        const id = found?.id || (await this.call('POST', `${this.c.adAccountId}/adsets`, { name, campaign_id: camp.externalId, optimization_goal: optimization, billing_event: 'IMPRESSIONS', targeting: gTargeting, status: 'PAUSED', is_dynamic_creative: true, ...(input.pixelId ? { promoted_object: { pixel_id: input.pixelId, custom_event_type: eventType } } : {}) })).id;
+                        adset = { medium: 'meta', kind: 'adset', concept: c.key, format: 'video', ...(gl ? { lang: gl } : {}), externalId: id, name, status: 'PAUSED', createdAt: new Date().toISOString() };
+                        placements.push(adset);
+                        log(`  meta 영상 광고세트 ${c.key}${lt} ${found ? '재사용' : '생성'} ${id}`);
+                    }
+                    let creative = has('creative', c.key, 'video', gl);
+                    if (!creative) {
+                        // 포맷(셀카 후기·화면 데모·시네마틱…)별 9:16 원본 + 파생 비율을 한 DCO 크리에이티브의 변형으로(최대 10) — 매체가 포맷·비율을 고른다
+                        const videos = [];
+                        const ordered = [...vids].sort((a, b) => (a.ratio === '9x16' ? -1 : 1) - (b.ratio === '9x16' ? -1 : 1));
+                        for (const v of ordered.slice(0, 10)) {
+                            const vid = await this.uploadVideo(v.file, `${tag} ${c.key} ${v.format || ''} ${v.ratio}${lt}`, log);
+                            const thumb = imgs.find((a) => a.ratio === v.ratio && a.w === 1080) || imgs.find((a) => a.w === 1080);
+                            videos.push({ video_id: vid, ...(thumb ? { thumbnail_hash: await this.uploadImage(thumb.file) } : {}) });
+                            log(`  meta 영상 업로드 ${c.key} ${v.format || ''} ${v.ratio}${lt} → ${vid}`);
+                        }
+                        const name = `${tag} ${c.key}${lt} · VIDEO · DCO`;
+                        const d = await this.call('POST', `${this.c.adAccountId}/adcreatives`, {
+                            name,
+                            object_story_spec: { page_id: this.c.pageId, ...(this.c.instagramActorId ? { instagram_user_id: this.c.instagramActorId } : {}) },
+                            asset_feed_spec: {
+                                videos, bodies: cc.bodies.slice(0, 5).map((t) => ({ text: t })), titles: cc.headlines.slice(0, 5).map((t) => ({ text: t })), descriptions: cc.descriptions.slice(0, 2).map((t) => ({ text: t })),
+                                link_urls: [{ website_url: utm(input.landingUrl, 'meta', input.utmCampaign, abKey(c.key, 'video', gl)), display_url: domain }], call_to_action_types: [c.cta], ad_formats: ['SINGLE_VIDEO'],
+                            },
+                        });
+                        creative = { medium: 'meta', kind: 'creative', concept: c.key, format: 'video', ...(gl ? { lang: gl } : {}), externalId: d.id, name, status: 'OK', createdAt: new Date().toISOString() };
+                        placements.push(creative);
+                        log(`  meta 영상 크리에이티브 ${c.key}${lt} 생성 ${d.id} (영상 ${videos.length})`);
+                    }
+                    if (!has('ad', c.key, 'video', gl)) {
+                        const name = `${tag} ${c.key}${lt} · video`;
+                        const d = await this.call('POST', `${this.c.adAccountId}/ads`, { name, adset_id: adset.externalId, creative: { creative_id: creative.externalId }, status: 'PAUSED', ...(input.pixelId ? { conversion_domain: domain } : {}) });
+                        placements.push({ medium: 'meta', kind: 'ad', concept: c.key, format: 'video', ...(gl ? { lang: gl } : {}), externalId: d.id, name, status: 'PAUSED', createdAt: new Date().toISOString() });
+                        log(`  meta 영상 광고 ${c.key}${lt} 생성 ${d.id}`);
+                    }
+                }
             }
-        }
         return { placements, warnings };
     }
     async preview(placements) {
@@ -229,7 +306,7 @@ export class MetaConnector {
                 try {
                     const d = await this.call('GET', `${ad.externalId}/previews`, { ad_format: fmt });
                     if (d.data[0]?.body)
-                        out.push({ concept: ad.concept, name: `Meta · ${fmt === 'INSTAGRAM_STANDARD' ? 'Instagram' : 'Facebook 피드'} · ${ad.concept}`, html: d.data[0].body });
+                        out.push({ concept: ad.concept, name: `Meta · ${fmt === 'INSTAGRAM_STANDARD' ? 'Instagram' : 'Facebook 피드'} · ${ad.concept}${ad.format === 'video' ? ' · 영상' : ''}`, html: d.data[0].body });
                 }
                 catch (e) {
                     out.push({ concept: ad.concept, name: `Meta · ${fmt}`, html: `<p>미리보기 실패: ${e instanceof Error ? e.message : e}</p>` });
@@ -255,9 +332,9 @@ export class MetaConnector {
         if (!camp)
             return [];
         const acc = await this.account();
-        const d = await this.call('GET', `${this.c.adAccountId}/insights`, { level: 'ad', fields: 'ad_id,ad_name,adset_id,spend,impressions,clicks,actions', time_range: { since: range.since, until: range.until }, time_increment: 1, filtering: [{ field: 'campaign.id', operator: 'IN', value: [camp.externalId] }], limit: 1000 });
+        const d = await this.call('GET', `${this.c.adAccountId}/insights`, { level: 'ad', fields: 'ad_id,ad_name,adset_id,spend,impressions,clicks,actions,video_play_actions,video_thruplay_watched_actions,video_p50_watched_actions', time_range: { since: range.since, until: range.until }, time_increment: 1, filtering: [{ field: 'campaign.id', operator: 'IN', value: [camp.externalId] }], limit: 1000 });
         const conv = (acts) => (acts || []).filter((a) => ['purchase', 'lead', 'complete_registration', 'offsite_conversion.fb_pixel_purchase', 'offsite_conversion.fb_pixel_lead', 'offsite_conversion.fb_pixel_complete_registration'].includes(a.action_type)).reduce((n, a) => n + Number(a.value), 0);
-        return d.data.map((r) => ({ date: r.date_start, level: 'ad', id: r.ad_id, name: r.ad_name, concept: placements.find((p) => p.externalId === r.ad_id)?.concept, spend: Number(r.spend), impressions: Number(r.impressions), clicks: Number(r.clicks), conversions: conv(r.actions), currency: acc.currency }));
+        return d.data.map((r) => ({ date: r.date_start, level: 'ad', id: r.ad_id, name: r.ad_name, concept: placements.find((p) => p.externalId === r.ad_id)?.concept, format: placements.find((p) => p.externalId === r.ad_id)?.format || 'image', lang: placements.find((p) => p.externalId === r.ad_id)?.lang, spend: Number(r.spend), impressions: Number(r.impressions), clicks: Number(r.clicks), conversions: conv(r.actions), videoPlays: Number(r.video_play_actions?.[0]?.value || 0) || undefined, thruplays: Number(r.video_thruplay_watched_actions?.[0]?.value || 0) || undefined, videoP50: Number(r.video_p50_watched_actions?.[0]?.value || 0) || undefined, currency: acc.currency }));
     }
     async policy(placements) {
         const out = [];

package/dist/adapters/mock.js

@@ -2,7 +2,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { HOME } from '../core/state.js';
-import { nameTag } from './types.js';
+import { langGroups, nameTag } from './types.js';
 export class MockConnector {
     medium;
     currency;
@@ -28,8 +28,8 @@ export class MockConnector {
         const st = this.load();
         const placements = [...input.existing];
         const tag = nameTag(input.slug);
-        const mk = (kind, concept) => { const existing = placements.find((p) => p.medium === this.medium && p.kind === kind && p.concept === concept); if (existing)
-            return existing; const p = { medium: this.medium, kind, concept, externalId: `${this.medium}_${kind}_${concept || 'root'}_${Math.random().toString(36).slice(2, 8)}`, name: `${tag} ${kind} ${concept || ''}`.trim(), status: 'PAUSED', createdAt: new Date().toISOString() }; placements.push(p); st.objects.push(p); return p; };
+        const mk = (kind, concept, format, lang) => { const existing = placements.find((p) => p.medium === this.medium && p.kind === kind && p.concept === concept && (p.format || 'image') === (format || 'image') && (p.lang || '') === (lang || '')); if (existing)
+            return existing; const p = { medium: this.medium, kind, concept, ...(format ? { format } : {}), ...(lang ? { lang } : {}), externalId: `${this.medium}_${kind}_${concept || 'root'}${format === 'video' ? '_video' : ''}${lang ? `_${lang}` : ''}_${Math.random().toString(36).slice(2, 8)}`, name: `${tag} ${kind} ${concept || ''}${format === 'video' ? ' · video' : ''}${lang ? ` · ${lang}` : ''}`.trim(), status: 'PAUSED', createdAt: new Date().toISOString() }; placements.push(p); st.objects.push(p); return p; };
         if (input.validateOnly) {
             st.calls.push('validate');
             this.save(st);
@@ -38,13 +38,27 @@ export class MockConnector {
         mk('campaign');
         if (this.medium === 'google')
             mk('adgroup');
-        for (const c of input.concepts) {
-            if (this.medium === 'meta') {
-                mk('adset', c.key);
-                mk('creative', c.key);
+        const groups = this.medium === 'meta' ? langGroups(input.markets, input.brief.language) : [{ lang: input.brief.language, countries: input.markets.map((m) => m.country) }];
+        for (const c of input.concepts)
+            for (const g of groups) {
+                const gl = groups.length > 1 ? g.lang : undefined;
+                const forLang = (a) => (a.lang || input.brief.language) === g.lang;
+                const imgs = input.assets.filter((a) => a.concept === c.key && (a.type || 'image') === 'image' && forLang(a));
+                const vids = input.assets.filter((a) => a.concept === c.key && a.type === 'video' && forLang(a));
+                if (imgs.length || !vids.length) {
+                    if (this.medium === 'meta') {
+                        mk('adset', c.key, 'image', gl);
+                        mk('creative', c.key, 'image', gl);
+                    }
+                    mk('ad', c.key, undefined, gl);
+                }
+                // 영상은 메타만(구글 디스플레이는 유튜브 영상만 받는다) · 컨셉별 형태 A/B · 언어별
+                if (vids.length && this.medium === 'meta') {
+                    mk('adset', c.key, 'video', gl);
+                    mk('creative', c.key, 'video', gl);
+                    mk('ad', c.key, 'video', gl);
+                }
             }
-            mk('ad', c.key);
-        }
         st.calls.push(`build budget=${input.dailyBudgetMinor} ${input.currency}`);
         this.save(st);
         return { placements, warnings: [] };
@@ -59,7 +73,7 @@ export class MockConnector {
         const d0 = new Date(range.since);
         const d1 = new Date(range.until);
         for (let d = new Date(d0); d <= d1; d.setDate(d.getDate() + 1))
-            ads.forEach((a, i) => { const imp = 1000 + i * 400; const clicks = Math.round(imp * (0.008 + i * 0.006)); out.push({ date: d.toISOString().slice(0, 10), level: 'ad', id: a.externalId, name: a.name, concept: a.concept, spend: this.currency === 'USD' ? 8 + i : 12000 + i * 1500, impressions: imp, clicks, conversions: i === 1 ? 3 : 1, currency: this.currency }); });
+            ads.forEach((a, i) => { const imp = 1000 + i * 400; const clicks = Math.round(imp * (0.008 + i * 0.006)); out.push({ date: d.toISOString().slice(0, 10), level: 'ad', id: a.externalId, name: a.name, concept: a.concept, format: a.format || 'image', lang: a.lang, ...(a.format === 'video' ? { videoPlays: Math.round(imp * 0.6), thruplays: Math.round(imp * (0.12 + i * 0.03)), videoP50: Math.round(imp * 0.2) } : {}), spend: this.currency === 'USD' ? 8 + i : 12000 + i * 1500, impressions: imp, clicks, conversions: i === 1 ? 3 : 1, currency: this.currency }); });
         return out;
     }
     async policy(placements) { return placements.filter((p) => p.medium === this.medium && p.kind === 'ad').map((p) => ({ id: p.externalId, name: p.name, status: 'APPROVED', issues: [] })); }

package/dist/adapters/types.d.ts

@@ -44,6 +44,11 @@ export type MetricRow = {
     id: string;
     name: string;
     concept?: string;
+    format?: 'image' | 'video';
+    lang?: string; /** 영상: 재생 수 · 완주(ThruPlay · 15초 또는 끝까지) · 50% 시청 — 훅률·완주율 계산 */
+    videoPlays?: number;
+    thruplays?: number;
+    videoP50?: number;
     spend: number;
     impressions: number;
     clicks: number;
@@ -98,3 +103,28 @@ export declare class MediumError extends Error {
 }
 export declare const utm: (url: string, medium: Medium, campaign: string, content: string) => string;
 export declare const nameTag: (slug: string) => string;
+/** A/B 키 — 컨셉(+영상이면 _video) · utm_content 와 광고 이름에 같이 쓴다 */
+export declare const abKey: (concept: string, format?: "image" | "video", lang?: string) => string;
+/** 시장을 언어별로 묶는다(같은 언어 나라 = 한 광고세트) · 기본 언어 그룹이 먼저 */
+export declare function langGroups(markets: {
+    country: string;
+    language: string;
+}[], baseLang: string): {
+    lang: string;
+    countries: string[];
+}[];
+/** 언어별 문구(컨셉 i18n 이 있으면 치환) */
+export declare function localizedCopy(c: {
+    headlines: string[];
+    bodies: string[];
+    descriptions: string[];
+    i18n?: Record<string, {
+        headlines: string[];
+        bodies: string[];
+        descriptions: string[];
+    }>;
+}, lang: string): {
+    headlines: string[];
+    bodies: string[];
+    descriptions: string[];
+};

package/dist/adapters/types.js

@@ -18,3 +18,19 @@ export const utm = (url, medium, campaign, content) => {
     return u.toString();
 };
 export const nameTag = (slug) => `[adp:${slug}]`;
+/** A/B 키 — 컨셉(+영상이면 _video) · utm_content 와 광고 이름에 같이 쓴다 */
+export const abKey = (concept, format, lang) => `${format === 'video' ? `${concept}_video` : concept}${lang ? `_${lang}` : ''}`;
+/** 시장을 언어별로 묶는다(같은 언어 나라 = 한 광고세트) · 기본 언어 그룹이 먼저 */
+export function langGroups(markets, baseLang) {
+    const m = new Map();
+    for (const x of markets) {
+        const l = x.language || baseLang;
+        m.set(l, [...(m.get(l) || []), x.country.toUpperCase()]);
+    }
+    return [...m.entries()].map(([lang, countries]) => ({ lang, countries })).sort((a, b) => (a.lang === baseLang ? -1 : 0) - (b.lang === baseLang ? -1 : 0));
+}
+/** 언어별 문구(컨셉 i18n 이 있으면 치환) */
+export function localizedCopy(c, lang) {
+    const t = c.i18n?.[lang];
+    return t && t.headlines.length ? { headlines: t.headlines, bodies: t.bodies.length ? t.bodies : c.bodies, descriptions: t.descriptions.length ? t.descriptions : c.descriptions } : { headlines: c.headlines, bodies: c.bodies, descriptions: c.descriptions };
+}

package/dist/cli.js

@@ -104,10 +104,10 @@ program.command('brief <url>').description('사이트 읽고 브리프 만들기
         die(e);
     }
 });
-program.command('creatives').description('컨셉·카피 + 이미지 생성 + 12규격 합성 + 규격 검사').option('--concepts <n>', '컨셉 수', '3').option('--feedback <text>', '자연어 수정(「더 고급스럽게」) — 전부 다시 만든다').option('--images <folder>', '직접 준비한 배경 이미지 폴더').option('--no-images', '이미지 생성 없이 브랜드 그래디언트').option('--force', '다시 만들기').action(async (o) => {
+program.command('creatives').description('컨셉·카피 + 이미지 생성 + 12규격 합성 + 규격 검사').option('--concepts <n>', '컨셉 수', '3').option('--feedback <text>', '자연어 수정(「더 고급스럽게」) — 전부 다시 만든다').option('--images <folder>', '직접 준비한 배경 이미지 폴더').option('--no-images', '이미지 생성 없이 브랜드 그래디언트').option('--force', '다시 만들기').option('--mode <mode>', '소재 형태 auto|image|video|text').option('--video', '영상 소재도 만든다(9:16 8초 · Veo 3.1 · 소리 포함)').option('--video-seconds <n>', '영상 길이 8|15|30 (15/30 은 Seedance 2.5)').option('--requirements <text>', '요구사항·방향(참고 이미지는 --images 폴더)').action(async (o) => {
     try {
         const p = resolveProject(program.opts().project);
-        const { project, report } = await opCreatives(p, { count: Number(o.concepts), feedback: o.feedback, images: o.images, noImages: o.images === false, force: o.force, log });
+        const { project, report } = await opCreatives(p, { count: Number(o.concepts), feedback: o.feedback, images: o.images, noImages: o.images === false, force: o.force, mode: o.mode, video: o.video, videoSeconds: o.videoSeconds ? Number(o.videoSeconds) : undefined, requirements: o.requirements, log });
         log(`\n컨셉 ${project.concepts.length}개 · 소재 ${project.assets.filter((a) => a.concept !== '_logo').length}장`);
         for (const c of project.concepts)
             log(`  · ${c.name}(${c.key}) — ${c.headlines[0]}`);

package/dist/core/brief.js

@@ -1,6 +1,7 @@
 // 브리프 — 사이트 스냅샷 → 「이 회사는 ○○를 팔고 고객은 ○○로 보여요」. LLM이 있으면 LLM, 없으면 규칙으로 최소 브리프.
 import { z } from 'zod';
 import { aiAvailable, completeJson } from './llm.js';
+import { INDUSTRY_KEYS } from './creatives/playbook.js';
 import { readSite } from './site.js';
 /** 특별 광고 카테고리(정치·금융·주택·고용·의료·도박 등)는 자동 심사 통과가 어려워 접수 거절 */
 const SPECIAL = [
@@ -21,6 +22,10 @@ const BriefSchema = z.object({
     palette: z.object({ primary: z.string(), dark: z.string(), light: z.string() }),
     specialCategory: z.string().nullable().default(null),
     notes: z.string().default(''),
+    industry: z.string().default('other'),
+    visualGenres: z.array(z.string()).min(1).max(3).default(['photoreal']),
+    audienceProfile: z.object({ ageRange: z.string().optional(), gender: z.string().optional(), persona: z.string().optional(), interests: z.array(z.string()).optional(), painPoint: z.string().optional() }).default({}),
+    proofPoints: z.array(z.string()).max(6).default([]),
 });
 function pickPalette(s) {
     const primary = (s.themeColor && /^#[0-9a-f]{6}$/i.test(s.themeColor) ? s.themeColor : s.colors.find((c) => !/^#([0-9a-f])\1{5}$/i.test(c) && !/^#(f[0-9a-f]f[0-9a-f]f[0-9a-f]|[0-2][0-9a-f]{5})$/i.test(c))) || '#3182f6';
@@ -46,13 +51,17 @@ export async function buildBrief(url, opts) {
 - language: 광고 카피 기본 언어 코드(사이트 언어 · 시장이 해외면 그 언어)
 - palette: 사이트에서 읽힌 대표색 hex(primary) · 어두운 배경색(dark) · 밝은 배경색(light). 못 읽으면 후보를 그대로.
 - specialCategory: 금융·의료·정치·도박·담배·성인 등 특별 광고 카테고리에 해당하면 그 이름, 아니면 null
-- notes: 광고 만들 때 주의할 점 한두 문장(가격 표기·금지어 등)`,
+- notes: 광고 만들 때 주의할 점 한두 문장(가격 표기·금지어 등)
+- industry: 업종 키 하나 — ${INDUSTRY_KEYS.join('|')} 중에서(없으면 other)
+- visualGenres: 소재 비주얼 장르 1~3개(우선순위) — photoreal(실사) · ugc(셀카·후기 실사) · anime(애니) · 3d(3D 렌더) · illustration(일러스트) · motion_graphics(모션그래픽) · product_shot(제품 스튜디오). 브랜드가 애니·게임·웹툰이면 anime 를 앞에, 일반 상품·서비스는 photoreal/ugc 를 앞에. 애니 브랜드가 아닌데 anime 를 쓰면 이상하니 넣지 않는다.
+- audienceProfile: ageRange(예 "25-34") · gender(all|female|male) · persona(UGC 배우로 쓸 한 줄 인물 묘사 · 영어) · interests 2~4 · painPoint(한 문장)
+- proofPoints: 숫자·수상·후기·보증 등 사이트에 실제로 있는 증거 문구 0~5(없으면 빈 배열 · 만들지 않는다)`,
             user: JSON.stringify({ url: site.finalUrl, title: site.title, description: site.description, lang: site.lang, headings: site.headings, prices: site.prices, colorsFound: site.colors.slice(0, 8), themeColor: site.themeColor, textExcerpt: site.text.slice(0, 3500), goal: opts.goal, markets: opts.markets, hints: opts.hints || '' }),
         });
-        brief = { url: site.finalUrl, ...out, palette: { primary: /^#[0-9a-f]{6}$/i.test(out.palette.primary) ? out.palette.primary.toLowerCase() : fallbackPalette.primary, dark: /^#[0-9a-f]{6}$/i.test(out.palette.dark) ? out.palette.dark : fallbackPalette.dark, light: /^#[0-9a-f]{6}$/i.test(out.palette.light) ? out.palette.light : fallbackPalette.light }, logoUrl: site.logo, ogImage: site.ogImage, specialCategory: out.specialCategory || special };
+        brief = { url: site.finalUrl, ...out, palette: { primary: /^#[0-9a-f]{6}$/i.test(out.palette.primary) ? out.palette.primary.toLowerCase() : fallbackPalette.primary, dark: /^#[0-9a-f]{6}$/i.test(out.palette.dark) ? out.palette.dark : fallbackPalette.dark, light: /^#[0-9a-f]{6}$/i.test(out.palette.light) ? out.palette.light : fallbackPalette.light }, logoUrl: site.logo, ogImage: site.ogImage, specialCategory: out.specialCategory || special, siteImages: site.images };
     }
     else {
-        brief = { url: site.finalUrl, company: site.title.split(/[|·—\-–:]/)[0].trim() || new URL(site.finalUrl).hostname, offer: site.description || site.headings[0] || site.title, category: '', audience: ['사이트 방문자'], usp: site.headings.slice(0, 3), tone: '단정하고 명확', language: site.lang || 'ko', palette: fallbackPalette, logoUrl: site.logo, ogImage: site.ogImage, specialCategory: special, notes: 'LLM 키가 없어 규칙으로 만든 최소 브리프예요. `adpilot brief --edit` 로 다듬어 주세요.' };
+        brief = { url: site.finalUrl, company: site.title.split(/[|·—\-–:]/)[0].trim() || new URL(site.finalUrl).hostname, offer: site.description || site.headings[0] || site.title, category: '', audience: ['사이트 방문자'], usp: site.headings.slice(0, 3), tone: '단정하고 명확', language: site.lang || 'ko', palette: fallbackPalette, logoUrl: site.logo, ogImage: site.ogImage, specialCategory: special, industry: 'other', visualGenres: ['photoreal'], siteImages: site.images, notes: 'LLM 키가 없어 규칙으로 만든 최소 브리프예요. `adpilot brief --edit` 로 다듬어 주세요.' };
     }
     return { brief, site };
 }

package/dist/core/creatives/copy.d.ts

@@ -1,11 +1,20 @@
 import type { Brief, Concept, Goal } from '../state.js';
 import { wlen } from './specs.js';
-export declare function generateConcepts(brief: Brief, opts: {
+export type ConceptOpts = {
     goal: Goal;
     count: number;
     feedback?: string;
-    previous?: Concept[];
-}): Promise<Concept[]>;
+    previous?: Concept[]; /** guided: 광고주 요구사항·방향 */
+    requirements?: string; /** 참고 이미지 설명(있으면 비주얼을 그 제품·인물에 맞춘다) */
+    referenceNote?: string; /** manual: 광고주가 직접 쓴 문구 — 이걸 다듬어 규격에 맞추기만 한다 */
+    userCopy?: {
+        headlines?: string[];
+        bodies?: string[];
+        descriptions?: string[];
+    }; /** 영상 프롬프트·자막도 만들지 */
+    video?: boolean;
+};
+export declare function generateConcepts(brief: Brief, opts: ConceptOpts): Promise<Concept[]>;
 /** 매체별 카피 규격 검사 요약 */
 export declare function validateConcepts(concepts: Concept[]): {
     ok: boolean;

package/dist/core/creatives/copy.js

@@ -3,9 +3,10 @@ import { z } from 'zod';
 import { aiAvailable, completeJson } from '../llm.js';
 import { checkCopy, ctaFor, fit, GOOGLE_LIMITS, wlen } from './specs.js';
 const ConceptSchema = z.object({
-    key: z.string().regex(/^[a-z][a-z0-9_]{1,19}$/), name: z.string(), angle: z.string(),
-    headlines: z.array(z.string()).min(3).max(6), bodies: z.array(z.string()).min(2).max(6), descriptions: z.array(z.string()).min(1).max(3),
+    key: z.string().regex(/^[a-z][a-z0-9_]{1,19}$/), name: z.string().optional(), angle: z.string().optional(),
+    headlines: z.array(z.string()).min(1).max(8), bodies: z.array(z.string()).min(1).max(8), descriptions: z.array(z.string()).min(1).max(4),
     imagePrompt: z.string(), theme: z.enum(['dark', 'light']).default('dark'),
+    videoPrompt: z.string().optional(), videoLines: z.array(z.string()).optional(), videoVoice: z.string().optional().nullable(),
 });
 export async function generateConcepts(brief, opts) {
     const cta = ctaFor(opts.goal);
@@ -15,20 +16,38 @@ export async function generateConcepts(brief, opts) {
         schema: z.object({ concepts: z.array(ConceptSchema).min(1) }), maxTokens: 6000, timeoutMs: 120_000,
         system: `너는 퍼포먼스 광고 카피라이터이자 아트디렉터다. 브리프로 서로 다른 각도의 광고 컨셉 ${opts.count}개를 만든다(혜택·증거/사회적 증명·긴급/희소·비교/대안·감성 중에서 고르되 겹치지 않게).
 규칙:
-- 언어는 brief.language. 사실은 브리프(usp·offer)에 있는 것만. 과장·최상급(최고·1위·100%·보장·무조건)·클릭 유도 금지.
+- 언어: headlines·bodies·descriptions·videoLines·videoVoice·name·angle 전부 brief.language(${brief.language}) 하나로 — 다른 언어를 섞지 않는다(요구사항이 한국어로 적혀 있어도 출력 언어는 brief.language). 사실은 브리프(usp·offer)에 있는 것만. 과장·최상급(최고·1위·100%·보장·무조건)·클릭 유도 금지.
 - headlines: 짧은 제목 5개 — 각각 ${GOOGLE_LIMITS.headline}자(한글·전각은 2자로 셈 → 한글 15자) 이내. 첫 번째는 그 컨셉의 대표 문장.
 - bodies: 본문 5개 — 60~120자. 구체적 혜택·근거·누구를 위한 것인지. 존댓말(해요체).
 - descriptions: 설명 2개 — 각각 ${GOOGLE_LIMITS.description}자(한글 45자) 이내.
 - imagePrompt: 배경 비주얼 생성 프롬프트(영어). 글자·로고·UI 절대 없음. 헤드라인을 올릴 넉넉한 여백. 브랜드색 ${brief.palette.primary}. 실존 인물·타사 로고 금지.
 - theme: 어두운 배경(dark)이 어울리면 dark, 밝고 가벼우면 light.
-- key: 영문 소문자 짧은 식별자(예 benefit·proof·urgency).${opts.feedback ? `\n사용자 수정 요청: 「${opts.feedback}」 — 이 요청을 반영해 전부 다시 만든다.` : ''}`,
-        user: JSON.stringify({ brief, goal: opts.goal, cta, previous: opts.previous?.map((c) => ({ key: c.key, name: c.name, angle: c.angle, headline: c.headlines[0] })) }),
+- key: 영문 소문자 짧은 식별자(예 benefit·proof·urgency). name: 컨셉 이름(brief.language · 2~6단어). angle: 이 컨셉이 노리는 각도 한 문장.
+- 출력 JSON: {"concepts":[{key,name,angle,headlines[],bodies[],descriptions[],imagePrompt,theme,videoPrompt,videoLines[],videoVoice}]} — 모든 키를 빠짐없이.
+- videoPrompt: 8~15초 짧은 광고 영상 한 컷 연출 프롬프트(영어 · 피사체·동작·카메라·조명·분위기 · 실존 인물·타사 로고·화면 글자 없음 · "No on-screen text, no subtitles, no logos" 로 끝낸다). 소리(잔잔한 BGM·효과음)도 한 줄 지시. 첫 프레임은 imagePrompt 의 비주얼에서 자연스럽게 움직여 나간다고 가정.
+- videoLines: 영상에 얹을 화면 자막 2~3줄(brief.language · 각 18자 이내 · 훅 → 혜택 → 행동 순). videoVoice: 내레이션 한 문장(선택 · brief.language).${opts.requirements ? `\n광고주 요구사항(반드시 반영): 「${opts.requirements}」` : ''}${opts.referenceNote ? `\n참고 이미지: ${opts.referenceNote} — imagePrompt·videoPrompt 는 이 제품/인물이 주인공이 되게 쓴다("the product from the reference image" 처럼 지칭).` : ''}${opts.userCopy ? `\n광고주가 직접 쓴 문구(userCopy)가 있다 — 뜻·톤을 바꾸지 말고 규격(글자 수·정책)에만 맞춰 다듬어 headlines/bodies/descriptions 를 채운다. 컨셉은 그 문구를 나누어 담는다.` : ''}${opts.feedback ? `\n사용자 수정 요청: 「${opts.feedback}」 — 이 요청을 반영해 전부 다시 만든다.` : ''}`,
+        user: JSON.stringify({ brief, goal: opts.goal, cta, userCopy: opts.userCopy, previous: opts.previous?.map((c) => ({ key: c.key, name: c.name, angle: c.angle, headline: c.headlines[0] })) }),
     });
-    const concepts = out.concepts.slice(0, opts.count).map((c) => ({ ...c, cta: cta.meta, headlines: c.headlines.map((h) => fit(h.trim(), GOOGLE_LIMITS.headline)).filter(Boolean), descriptions: c.descriptions.map((d) => fit(d.trim(), GOOGLE_LIMITS.description)).filter(Boolean), bodies: c.bodies.map((b) => b.trim()).filter(Boolean) }));
+    // 언어 가드 — 시장 언어가 한국어가 아닌데 한글이 섞이면(요구사항·브리프가 한국어라 자주 생김) 한 번 더 그 언어로만 다시 쓴다
+    const lang = (brief.language || 'ko').split('-')[0];
+    const hasHangul = (t) => /[가-힣]/.test(t);
+    const violates = (cs) => lang !== 'ko' && cs.some((c) => [...c.headlines, ...c.bodies, ...c.descriptions, ...(c.videoLines || []), c.videoVoice || ''].some(hasHangul));
+    if (violates(out.concepts) && !opts.feedback?.includes('LANGUAGE_FIX')) {
+        const fixed = await generateConcepts(brief, { ...opts, feedback: `LANGUAGE_FIX: 직전 답에 한국어가 섞였어요. headlines·bodies·descriptions·videoLines·videoVoice·name·angle 전부 ${brief.language} 로만 다시 써 주세요(브리프·요구사항이 한국어여도 출력은 ${brief.language}).` });
+        return fixed;
+    }
+    const concepts = out.concepts.slice(0, opts.count).map((c) => ({ ...c, name: (c.name || c.headlines[0] || c.key).trim(), angle: (c.angle || c.descriptions[0] || c.headlines[0] || '').trim(), cta: cta.meta, headlines: c.headlines.map((h) => fit(h.trim(), GOOGLE_LIMITS.headline)).filter(Boolean).slice(0, 6), descriptions: c.descriptions.map((d) => fit(d.trim(), GOOGLE_LIMITS.description)).filter(Boolean).slice(0, 3), bodies: c.bodies.map((b) => b.trim()).filter(Boolean).slice(0, 6), videoLines: (c.videoLines || []).map((l) => l.trim()).filter(Boolean).slice(0, 3), videoVoice: c.videoVoice || undefined }));
     return concepts;
 }
 function fallbackConcepts(brief, opts) {
     const cta = ctaFor(opts.goal);
+    const uc = opts.userCopy;
+    if (uc && (uc.headlines?.length || uc.bodies?.length)) {
+        const heads = (uc.headlines || []).map((h) => fit(h.trim(), GOOGLE_LIMITS.headline)).filter(Boolean);
+        const bodies = (uc.bodies || []).map((b) => b.trim()).filter(Boolean);
+        const descs = (uc.descriptions || []).map((d) => fit(d.trim(), GOOGLE_LIMITS.description)).filter(Boolean);
+        return [{ key: 'mine', name: '내 문구', angle: '광고주가 직접 쓴 문구', cta: cta.meta, theme: 'dark', headlines: heads.length ? heads : [fit(brief.company, GOOGLE_LIMITS.headline)], bodies: bodies.length ? bodies : [brief.offer], descriptions: descs.length ? descs : [fit(brief.offer, GOOGLE_LIMITS.description)], imagePrompt: `Abstract premium background in ${brief.palette.primary}, soft gradients, no text`, videoPrompt: `Slow cinematic push-in on an abstract premium gradient scene in ${brief.palette.primary}, soft light, gentle ambient music. No on-screen text, no subtitles, no logos.`, videoLines: heads.slice(0, 3) }];
+    }
     const base = brief.usp.length ? brief.usp : [brief.offer];
     return base.slice(0, opts.count).map((u, i) => ({
         key: ['benefit', 'proof', 'urgency', 'compare', 'emotion'][i] || `c${i}`, name: `컨셉 ${i + 1}`, angle: u, cta: cta.meta, theme: 'dark',
@@ -36,6 +55,8 @@ function fallbackConcepts(brief, opts) {
         bodies: [`${brief.offer} ${brief.company}에서 확인해 보세요.`, `${u}. ${brief.company}.`],
         descriptions: [fit(brief.offer, GOOGLE_LIMITS.description)],
         imagePrompt: `Abstract premium background in ${brief.palette.primary} and deep navy, soft gradients, no text, no logos, generous empty space`,
+        videoPrompt: `Slow cinematic camera drift over an abstract premium scene in ${brief.palette.primary} and deep navy, soft volumetric light, calm ambient music. No on-screen text, no subtitles, no logos.`,
+        videoLines: [fit(u, 18), fit(brief.offer, 18), '지금 확인해 보세요'].filter(Boolean),
     }));
 }
 /** 매체별 카피 규격 검사 요약 */

package/dist/core/creatives/factory.d.ts

@@ -0,0 +1,29 @@
+import type { Brief, Concept, CreativeAsset, Goal } from '../state.js';
+import { type VideoJob, type VideoRatio } from './media.js';
+import { type Tone } from './playbook.js';
+export type VideoAsset = CreativeAsset & {
+    type: 'video';
+    costKrw: number;
+    durationSec: number;
+    mime: 'video/mp4';
+};
+export type FactoryLog = (s: string) => void;
+export type FactoryInput = {
+    dir: string;
+    brief: Brief;
+    concept: Concept;
+    jobs: VideoJob[];
+    backgrounds: Record<string, string | null>;
+    refs?: string[];
+    siteShot?: string | null;
+    siteImages?: string[];
+    langs?: string[];
+    tone?: Tone;
+    goal?: Goal;
+    log?: FactoryLog;
+    onAsset?: (a: VideoAsset) => void | Promise<void>;
+};
+/** 영상용 엔드카드 PNG — 해당 비율의 포스터를 영상 크기로 렌더(언어별 문구) */
+export declare function renderEndCard(dir: string, brief: Brief, concept: Concept, ratio: VideoRatio, lang: string, backgrounds?: Record<string, string | null>): Promise<string | null>;
+/** 컨셉의 영상 소재 전부(포맷 × 언어 × 비율) — 실패한 포맷은 건너뛰고 로그 · 성공한 건마다 onAsset */
+export declare function produceConceptVideos(o: FactoryInput): Promise<VideoAsset[]>;