adyou 0.7.3 → 0.7.5

package/dist/adapters/google.d.ts

@@ -1,7 +1,12 @@
-import type { GoogleCreds, Placement } from '../core/state.js';
+import { type GoogleCreds, type Market, type Placement } from '../core/state.js';
 import { type AccountInfo, type BuildInput, type BuildResult, type CheckItem, type Connector, type InventoryRow, type MetricRow, type PolicyRow } from './types.js';
 export declare const GEO: Record<string, number>;
 export declare const LANG: Record<string, number>;
+/** 나라 전체(geoTargetConstant) 또는 동네 반경(proximity) — 지역을 고른 나라는 나라 전체를 걸지 않는다(겹치면 나라 전체로 퍼짐) */
+export declare function locationOps(campaign: string, markets: Market[]): {
+    ops: unknown[];
+    warnings: string[];
+};
 export declare class GoogleConnector implements Connector {
     private c;
     medium: "google";
@@ -37,6 +42,11 @@ export declare class GoogleConnector implements Connector {
     }[]>;
     setStatus(placements: Placement[], status: 'ACTIVE' | 'PAUSED'): Promise<void>;
     updateBudget(placements: Placement[], dailyBudgetMinor: number): Promise<void>;
+    /** 지역·종료일 교체 — 캠페인의 위치 조건(LOCATION·PROXIMITY)을 지우고 새로 · 동네 반경이면 「그곳에 있는 사람」만(PRESENCE) */
+    updateTargeting(placements: Placement[], t: {
+        markets: Market[];
+        endDate?: string | null;
+    }): Promise<void>;
     metrics(placements: Placement[], range: {
         since: string;
         until: string;

package/dist/adapters/google.js

@@ -2,11 +2,31 @@
 //   validate_only는 요청 본문 · end_date_time은 23:59:59 · RDA 글자 수는 한글 2자 · CTA는 영문 고정 문구 · 클릭 최대화=target_spend · 로고 1:1/4:1 · 이름 기준 멱등 재실행
 import fs from 'node:fs';
 import crypto from 'node:crypto';
+import { clampRadiusKm } from '../core/state.js';
 import { fit, GOOGLE_CTA, GOOGLE_LIMITS, wlen } from '../core/creatives/specs.js';
 import { MediumError, nameTag, utm } from './types.js';
 const API = 'https://googleads.googleapis.com/v25';
 export const GEO = { KR: 2410, US: 2840, JP: 2392, GB: 2826, DE: 2276, FR: 2250, SG: 2702, TW: 2158, VN: 2704, AU: 2036, CA: 2124, ID: 2360, TH: 2764, IN: 2356, HK: 2344, MY: 2458, PH: 2608, MX: 2484, BR: 2076, ES: 2724, IT: 2380, NL: 2528, AE: 2784, SA: 2682, TR: 2792, PL: 2616, SE: 2752, CH: 2756, NZ: 2554 };
 export const LANG = { ko: 1012, en: 1000, ja: 1005, zh: 1017, 'zh-TW': 1018, de: 1001, fr: 1002, es: 1003, vi: 1040, th: 1044, id: 1025, pt: 1014, it: 1004, nl: 1010, ms: 1102, hi: 1023, ar: 1019, ru: 1031, tr: 1037, pl: 1030, sv: 1015 };
+const hasAreas = (markets) => markets.some((m) => m.areas?.length);
+/** 나라 전체(geoTargetConstant) 또는 동네 반경(proximity) — 지역을 고른 나라는 나라 전체를 걸지 않는다(겹치면 나라 전체로 퍼짐) */
+export function locationOps(campaign, markets) {
+    const ops = [];
+    const warnings = [];
+    for (const m of markets) {
+        if (m.areas?.length) {
+            for (const a of m.areas)
+                ops.push({ create: { campaign, proximity: { geoPoint: { latitudeInMicroDegrees: Math.round(a.lat * 1e6), longitudeInMicroDegrees: Math.round(a.lng * 1e6) }, radius: clampRadiusKm(a.radiusKm), radiusUnits: 'KILOMETERS' } } });
+            continue;
+        }
+        const geo = GEO[m.country.toUpperCase()];
+        if (geo)
+            ops.push({ create: { campaign, location: { geoTargetConstant: `geoTargetConstants/${geo}` } } });
+        else
+            warnings.push(`구글 지역 상수 미등록: ${m.country}`);
+    }
+    return { ops, warnings };
+}
 export class GoogleConnector {
     c;
     medium = 'google';
@@ -176,7 +196,7 @@ export class GoogleConnector {
         const budgetName = `${tag} 일 예산`;
         const amountMicros = String(Math.round(input.dailyBudgetMinor * (acc.currency === 'KRW' || acc.currency === 'JPY' ? 1 : 0.01) * 1_000_000));
         const campName = `${tag} ${input.brief.company} · 디스플레이 · ${input.goal}`;
-        const campaignCreate = (budgetRn) => ({ name: campName, status: 'PAUSED', advertisingChannelType: 'DISPLAY', campaignBudget: budgetRn, targetSpend: {}, networkSettings: { targetContentNetwork: true, targetGoogleSearch: false, targetSearchNetwork: false }, containsEuPoliticalAdvertising: 'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING', ...(input.endDate ? { endDateTime: `${input.endDate} 23:59:59` } : {}) });
+        const campaignCreate = (budgetRn) => ({ name: campName, status: 'PAUSED', advertisingChannelType: 'DISPLAY', campaignBudget: budgetRn, targetSpend: {}, networkSettings: { targetContentNetwork: true, targetGoogleSearch: false, targetSearchNetwork: false }, containsEuPoliticalAdvertising: 'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING', ...(input.endDate ? { endDateTime: `${input.endDate} 23:59:59` } : {}), ...(hasAreas(input.markets) ? { geoTargetTypeSetting: { positiveGeoTargetType: 'PRESENCE' } } : {}) });
         if (V) {
             // 🔴 validate_only는 요청 본문 · 예산 없이 캠페인만 검증하면 REQUIRED 오류 → 임시 id(-1)로 예산+캠페인을 한 번에 검증
             const tmp = `customers/${this.c.customerId}/campaignBudgets/-1`;
@@ -199,13 +219,9 @@ export class GoogleConnector {
                 const d = await this.call('campaigns:mutate', { operations: [{ create: campaignCreate(budgetRn) }] });
                 rn = d.results[0].resourceName;
                 const ops = [];
-                for (const m of input.markets) {
-                    const geo = GEO[m.country.toUpperCase()];
-                    if (geo)
-                        ops.push({ create: { campaign: rn, location: { geoTargetConstant: `geoTargetConstants/${geo}` } } });
-                    else
-                        warnings.push(`구글 지역 상수 미등록: ${m.country}`);
-                }
+                const geo = locationOps(rn, input.markets);
+                ops.push(...geo.ops);
+                warnings.push(...geo.warnings);
                 const langs = [...new Set(input.markets.map((m) => LANG[m.language] || LANG[m.language.split('-')[0]]).filter(Boolean))];
                 for (const l of langs)
                     ops.push({ create: { campaign: rn, language: { languageConstant: `languageConstants/${l}` } } });
@@ -294,6 +310,23 @@ export class GoogleConnector {
             return;
         await this.call('campaignBudgets:mutate', { operations: [{ update: { resourceName: rn, amountMicros: String(Math.round(dailyBudgetMinor * (acc.currency === 'KRW' || acc.currency === 'JPY' ? 1 : 0.01) * 1_000_000)) }, updateMask: 'amount_micros' }] });
     }
+    /** 지역·종료일 교체 — 캠페인의 위치 조건(LOCATION·PROXIMITY)을 지우고 새로 · 동네 반경이면 「그곳에 있는 사람」만(PRESENCE) */
+    async updateTargeting(placements, t) {
+        for (const camp of placements.filter((x) => x.medium === 'google' && x.kind === 'campaign')) {
+            const cur = await this.search(`SELECT campaign_criterion.resource_name FROM campaign_criterion WHERE campaign.resource_name = '${camp.externalId}' AND campaign_criterion.type IN ('LOCATION', 'PROXIMITY') AND campaign_criterion.negative = FALSE`);
+            const geo = locationOps(camp.externalId, t.markets);
+            if (!geo.ops.length)
+                throw new MediumError('google', `구글 지역 조건을 만들 수 없어요: ${geo.warnings.join(' · ')}`);
+            await this.call('campaignCriteria:mutate', { operations: [...cur.map((r) => ({ remove: r.campaignCriterion.resourceName })), ...geo.ops] });
+            const update = { resourceName: camp.externalId, geoTargetTypeSetting: { positiveGeoTargetType: hasAreas(t.markets) ? 'PRESENCE' : 'PRESENCE_OR_INTEREST' } };
+            const mask = ['geo_target_type_setting.positive_geo_target_type'];
+            if (t.endDate !== undefined) {
+                update.endDateTime = t.endDate ? `${t.endDate} 23:59:59` : '2037-12-30 23:59:59';
+                mask.push('end_date_time');
+            }
+            await this.call('campaigns:mutate', { operations: [{ update, updateMask: mask.join(',') }] });
+        }
+    }
     async metrics(placements, range) {
         const camp = placements.find((p) => p.medium === 'google' && p.kind === 'campaign');
         if (!camp)
@@ -307,7 +340,7 @@ export class GoogleConnector {
         if (!ads.length)
             return [];
         const rows = await this.search(`SELECT ad_group_ad.resource_name, ad_group_ad.ad.name, ad_group_ad.policy_summary.approval_status, ad_group_ad.policy_summary.review_status, ad_group_ad.policy_summary.policy_topic_entries FROM ad_group_ad WHERE ad_group_ad.resource_name IN (${ads.map((a) => `'${a.externalId}'`).join(',')})`);
-        return rows.map((r) => ({ id: r.adGroupAd.resourceName, name: r.adGroupAd.ad.name || '', status: `${r.adGroupAd.policySummary?.approvalStatus || ''} · ${r.adGroupAd.policySummary?.reviewStatus || ''}`, issues: (r.adGroupAd.policySummary?.policyTopicEntries || []).map((p) => `${p.type || ''} ${p.topic || ''}`.trim()) }));
+        return rows.map((r) => ({ id: r.adGroupAd.resourceName, name: r.adGroupAd.ad.name || '', status: `${r.adGroupAd.policySummary?.approvalStatus || ''} · ${r.adGroupAd.policySummary?.reviewStatus || ''}`, issues: (r.adGroupAd.policySummary?.policyTopicEntries || []).map((p) => `${p.type || ''} ${p.topic || ''}`.trim()), evidence: [...new Set((r.adGroupAd.policySummary?.policyTopicEntries || []).flatMap((p) => (p.evidences || []).flatMap((e) => [...(e.textList?.texts || []), ...(e.destinationTextList?.destinationTexts || []), ...(e.websiteList?.websites || [])])))].slice(0, 20) }));
     }
     async remove(placements) {
         for (const p of placements.filter((x) => x.medium === 'google' && x.kind === 'campaign'))

package/dist/adapters/meta-targeting.d.ts

@@ -1,3 +1,4 @@
+import { type Area } from '../core/state.js';
 export type AudienceHint = {
     ageRange?: string;
     gender?: string;
@@ -7,11 +8,21 @@ export type TargetingInput = {
     lang?: string;
     audience?: AudienceHint;
     strict?: boolean;
+    areas?: Record<string, Area[]>;
+};
+export type MetaGeo = {
+    countries?: string[];
+    custom_locations?: {
+        latitude: number;
+        longitude: number;
+        radius: number;
+        distance_unit: 'kilometer';
+        name?: string;
+    }[];
+    location_types?: ('home' | 'recent')[];
 };
 export type MetaTargeting = {
-    geo_locations: {
-        countries: string[];
-    };
+    geo_locations: MetaGeo;
     age_min: number;
     age_max?: number;
     genders?: number[];
@@ -35,3 +46,13 @@ export declare function parseAgeRange(s?: string): {
     max?: number;
 } | null;
 export declare function metaTargeting(i: TargetingInput): TargetingResult;
+/** 지역 — 동네 반경(custom_locations)을 고른 나라는 나라 전체를 걸지 않는다(메타는 겹치는 위치를 거절 · 나라를 두면 나라 전체로 퍼짐).
+ *  지역을 고르지 않은 나라는 나라 전체 그대로. areas = 나라 → 그 나라의 동네 반경 */
+export declare function metaGeo(countries: string[], areas?: Record<string, Area[]>): MetaGeo;
+/** 시장 목록에서 나라별 동네 반경만 뽑는다(이 광고세트의 나라만) */
+export declare function areasFor(markets: {
+    country: string;
+    areas?: Area[];
+}[], countries: string[]): Record<string, Area[]>;
+/** 겹치는 원을 하나로 — 이웃한 동네 여러 곳(천천동·율전동…)은 반경이 겹치는데, 메타는 겹치는 위치를 거절할 수 있다. 겹치는 무리는 무리 전체를 덮는 원 하나로(구글은 겹쳐도 돼서 원래대로). */
+export declare function mergeOverlaps(areas: Area[]): Area[];

package/dist/adapters/meta-targeting.js

@@ -1,3 +1,8 @@
+// 메타 광고세트 타겟 빌더(순수 함수 · 단위 테스트) — 밈튜브 광고 하네스(2026-09-22)에서 배운 것을 제품에 옮김.
+//   ① 디아스포라(나라 기본 언어 ≠ 시장 언어 · 예 US:ko)는 `locales` 로 그 언어 사용자만 · ② 대만·싱가포르 포함이면 `regional_regulated_categories` 필수(100/3858498·3858550)
+//   ③ 브리프 audienceProfile(연령대·성별)을 타겟에 연결 — 기본(auto)은 Advantage+ 오디언스 안에서 허용되는 최소 연령만(age_max 금지) ·
+//      strict 는 Advantage+ 를 끄고 연령 상한·성별을 강제(밈튜브가 쓴 방식 · 「밈 만들어 공유할 18~34」처럼 타겟이 좁고 분명할 때).
+import { clampRadiusKm } from '../core/state.js';
 /** 나라 기본 언어 — 시장 언어가 이것과 다르면 「그 나라에 사는 다른 언어 사용자」(디아스포라) 로 보고 locales 를 건다 */
 export const COUNTRY_LANG = {
     KR: 'ko', JP: 'ja', CN: 'zh', TW: 'zh', HK: 'zh', MO: 'zh', SG: 'en', MY: 'ms', US: 'en', GB: 'en', CA: 'en', AU: 'en', NZ: 'en', IE: 'en',
@@ -36,7 +41,10 @@ const clamp = (n) => Math.max(18, Math.min(65, n));
 export function metaTargeting(i) {
     const countries = [...new Set(i.countries.map((c) => c.toUpperCase()))];
     const notes = [];
-    const t = { geo_locations: { countries }, age_min: 18, targeting_automation: { advantage_audience: 1 } };
+    const t = { geo_locations: metaGeo(countries, i.areas), age_min: 18, targeting_automation: { advantage_audience: 1 } };
+    const flat = Object.values(i.areas || {}).flat();
+    if (flat.length)
+        notes.push(`지역: ${flat.map((a) => `${a.label} 반경 ${clampRadiusKm(a.radiusKm)}km`).join(' · ')}(사는 사람·최근 있었던 사람)`);
     const lang = (i.lang || '').split('-')[0];
     // ① 디아스포라 → locales(그 언어를 쓰는 사용자만). 나라 전부가 그 언어를 기본으로 쓰면 걸지 않는다(도달 손실만 있음).
     if (lang && countries.some((c) => (COUNTRY_LANG[c] || '') !== lang) && META_LOCALE[lang]) {
@@ -64,3 +72,44 @@ export function metaTargeting(i) {
         notes.push(`최소 연령 ${age.min}세(Advantage+ 오디언스 · 상한은 매체가 넓힘${age.max ? ` · 브리프 상한 ${age.max}세는 strict 에서만 강제` : ''})`);
     return { targeting: t, regionalCategories, notes };
 }
+/** 지역 — 동네 반경(custom_locations)을 고른 나라는 나라 전체를 걸지 않는다(메타는 겹치는 위치를 거절 · 나라를 두면 나라 전체로 퍼짐).
+ *  지역을 고르지 않은 나라는 나라 전체 그대로. areas = 나라 → 그 나라의 동네 반경 */
+export function metaGeo(countries, areas) {
+    const cs = countries.map((c) => c.toUpperCase());
+    const local = cs.flatMap((c) => areas?.[c] || []);
+    if (!local.length)
+        return { countries: cs };
+    const whole = cs.filter((c) => !areas?.[c]?.length);
+    return { ...(whole.length ? { countries: whole } : {}), custom_locations: mergeOverlaps(local).map((a) => ({ latitude: Math.round(a.lat * 1e6) / 1e6, longitude: Math.round(a.lng * 1e6) / 1e6, radius: clampRadiusKm(a.radiusKm), distance_unit: 'kilometer' })), location_types: ['home', 'recent'] };
+}
+/** 시장 목록에서 나라별 동네 반경만 뽑는다(이 광고세트의 나라만) */
+export function areasFor(markets, countries) {
+    const set = new Set(countries.map((c) => c.toUpperCase()));
+    const out = {};
+    for (const m of markets)
+        if (m.areas?.length && set.has(m.country.toUpperCase()))
+            out[m.country.toUpperCase()] = m.areas;
+    return out;
+}
+/** 겹치는 원을 하나로 — 이웃한 동네 여러 곳(천천동·율전동…)은 반경이 겹치는데, 메타는 겹치는 위치를 거절할 수 있다. 겹치는 무리는 무리 전체를 덮는 원 하나로(구글은 겹쳐도 돼서 원래대로). */
+export function mergeOverlaps(areas) {
+    const km = (a, b) => { const R = 6371, dLat = (b.lat - a.lat) * Math.PI / 180, dLng = (b.lng - a.lng) * Math.PI / 180; const h = Math.sin(dLat / 2) ** 2 + Math.cos(a.lat * Math.PI / 180) * Math.cos(b.lat * Math.PI / 180) * Math.sin(dLng / 2) ** 2; return 2 * R * Math.asin(Math.sqrt(h)); };
+    let groups = areas.map((a) => [a]);
+    for (let changed = true; changed;) {
+        changed = false;
+        outer: for (let i = 0; i < groups.length; i++)
+            for (let j = i + 1; j < groups.length; j++)
+                if (groups[i].some((a) => groups[j].some((b) => km(a, b) < clampRadiusKm(a.radiusKm) + clampRadiusKm(b.radiusKm)))) {
+                    groups[i] = [...groups[i], ...groups[j]];
+                    groups.splice(j, 1);
+                    changed = true;
+                    break outer;
+                }
+    }
+    return groups.map((g) => {
+        if (g.length === 1)
+            return g[0];
+        const c = { lat: g.reduce((n, a) => n + a.lat, 0) / g.length, lng: g.reduce((n, a) => n + a.lng, 0) / g.length };
+        return { label: g.map((a) => a.label).join('+'), ...c, radiusKm: clampRadiusKm(Math.ceil(Math.max(...g.map((a) => km(a, c) + clampRadiusKm(a.radiusKm))))) };
+    });
+}

package/dist/adapters/meta.d.ts

@@ -1,5 +1,5 @@
 import type { MetaCreds } from '../core/state.js';
-import type { Placement } from '../core/state.js';
+import type { Market, Placement } from '../core/state.js';
 import { type AccountInfo, type BuildInput, type BuildResult, type CheckItem, type Connector, type InventoryRow, type MetricRow, type PolicyRow } from './types.js';
 export declare class MetaConnector implements Connector {
     private c;
@@ -26,6 +26,11 @@ export declare class MetaConnector implements Connector {
     }[]>;
     setStatus(placements: Placement[], status: 'ACTIVE' | 'PAUSED'): Promise<void>;
     updateBudget(placements: Placement[], dailyBudgetMinor: number): Promise<void>;
+    /** 지역·종료일 교체 — 광고세트마다 지금 타겟을 읽어 위치(geo_locations)만 바꿔 다시 쓴다(연령·언어·Advantage+ 는 그대로) */
+    updateTargeting(placements: Placement[], t: {
+        markets: Market[];
+        endDate?: string | null;
+    }): Promise<void>;
     metrics(placements: Placement[], range: {
         since: string;
         until: string;

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 { metaTargeting } from './meta-targeting.js';
+import { areasFor, metaGeo, metaTargeting } from './meta-targeting.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'];
@@ -202,7 +202,7 @@ export class MetaConnector {
             log(`  meta 캠페인 ${found ? '재사용' : '생성'} ${id}`);
         }
         // 타겟: 언어 그룹별 — 디아스포라 locales · 대만/싱가포르 규제 카테고리 · 브리프 오디언스(meta-targeting.ts · 밈튜브 하네스 학습 2026-09-23)
-        const targetFor = (g) => metaTargeting({ countries: g.countries, lang: g.lang, audience: input.audience, strict: input.strictAudience });
+        const targetFor = (g) => metaTargeting({ countries: g.countries, lang: g.lang, audience: input.audience, strict: input.strictAudience, areas: areasFor(input.markets, g.countries) });
         /** 광고세트 생성 — locales id 가 거절되면 locales 없이 1회 재시도(도달만 넓어짐 · 생성은 성공) */
         const createAdset = async (body, tr) => {
             const base = { ...body, targeting: tr.targeting, ...(tr.regionalCategories.length ? { regional_regulated_categories: tr.regionalCategories } : {}) };
@@ -346,6 +346,19 @@ export class MetaConnector {
         for (const p of placements.filter((x) => x.medium === 'meta' && x.kind === 'campaign'))
             await this.call('POST', p.externalId, { daily_budget: String(dailyBudgetMinor) });
     }
+    /** 지역·종료일 교체 — 광고세트마다 지금 타겟을 읽어 위치(geo_locations)만 바꿔 다시 쓴다(연령·언어·Advantage+ 는 그대로) */
+    async updateTargeting(placements, t) {
+        for (const s of placements.filter((x) => x.medium === 'meta' && x.kind === 'adset')) {
+            const cur = await this.call('GET', s.externalId, { fields: 'targeting' });
+            // 이 광고세트가 맡은 나라 = 광고세트 이름의 「· KR+US ·」(build 가 붙임) · 못 읽으면 시장 전체
+            const named = (s.name.match(/ · ([A-Z]{2}(?:\+[A-Z]{2})*) · /)?.[1] || '').split('+').filter((c) => t.markets.some((m) => m.country.toUpperCase() === c));
+            const countries = named.length ? named : t.markets.map((m) => m.country.toUpperCase());
+            await this.call('POST', s.externalId, { targeting: { ...cur.targeting, geo_locations: metaGeo(countries, areasFor(t.markets, countries)) } });
+        }
+        if (t.endDate !== undefined)
+            for (const c of placements.filter((x) => x.medium === 'meta' && x.kind === 'campaign'))
+                await this.call('POST', c.externalId, { stop_time: t.endDate ? `${t.endDate}T23:59:00+0900` : 0 });
+    }
     async metrics(placements, range) {
         const camp = placements.find((p) => p.medium === 'meta' && p.kind === 'campaign');
         if (!camp)

package/dist/adapters/mock.d.ts

@@ -19,6 +19,15 @@ export declare class MockConnector implements Connector {
     }[]>;
     setStatus(placements: Placement[], status: 'ACTIVE' | 'PAUSED'): Promise<void>;
     updateBudget(_p: Placement[], b: number): Promise<void>;
+    updateTargeting(_p: Placement[], t: {
+        markets: {
+            country: string;
+            areas?: {
+                label: string;
+            }[];
+        }[];
+        endDate?: string | null;
+    }): Promise<void>;
     metrics(placements: Placement[], range: {
         since: string;
         until: string;

package/dist/adapters/mock.js

@@ -67,7 +67,10 @@ export class MockConnector {
     async setStatus(placements, status) { for (const p of placements.filter((x) => x.medium === this.medium))
         p.status = status; this.rec(`status ${status}`); }
     async updateBudget(_p, b) { this.rec(`budget ${b}`); }
+    async updateTargeting(_p, t) { this.rec(`targeting ${t.markets.map((m) => m.areas?.length ? m.areas.map((a) => a.label).join('+') : m.country).join(',')}${t.endDate !== undefined ? ` end=${t.endDate || 'none'}` : ''}`); }
     async metrics(placements, range) {
+        if (process.env.ADPILOT_MOCK_NO_METRICS === '1')
+            return []; // 시험: 노출이 멈춘 광고 재현
         const ads = placements.filter((p) => p.medium === this.medium && p.kind === 'ad');
         const out = [];
         const d0 = new Date(range.since);
@@ -76,6 +79,17 @@ export class MockConnector {
             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: [] })); }
+    async policy(placements) {
+        // 시험용 검수 상태 주입 — ADPILOT_MOCK_POLICY='{"google":{"status":"APPROVED_LIMITED · REVIEWED","issues":["FULLY_LIMITED TICKET_RESALE"]}}'
+        // skip: 이 글자가 이름에 든 광고는 주입하지 않음(예: "_f" → AI 가 고친 광고는 승인) · evidence: 문제 삼은 문구
+        let o;
+        try {
+            o = JSON.parse(process.env.ADPILOT_MOCK_POLICY || '{}')[this.medium];
+        }
+        catch {
+            o = undefined;
+        }
+        return placements.filter((p) => p.medium === this.medium && p.kind === 'ad').map((p) => { const hit = o && !(o.skip && `${p.name} ${p.concept || ''}`.includes(o.skip)); return { id: p.externalId, name: p.name, status: hit ? o.status || 'APPROVED' : 'APPROVED', issues: hit ? o.issues || [] : [], ...(hit && o.evidence ? { evidence: o.evidence } : {}) }; });
+    }
     async remove(placements) { const st = this.load(); const ids = new Set(placements.map((p) => p.externalId)); st.objects = st.objects.filter((o) => !ids.has(o.externalId)); st.calls.push('remove'); this.save(st); }
 }

package/dist/adapters/types.d.ts

@@ -66,7 +66,8 @@ export type PolicyRow = {
     id: string;
     name: string;
     status: string;
-    issues: string[];
+    issues: string[]; /** 매체가 문제 삼은 실제 문구(구글 policy evidence) — AI 자동 수정이 정확히 그 표현만 고치게 */
+    evidence?: string[];
 };
 export type InventoryRow = {
     level: 'campaign' | 'adset' | 'ad';
@@ -101,6 +102,11 @@ export interface Connector {
     }): Promise<MetricRow[]>;
     policy(placements: Placement[]): Promise<PolicyRow[]>;
     remove?(placements: Placement[]): Promise<void>;
+    /** 이미 만든 광고의 지역(나라·동네 반경)·종료일을 바꾼다 — 다시 만들지 않고 캠페인/광고세트 타겟만 교체 */
+    updateTargeting?(placements: Placement[], t: {
+        markets: Market[];
+        endDate?: string | null;
+    }): Promise<void>;
 }
 export declare class MediumError extends Error {
     medium: Medium;

package/dist/core/report.d.ts

@@ -13,6 +13,10 @@ export type ReportInput = {
         status: string;
         issues: string[];
     }[]>;
+    /** 사장님이 하셔야 할 일(호출자가 매체 상태로 정해 넘김) — 보고서 끝에 그대로 붙는다. LLM 이 지어내지 않게 */
+    todo?: string[];
+    /** 매체 검수 상태를 사람 말로(호출자가 판정) — LLM 은 이 문장만 옮긴다(「노출이 덜 퍼졌을 수도」 같은 추측 금지) */
+    reviewNotes?: string[];
 };
 export declare function tableOf(rows: MetricRow[]): {
     concept: string;

package/dist/core/report.js

@@ -19,14 +19,20 @@ export async function makeReport(inp) {
             totals.conv += r.conversions;
         }
     const goalWord = { traffic: '방문', lead: '문의', signup: '가입', purchase: '구매' }[inp.project.budget.goal];
-    const facts = { period: inp.range, conceptNames: Object.fromEntries((inp.project.concepts || []).map((c) => [c.key, `${c.name} — ${c.headlines[0]}`])), company: inp.project.brief?.company, goal: goalWord, totals, byMedium: tables, decisions: inp.decisions.slice(-20), policy: inp.policy, plan: inp.project.plan?.explain, status: inp.project.status };
+    const todo = inp.todo?.filter(Boolean) || [];
+    const facts = { period: inp.range, conceptNames: Object.fromEntries((inp.project.concepts || []).map((c) => [c.key, `${c.name} — ${c.headlines[0]}`])), company: inp.project.brief?.company, goal: goalWord, totals, byMedium: tables, decisions: inp.decisions.slice(-20).map((d) => ({ ...d, who: { user: '사장님이 직접', rule: '자동 규칙', llm: 'AI(사장님 지시)', system: '시스템' }[d.by] || d.by })), review: inp.reviewNotes?.length ? inp.reviewNotes : inp.policy, plan: inp.project.plan?.explain, status: inp.project.status, hasTodo: todo.length > 0, autoRules: '자동으로 하는 일은 이것뿐: 한 시간마다 숫자 확인 · 시작 48시간 뒤부터 노출 2,000 이상 광고끼리 비교해 1.8배 나쁜 광고 끄기 · 하루 예산 ±20% · 잔액 이틀치 미만이면 멈춤. 문구 수정·재검수 신청·매체 인증 신청은 자동으로 하지 않는다.' };
     let text;
     if (aiAvailable()) {
-        text = await complete({ maxTokens: 1500, system: `너는 광고 운영 담당자다. 광고를 모르는 사장님께 이번 기간 결과를 한국어 존댓말(해요체)로 6~10문장 보고한다. 광고 용어(CTR·CPA·노출·DCO)는 쓰지 말고 사람 말(본 사람·클릭한 사람·1명 데려오는 데 든 돈)로 바꾼다. 숫자는 주어진 것만(만들지 않는다). 구성: ① 얼마 써서 무슨 결과 ② 어느 매체·어느 방향(컨셉)이 잘 됐고 무엇을 줄였는지 ③ 자동 조치가 있었으면 한 줄 ④ 검수·정책 문제가 있으면 한 줄 ⑤ 다음 주 계획 한 줄. 지표가 없으면 「아직 노출 전·검수 중」을 있는 그대로.`, user: JSON.stringify(facts) });
+        text = await complete({ maxTokens: 1500, system: `너는 ADYou(광고 대행 서비스)의 광고 운영 담당자다. 「저희」는 ADYou 이고 광고주는 「사장님」이다 — 광고주 회사를 「저희」라고 부르지 않는다. 광고를 모르는 사장님께 이번 기간 결과를 한국어 존댓말(해요체)로 6~10문장 보고한다. 광고 용어(CTR·CPA·노출·DCO)는 쓰지 말고 사람 말(본 사람·클릭한 사람·1명 데려오는 데 든 돈)로 바꾼다. 숫자는 주어진 것만(만들지 않는다). 구성: ① 얼마 써서 무슨 결과 ② 어느 매체·어느 방향(컨셉)이 잘 됐고 무엇을 줄였는지 ③ 자동 조치가 있었으면 한 줄(decisions 의 who 를 그대로 — 사장님이 직접 한 일을 「담당자」라고 하지 않는다) ④ 검수 문제는 review 문장을 그대로 옮긴다(추측·완곡 금지 · 광고가 막혔으면 「막혀서 보이지 않는다」고 분명히) ⑤ 다음 주 한 줄 — 자동으로 하는 일은 autoRules 를 나열하지 말고 짧게(예: 「성과는 계속 한 시간마다 확인해요」), 그 밖의 일(문구 수정·재검수·인증)을 우리가 하겠다고 약속하지 않는다. hasTodo 이면 「사장님이 하실 일은 아래에 정리했어요」로 끝내고 할 일 내용·제목·구분선(---)은 쓰지 않는다(코드가 붙인다). 지표가 없으면 「아직 노출 전·검수 중」을 있는 그대로.`, user: JSON.stringify(facts) });
     }
     else {
         text = [`${inp.range.since}~${inp.range.until} 동안 ${fmtKrw(totals.spend)} 을 써서 ${totals.imp.toLocaleString()}명에게 보였고 ${totals.clicks.toLocaleString()}명이 클릭했어요${totals.conv ? `. ${goalWord} ${totals.conv}건 (1건당 ${fmtKrw(totals.spend / totals.conv)})` : ''}.`, ...media.map((m) => { const best = [...tables[m]].sort((a, b) => b.ctr - a.ctr)[0]; return best ? `${m === 'meta' ? '메타' : '구글'}에선 「${best.concept}」 방향이 가장 반응이 좋았어요(클릭률 ${(best.ctr * 100).toFixed(2)}%).` : `${m}: 아직 지표가 없어요.`; })].join(' ');
     }
+    // LLM 이 할 일을 따로 또 쓰면(구분선·「하실 일」 제목) 잘라 낸다 — 할 일은 코드가 정한 목록 하나만
+    if (todo.length)
+        text = text.split(/\n\s*-{3,}\s*\n|\n\s*\**\s*(?:\[?지금 )?(?:사장님이 )?하실 일\s*\]?\**\s*[:：]/)[0];
+    if (todo.length)
+        text = `${text.trim()}\n\n[지금 하실 일]\n${todo.map((t, i) => `${i + 1}. ${t}`).join('\n')}`;
     const md = [`# ${inp.project.brief?.company || inp.project.slug} 광고 보고 (${inp.range.since} ~ ${inp.range.until})`, '', text, '', ...media.flatMap((m) => [`## ${m === 'meta' ? 'Meta' : 'Google'}`, '| 방향 | 쓴 돈 | 본 사람 | 클릭 | 클릭률 | ' + goalWord + ' | 1건당 |', '|---|---|---|---|---|---|---|', ...tables[m].map((r) => `| ${r.concept} | ${fmtKrw(r.spendKrw)} | ${r.impressions.toLocaleString()} | ${r.clicks.toLocaleString()} | ${(r.ctr * 100).toFixed(2)}% | ${r.conversions} | ${r.cpaKrw ? fmtKrw(r.cpaKrw) : '-'} |`), ''])].join('\n');
     const esc = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;');
     const html = `<!doctype html><html lang="ko"><head><meta charset="utf-8"><title>${esc(inp.project.brief?.company || inp.project.slug)} 광고 보고</title><style>body{font-family:Pretendard,'Apple SD Gothic Neo',sans-serif;max-width:820px;margin:40px auto;padding:0 20px;color:#0b1526;line-height:1.6}h1{font-size:24px}table{border-collapse:collapse;width:100%;font-size:14px}td,th{border-bottom:1px solid #e3e8ef;padding:8px 10px;text-align:right}th:first-child,td:first-child{text-align:left}.lead{font-size:17px;background:#f4f7fb;border-radius:12px;padding:18px 20px}</style></head><body><h1>${esc(inp.project.brief?.company || inp.project.slug)} 광고 보고 <small style="color:#6b7a90;font-size:14px">${inp.range.since} ~ ${inp.range.until}</small></h1><div class="lead">${esc(text).replace(/\n/g, '<br>')}</div>${media.map((m) => `<h2>${m === 'meta' ? 'Meta' : 'Google'}</h2><table><tr><th>방향</th><th>쓴 돈</th><th>본 사람</th><th>클릭</th><th>클릭률</th><th>${goalWord}</th><th>1건당</th></tr>${tables[m].map((r) => `<tr><td>${esc(String(r.concept))}</td><td>${fmtKrw(r.spendKrw)}</td><td>${r.impressions.toLocaleString()}</td><td>${r.clicks.toLocaleString()}</td><td>${(r.ctr * 100).toFixed(2)}%</td><td>${r.conversions}</td><td>${r.cpaKrw ? fmtKrw(r.cpaKrw) : '-'}</td></tr>`).join('')}</table>`).join('')}</body></html>`;

package/dist/core/state.d.ts

@@ -39,10 +39,21 @@ export type Config = {
     lastProject?: string;
 };
 export type Goal = 'traffic' | 'lead' | 'signup' | 'purchase';
+/** 지역 좁히기 — 나라 안의 동네·구·시를 중심점 + 반경(km)으로. 구글 proximity · 메타 custom_locations 에 같은 값이 그대로 간다(매체별 지역 사전 대신 좌표 한 표현) */
+export type Area = {
+    label: string;
+    lat: number;
+    lng: number;
+    radiusKm: number;
+};
+/** areas 가 있으면 그 나라는 나라 전체가 아니라 그 지역(들)에만 — 「사는 사람(최근 있었던 사람)」 기준 */
 export type Market = {
     country: string;
     language: string;
+    areas?: Area[];
 };
+/** 매체 반경 허용 범위(구글 proximity · 메타 custom_locations 둘 다 1~80km 안) */
+export declare const clampRadiusKm: (km: number) => number;
 export type Brief = {
     url: string;
     company: string;

package/dist/core/state.js

@@ -9,6 +9,8 @@ import os from 'node:os';
 import path from 'node:path';
 export const HOME = process.env.ADPILOT_HOME || path.join(os.homedir(), '.adpilot');
 export const PROJECTS = path.join(HOME, 'projects');
+/** 매체 반경 허용 범위(구글 proximity · 메타 custom_locations 둘 다 1~80km 안) */
+export const clampRadiusKm = (km) => Math.max(1, Math.min(80, Math.round((Number(km) || 3) * 10) / 10));
 function ensureDir(p) { fs.mkdirSync(p, { recursive: true, mode: 0o700 }); }
 function readJson(file, fallback) {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adyou",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "description": "ADYou — 대행사 없이, 당신이 직접. 사이트 주소 하나로 광고 소재·매체 등록·자동 운영·보고까지: AI 광고 자율주행 CLI + MCP 서버(Meta·Google · 생성은 항상 PAUSED · 승인 뒤 시작)",
   "type": "module",
   "license": "MIT",