naming-rules

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Naming Rules

Naming Rules

Интерактивный помощник для настройки правил именования Campaign/AdSet/Ad и структуры аккаунта.

用于配置Campaign/AdSet/Ad命名规则和账户结构的交互式助手。

Твои задачи

你的任务

  1. Определить аккаунт для настройки
  2. Задать вопросы о структуре и нейминге
  3. Собрать существующие кампании из аккаунта
  4. Сгенерировать файл правил
    config/naming/{account}_naming.md
  5. Обновить бриф аккаунта (добавить ссылку на naming rules)

  1. 确定要配置的账户
  2. 询问结构和命名相关问题
  3. 收集账户中现有广告系列
  4. 生成规则文件
    config/naming/{account}_naming.md
  5. 更新账户简报(添加命名规则的链接)

Что создаётся в результате

输出产物

.claude/ads-agent/config/
└── naming/
    └── {account}_naming.md   ← правила нейминга для аккаунта

.claude/ads-agent/config/
└── naming/
    └── {account}_naming.md   ← 账户命名规则文件

Workflow (7 шагов)

Workflow (7个步骤)

Шаг 0: Определи аккаунт

步骤 0: 确定账户

Для какого аккаунта настраиваем правила нейминга?
Проверь список в
.claude/ads-agent/config/ad_accounts.md
. Прочитай бриф аккаунта из
.claude/ads-agent/config/briefs/{account}.md
.

我们要为哪个账户配置命名规则?
请检查
.claude/ads-agent/config/ad_accounts.md
中的账户列表。 从
.claude/ads-agent/config/briefs/{account}.md
读取账户简报。

Шаг 1: Структура кампаний (3 вопроса)

步骤 1: 广告系列结构(3个问题)

Q1: Что означает Campaign в твоём аккаунте?
1. Направление/услуга (Имплантация, Виниры, Гнатология)
2. Цель рекламы (WhatsApp, Lead Forms, Traffic)
3. Аудитория (Холодная, Ретаргетинг, LAL)
4. Другое (опиши)
Q2: Когда создаётся НОВАЯ кампания?
1. Новое направление/услуга
2. Новая цель (WhatsApp → Lead Forms)
3. Новый тип аудитории
4. Никогда — всё в одной кампании
5. Комбинация (опиши)
Q3: Шаблон названия Campaign:
Примеры:
1. {Направление}
2. {Направление}_{Цель}
3. {Цель}_{Направление}
4. {Направление} | {Цель} | {Дата}
5. Свой формат (опиши)

Доступные переменные:
- {Направление} — название услуги/продукта
- {Цель} — WhatsApp, Lead Forms, Traffic, etc.
- {Аудитория} — Cold, Retargeting, LAL
- {Дата} — дата создания

Q1: 你账户中的Campaign代表什么含义?
1. 业务方向/服务(种植牙、牙贴面、齿科咬合学)
2. 广告目标(WhatsApp、线索表单、流量)
3. 受众(冷流量、重定向、相似受众LAL)
4. 其他(请描述)
Q2: 什么时候需要创建新的Campaign?
1. 新的业务方向/服务
2. 新的目标(WhatsApp → 线索表单)
3. 新的受众类型
4. 从不 —— 所有内容都放在一个Campaign中
5. 组合条件(请描述)
Q3: Campaign命名模板:
示例:
1. {业务方向}
2. {业务方向}_{目标}
3. {目标}_{业务方向}
4. {业务方向} | {目标} | {日期}
5. 自定义格式(请描述)

可用变量:
- {业务方向} —— 服务/产品名称
- {目标} —— WhatsApp、线索表单、流量等
- {受众} —— 冷流量、重定向、LAL
- {日期} —— 创建日期

Шаг 2: Структура AdSets (3 вопроса)

步骤 2: AdSet结构(3个问题)

Q4: Что означает AdSet в твоём аккаунте?
1. Один креатив = один AdSet
2. Один таргетинг = один AdSet (несколько креативов внутри)
3. Комбинация креатив + таргетинг
4. Тест гипотезы (A/B тест)
5. Другое (опиши)
Q5: Когда создаётся НОВЫЙ AdSet?
Выбери всё что применимо:
[ ] Новый креатив
[ ] Новый таргетинг (возраст, гео, интересы)
[ ] Изменение бюджета
[ ] Тест гипотезы
[ ] Другое (опиши)
Q6: Шаблон названия AdSet:
Примеры:
1. {Направление}_{Возраст}_{Гео}
2. {Creative}_{Дата}
3. {Направление}_{Creative}
4. {Направление}_{Аудитория}_{Бюджет}
5. Свой формат (опиши)

Доступные переменные:
- {Направление} — название услуги/продукта
- {Creative} — название креатива
- {Возраст} — диапазон (25-45)
- {Гео} — город/страна
- {Аудитория} — тип аудитории
- {Бюджет} — дневной бюджет
- {Дата} — дата создания

Q4: 你账户中的AdSet代表什么含义?
1. 一个创意 = 一个AdSet
2. 一个定向 = 一个AdSet(内部可放多个创意)
3. 创意 + 定向的组合
4. 假设测试(A/B测试)
5. 其他(请描述)
Q5: 什么时候需要创建新的AdSet?
选择所有适用项:
[ ] 新创意
[ ] 新定向(年龄、地域、兴趣)
[ ] 预算调整
[ ] 假设测试
[ ] 其他(请描述)
Q6: AdSet命名模板:
示例:
1. {业务方向}_{年龄}_{地域}
2. {Creative}_{日期}
3. {业务方向}_{Creative}
4. {业务方向}_{受众}_{预算}
5. 自定义格式(请描述)

可用变量:
- {业务方向} —— 服务/产品名称
- {Creative} —— 创意名称
- {年龄} —— 年龄区间 (25-45)
- {地域} —— 城市/国家
- {受众} —— 受众类型
- {预算} —— 日预算
- {日期} —— 创建日期

Шаг 3: Названия объявлений (3 вопроса)

步骤 3: 广告命名(3个问题)

Q7: Что ОБЯЗАТЕЛЬНО должно быть в названии Ad?
Выбери всё что нужно для группировки статистики:
[ ] Название креатива (РЕКОМЕНДУЕТСЯ — для группировки)
[ ] Направление
[ ] Формат (video/image/carousel)
[ ] Дата создания
[ ] Версия (v1, v2)
Q8: Шаблон названия Ad:
Примеры:
1. {creative_name}
2. {Направление} | {creative_name}
3. {Направление} | {creative_name} | {format}
4. {creative_name} | {format} | {date}
5. Свой формат (опиши)

Доступные переменные:
- {creative_name} — уникальное имя креатива
- {Направление} — название услуги
- {format} — video/image/carousel
- {date} — дата создания (YYYY-MM-DD)
- {version} — версия (v1, v2)
Q9: Как формировать creative_name?
1. По первым словам текста: "восстановим_за_4"
2. По названию файла: "SAK.mov"
3. Описательно: "девушка_улыбка_зелёный"
4. Код + описание: "CR001_имплант_видео"
5. Свой подход (опиши)

Q7: Ad的名称中必须包含哪些内容?
选择所有统计分组所需的内容:
[ ] 创意名称(推荐 —— 用于数据分组)
[ ] 业务方向
[ ] 格式(视频/图片/轮播)
[ ] 创建日期
[ ] 版本(v1、v2)
Q8: Ad命名模板:
示例:
1. {creative_name}
2. {业务方向} | {creative_name}
3. {业务方向} | {creative_name} | {format}
4. {creative_name} | {format} | {date}
5. 自定义格式(请描述)

可用变量:
- {creative_name} —— 创意唯一标识
- {业务方向} —— 服务名称
- {format} —— 视频/图片/轮播
- {date} —— 创建日期 (YYYY-MM-DD)
- {version} —— 版本(v1、v2)
Q9: 如何生成creative_name?
1. 按文案首词: "4天修复"
2. 按文件名: "SAK.mov"
3. 描述性命名: "微笑女孩_绿色背景"
4. 编码+描述: "CR001_种植牙_视频"
5. 自定义方式(请描述)

Шаг 4: Существующие кампании

步骤 4: 现有广告系列

Q10: Загрузить существующие кампании из аккаунта?
Если да — вызови
get_campaigns(account_id, limit=50)
и покажи список:
Найдены кампании:

| # | Название | Campaign ID | Статус |
|---|----------|-------------|--------|
| 1 | Имплантация | 123456789 | ACTIVE |
| 2 | Виниры | 234567890 | ACTIVE |
| 3 | Гнатология | 345678901 | PAUSED |

Какие из них активно используются? (укажи номера или "все")
Для каких направлений эти кампании?
Собери маппинг: Направление → Campaign ID

Q10: 是否要加载账户中的现有广告系列?
如果是 —— 调用
get_campaigns(account_id, limit=50)
并展示列表:
找到以下广告系列:

| # | 名称 | Campaign ID | 状态 |
|---|----------|-------------|--------|
| 1 | 种植牙 | 123456789 | 启用 |
| 2 | 牙贴面 | 234567890 | 启用 |
| 3 | 齿科咬合学 | 345678901 | 暂停 |

哪些是正在使用的?(填写序号或“全部”)
这些广告系列对应哪些业务方向?
收集映射关系: 业务方向 → Campaign ID

Шаг 5: Валидация

步骤 5: 规则校验

Покажи сводку всех правил:
📋 ПРАВИЛА НЕЙМИНГА — {account_name}
展示所有规则的汇总:
📋 命名规则 — {账户名称}

Структура

结构

Campaign = {что означает}

Campaign = {含义}

  • Новая когда: {условия}
  • Шаблон:
    {template}
  • Пример:
    {example}
  • 新建触发条件: {条件}
  • 模板:
    {template}
  • 示例:
    {example}

AdSet = {что означает}

AdSet = {含义}

  • Новый когда: {условия}
  • Шаблон:
    {template}
  • Пример:
    {example}
  • 新建触发条件: {条件}
  • 模板:
    {template}
  • 示例:
    {example}

Ad

Ad

  • Шаблон:
    {template}
  • Пример:
    {example}
  • creative_name: {как формируется}
  • 模板:
    {template}
  • 示例:
    {example}
  • creative_name: {生成规则}

Существующие кампании

现有广告系列

НаправлениеCampaign IDИспользовать
{campaigns_table}

Всё верно? (да / нет, изменить)

---
业务方向Campaign ID是否使用
{campaigns_table}

是否全部正确?(是 / 否,需要修改)

---

Шаг 6: Генерация файла

步骤 6: 生成文件

Создай директорию если не существует:
.claude/ads-agent/config/naming/
Создай файл
{account}_naming.md
:
markdown
undefined
如果目录不存在请先创建:
.claude/ads-agent/config/naming/
创建文件
{account}_naming.md
:
markdown
undefined

{Account Name} — Naming Rules

{账户名称} — 命名规则

Создан через /naming-rules {date}

通过 /naming-rules 创建于 {date}

Структура аккаунта

账户结构

Campaign

Campaign

Означает: {campaign_meaning}
Создавать новую когда:
  • {condition_1}
  • {condition_2}
Шаблон:
{campaign_template}
Примеры:
  • Имплантация
  • Виниры

含义: {campaign_meaning}
新建触发条件:
  • {condition_1}
  • {condition_2}
模板:
{campaign_template}
示例:
  • 种植牙
  • 牙贴面

AdSet

AdSet

Означает: {adset_meaning}
Создавать новый когда:
  • {condition_1}
  • {condition_2}
Шаблон:
{adset_template}
Примеры:
  • Имплантация_восстановим_за_4_$10
  • Виниры_биркин_$15

含义: {adset_meaning}
新建触发条件:
  • {condition_1}
  • {condition_2}
模板:
{adset_template}
示例:
  • 种植牙_4天修复_$10
  • 牙贴面_铂金款_$15

Ad

Ad

Шаблон:
{ad_template}
Обязательные элементы:
  • {element_1}
  • {element_2}
Примеры:
  • Имплантация | восстановим_за_4 | video
  • Виниры | биркин | video

模板:
{ad_template}
必填元素:
  • {element_1}
  • {element_2}
示例:
  • 种植牙 | 4天修复 | 视频
  • 牙贴面 | 铂金款 | 视频

Creative Name

Creative Name

Формируется: {creative_name_rule}
Примеры:
  • восстановим_за_4
  • биркин
  • швейцарская_точность

生成规则: {creative_name_rule}
示例:
  • 4天修复
  • 铂金款
  • 瑞士精度

Существующие кампании

现有广告系列

НаправлениеCampaign IDЦельСтатус
{campaigns_rows}

业务方向Campaign ID目标状态
{campaigns_rows}

Сценарии использования

使用场景

Новый креатив для существующего направления

为现有业务方向新增创意

  1. Campaign: использовать существующую (
    {direction}
    {campaign_id}
    )
  2. AdSet: создать по шаблону
    {adset_example}
  3. Ad: создать по шаблону
    {ad_example}
  1. Campaign: 使用现有Campaign(
    {业务方向}
    {campaign_id}
  2. AdSet: 按照模板创建
    {adset_example}
  3. Ad: 按照模板创建
    {ad_example}

Новое направление

新增业务方向

  1. Campaign: создать
    {campaign_example}
  2. AdSet: создать
    {adset_example}
  3. Ad: создать
    {ad_example}
  1. Campaign: 创建
    {campaign_example}
  2. AdSet: 创建
    {adset_example}
  3. Ad: 创建
    {ad_example}

Тест нового таргетинга

测试新定向

  1. Campaign: использовать существующую
  2. AdSet: создать новый с другим таргетингом
  3. Ad: использовать существующие креативы

  1. Campaign: 使用现有Campaign
  2. AdSet: 创建新AdSet并设置对应定向
  3. Ad: 使用现有创意

История изменений

变更历史

ДатаИзменение
{date}Создан через /naming-rules

---
日期变更内容
{date}通过 /naming-rules 创建

---

Шаг 7: Обновление брифа

步骤 7: 更新简报

Добавь в бриф аккаунта (
briefs/{account}.md
) ссылку на naming rules:
markdown
undefined
在账户简报(
briefs/{account}.md
)中添加命名规则的链接:
markdown
undefined

Naming Rules

命名规则

См. naming/{account}_naming.md

---
参考 naming/{account}_naming.md

---

Интеграция с другими скиллами

与其他技能的集成

Как другие скиллы используют naming rules:

其他技能如何使用命名规则:

/campaign-manager
:
1. Читает config/naming/{account}_naming.md
2. При создании Campaign/AdSet/Ad применяет шаблоны
3. Проверяет существующие кампании перед созданием новой
/ads-optimizer
:
1. Читает naming rules
2. При создании нового adset применяет шаблон
3. Использует creative_name для логирования
/ads-reporter
:
1. Группирует статистику по creative_name
2. Извлекает creative_name из названия Ad по шаблону
/creative-analyzer
:
1. Парсит creative_name из названий объявлений
2. Группирует метрики по креативам

/campaign-manager
:
1. 读取 config/naming/{account}_naming.md
2. 创建Campaign/AdSet/Ad时应用对应模板
3. 创建新Campaign前检查是否已有重复
/ads-optimizer
:
1. 读取命名规则
2. 创建新AdSet时应用模板
3. 使用creative_name进行日志记录
/ads-reporter
:
1. 按creative_name分组统计数据
2. 根据模板从Ad名称中提取creative_name
/creative-analyzer
:
1. 从广告名称中解析creative_name
2. 按创意分组统计指标

Валидация названий

名称校验

При создании проверяй:
python
undefined
创建时请检查:
python
undefined

Campaign

Campaign

assert "{Направление}" in campaign_name or custom_format_valid
assert "{业务方向}" in campaign_name or custom_format_valid

AdSet

AdSet

assert "{Creative}" in adset_name or "{Направление}" in adset_name
assert "{Creative}" in adset_name or "{业务方向}" in adset_name

Ad

Ad

assert "{creative_name}" in ad_name # ОБЯЗАТЕЛЬНО для группировки

---
assert "{creative_name}" in ad_name # 统计分组必填

---

Частые ошибки

常见错误

ОшибкаРешение
Нет creative_name в AdДобавь — иначе невозможно группировать статистику
Дубликат CampaignПроверь существующие перед созданием
Разные форматы названийПридерживайся шаблона из naming rules

错误解决方案
Ad名称中没有creative_name请添加 —— 否则无法进行统计分组
Campaign重复创建前请检查现有Campaign
命名格式不统一请遵循命名规则中的模板

После настройки

配置完成后

Чек-лист:
  • Файл создан в
    config/naming/{account}_naming.md
  • Бриф обновлён (добавлена ссылка)
  • Существующие кампании замаплены на направления
  • Примеры названий валидны
检查清单:
  • 文件已创建在
    config/naming/{account}_naming.md
  • 简报已更新(添加了链接)
  • 现有广告系列已映射到对应业务方向
  • 命名示例符合规则