adyou 0.4.0 → 0.5.0

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 { abKey, 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 = {};
@@ -179,7 +179,7 @@ export class MetaConnector {
         const log = input.log || (() => { });
         const warnings = [];
         const placements = [...input.existing];
-        const has = (kind, concept, format = 'image') => placements.find((p) => p.medium === 'meta' && p.kind === kind && (concept ? p.concept === concept && (p.format || 'image') === format : 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>`');
@@ -203,89 +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') && (a.type || 'image') === 'image');
-            const vids = input.assets.filter((a) => a.concept === c.key && (a.medium === 'meta' || a.medium === 'both') && a.type === 'video');
-            if (!imgs.length && !vids.length) {
-                warnings.push(`${c.key}: 메타용 소재가 없어 건너뜀`);
-                continue;
-            }
-            if (imgs.length) {
-                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;
                 }
-            }
-            // 영상 광고 — 컨셉마다 별도 DCO 광고세트(형태 A/B: 이미지 vs 영상) · 9:16 원본 + 파생 비율을 한 크리에이티브의 변형으로
-            if (vids.length) {
-                let adset = has('adset', c.key, 'video');
-                if (!adset) {
-                    const name = `${tag} ${c.key} · ${input.markets.map((m) => m.country).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, 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', externalId: id, name, status: 'PAUSED', createdAt: new Date().toISOString() };
-                    placements.push(adset);
-                    log(`  meta 영상 광고세트 ${c.key} ${found ? '재사용' : '생성'} ${id}`);
-                }
-                let creative = has('creative', c.key, 'video');
-                if (!creative) {
-                    const videos = [];
-                    for (const v of vids.slice(0, 3)) {
-                        const vid = await this.uploadVideo(v.file, `${tag} ${c.key} ${v.ratio}`, 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.ratio} → ${vid}`);
+                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}`);
                     }
-                    const name = `${tag} ${c.key} · 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: 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, abKey(c.key, 'video')), display_url: domain }], call_to_action_types: [c.cta], ad_formats: ['SINGLE_VIDEO'],
-                        },
-                    });
-                    creative = { medium: 'meta', kind: 'creative', concept: c.key, format: 'video', externalId: d.id, name, status: 'OK', createdAt: new Date().toISOString() };
-                    placements.push(creative);
-                    log(`  meta 영상 크리에이티브 ${c.key} 생성 ${d.id} (영상 ${videos.length})`);
                 }
-                if (!has('ad', c.key, 'video')) {
-                    const name = `${tag} ${c.key} · 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', externalId: d.id, name, status: 'PAUSED', createdAt: new Date().toISOString() });
-                    log(`  meta 영상 광고 ${c.key} 생성 ${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) {
@@ -321,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, format: placements.find((p) => p.externalId === r.ad_id)?.format || 'image', 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, format) => { const existing = placements.find((p) => p.medium === this.medium && p.kind === kind && p.concept === concept && (p.format || 'image') === (format || 'image')); if (existing)
-            return existing; const p = { medium: this.medium, kind, concept, ...(format ? { format } : {}), externalId: `${this.medium}_${kind}_${concept || 'root'}${format === 'video' ? '_video' : ''}_${Math.random().toString(36).slice(2, 8)}`, name: `${tag} ${kind} ${concept || ''}${format === 'video' ? ' · video' : ''}`.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,23 +38,27 @@ export class MockConnector {
         mk('campaign');
         if (this.medium === 'google')
             mk('adgroup');
-        for (const c of input.concepts) {
-            const imgs = input.assets.filter((a) => a.concept === c.key && (a.type || 'image') === 'image');
-            const vids = input.assets.filter((a) => a.concept === c.key && a.type === 'video');
-            if (imgs.length || !vids.length) {
-                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);
-            }
-            // 영상은 메타만(구글 디스플레이는 유튜브 영상만 받는다) · 컨셉별 형태 A/B
-            if (vids.length && this.medium === 'meta') {
-                mk('adset', c.key, 'video');
-                mk('creative', c.key, 'video');
-                mk('ad', c.key, 'video');
             }
-        }
         st.calls.push(`build budget=${input.dailyBudgetMinor} ${input.currency}`);
         this.save(st);
         return { placements, warnings: [] };
@@ -69,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, format: a.format || 'image', 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

@@ -45,6 +45,10 @@ export type MetricRow = {
     name: string;
     concept?: string;
     format?: 'image' | 'video';
+    lang?: string; /** 영상: 재생 수 · 완주(ThruPlay · 15초 또는 끝까지) · 50% 시청 — 훅률·완주율 계산 */
+    videoPlays?: number;
+    thruplays?: number;
+    videoP50?: number;
     spend: number;
     impressions: number;
     clicks: number;
@@ -100,4 +104,27 @@ 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") => string;
+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

@@ -19,4 +19,18 @@ export const utm = (url, medium, campaign, content) => {
 };
 export const nameTag = (slug) => `[adp:${slug}]`;
 /** A/B 키 — 컨셉(+영상이면 _video) · utm_content 와 광고 이름에 같이 쓴다 */
-export const abKey = (concept, format) => (format === 'video' ? `${concept}_video` : concept);
+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/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/factory.d.ts

@@ -1,5 +1,6 @@
-import type { Brief, Concept, CreativeAsset } from '../state.js';
+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;
@@ -7,16 +8,22 @@ export type VideoAsset = CreativeAsset & {
     mime: 'video/mp4';
 };
 export type FactoryLog = (s: string) => void;
-/** 영상용 엔드카드 PNG — 해당 비율의 포스터를 영상 크기로 렌더(기존 satori 트리 재사용) */
-export declare function renderEndCard(dir: string, brief: Brief, concept: Concept, ratio: VideoRatio): Promise<string | null>;
-/** 컨셉의 영상 소재 전부(계획된 비율·길이) — 실패한 건은 건너뛰고 로그 · 성공한 건마다 onAsset */
-export declare function produceConceptVideos(o: {
+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>;
-}): Promise<VideoAsset[]>;
+};
+/** 영상용 엔드카드 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[]>;