marketer-localize-campaign

本地化营销活动

将一个已完成的营销活动改编到 N 个市场——翻译文案、采用符合当地文化的视觉元素、处理从右到左的排版（阿拉伯语／希伯来语），并确保版式能适应文本扩展。兼顾一致性（每个市场保持相同的营销活动形象）和速度（每种语言区域一次批量处理）。

适用场景

• 用户已在一个市场发布营销活动，需要推广到另外 3 个或更多语言区域。
• “在 DE、FR、JP、BR、ES 推广”／“按市场翻译并调整创意素材”／“制作 AR 的 RTL 版本”。
• 主营销活动包含需要按语言区域替换的图片文字、人物或文化元素。
• 不要用于纯文本翻译（直接使用大模型），也不要用于全新营销活动（先使用 marketer-campaign-kit，再使用此技能）。

前置条件

如果需求说明未涵盖，请事先询问（合并为一条消息）：

1. 主营销活动素材——已批准创意素材的路径／URL。哪些内容已定稿（主视觉、广告变体、邮件、LP）？
2. 目标语言区域——语言 + 地区（例如 de-DE、fr-FR、ja-JP、ar-SA、pt-BR）。地区会影响文化适配。
3. 已翻译的文案——是否已完成？如果已完成，请粘贴文案。如果尚未完成，请注明由哪位文案撰写人／供应商负责（不要自动翻译广告文案——这会带来合规风险）。
4. 需要替换的文化元素——人物（面孔／族裔）、场景（室内风格、街景）、道具（食物、手势）？如果主视觉中有特定人物，是否要保留，还是按语言区域替换？
5. 涉及的 RTL 语言区域——阿拉伯语、希伯来语、波斯语？版式需要镜像，文字从右向左排列。
6. 交付物命名——广告平台上传工具要求使用 {campaign}_{locale}_{size}.webp 格式。

未经审核人员审阅，绝不要自动翻译广告文案——法律／合规团队负责签核。

运行方法

1. 盘点主素材。 列出所有需要本地化的创意素材（主视觉、6 个广告变体、邮件、LP 主视觉 = 每个语言区域 9 个 × 5 个语言区域 = 45 个素材）。
2. 生成前收集每个语言区域的译文。 不要使用英文占位文案批量运行，否则必须全部重新渲染。
3. 为每项素材选择调整策略：
   • 仅更改文字（干净背景上的标题）：使用 ideogram-v3，提供译文并沿用相同视觉素材。
   • 原位替换元素（人物、场景）：使用编辑模型（qwen-image-edit-plus、flux-kontext-pro），并提供原始图片 + 针对特定语言区域的提示词。
   • 完全重新生成（复杂的文化元素替换）：根据原始提示词 + 语言区域指导重新生成，并将原图作为 image 参考，以保留构图。
4. 编写每个语言区域的清单。 每个语言区域使用一份清单，便于规范命名，并行处理多个语言区域时也不会冲突。
5. 估算每个语言区域的成本。

   gen-ai batch run localize-de.json --dry-run
   

6. 按顺序运行各语言区域，不要并行处理。 完整审核一个语言区域的输出后，再启动下一个——在 DE 发现文化不匹配，就能先修正提示词，避免 JP、FR 和 BR 沿用错误设置。

   gen-ai batch run localize-de.json -c 4 -o ./out/de-DE
   

7. 请每个语言区域的母语人士审核。 每个语言区域都必须审核，不得例外。尤其要留意 JP（文字渲染）、AR（RTL + 文字），以及有专属国家经理的市场。
8. 整理并交付。 每个语言区域单独建文件夹，文件名包含语言区域代码，并归档 results.json 以备审计。

快速参考

每个语言区域使用一份清单，让文件更整洁。{locale} 和 {name} 占位符支持跨语言区域复用。

{
  "defaults": {
    "model": "qwen-image-edit-plus",
    "imageUrls": ["https://cdn-pipeline-output.picsart.com/.../master-hero.webp"],
    "negativePrompt": "low quality, watermark, culturally inappropriate"
  },
  "jobs": [
    { "id": "hero_de-DE",        "prompt": "adapt hero for German market — preserve composition, swap setting to central-European urban, replace overlay text with: \"Jetzt entdecken\"",                     "aspectRatio": "16:9" },
    { "id": "ad_9x16_de-DE",     "prompt": "adapt ad for German market — keep product/subject, swap scene to Berlin street, overlay headline: \"Jetzt entdecken — 20% Rabatt\"",                          "aspectRatio": "9:16" },
    { "id": "ad_1x1_de-DE",      "prompt": "adapt ad for German market — clean background, German headline: \"Jetzt entdecken\", CTA: \"Mehr erfahren\"",                                                  "aspectRatio": "1:1"  },
    { "id": "email_de-DE",       "prompt": "email header for German launch — German copy on-canvas: \"Jetzt entdecken\"",                                                                                   "aspectRatio": "3:1"  },
    { "id": "lp_hero_de-DE",     "prompt": "LP hero for German market — same product, German subtitle: \"Entdecken Sie die neue Kollektion\"",                                                              "aspectRatio": "16:9" }
  ]
}

对于 RTL 语言区域（AR、HE），请在提示词中明确要求镜像布局：“从右向左的布局，标题从右侧开始阅读，主视觉构图镜像”。

对于视频营销活动的配音本地化，请按每个语言区域搭配 gen-ai generate -m eleven-multilingual-v2；在不同语言区域保持 voice ID 一致，以延续品牌形象。

快速参考

子任务	模型	原因
在干净背景上原位替换文本	ideogram-v3	唯一能可靠地以多种文字系统（拉丁文、西里尔文、日文、阿拉伯文）渲染清晰文本的模型
替换图案／场景，同时保留主体	qwen-image-edit-plus	擅长原位编辑——保留构图并替换场景
结合参考图进行指令编辑	flux-kontext-pro	对编辑提示词的遵循度高，适合需要精细修改的情况
完全重新生成并提供文化指导	flux-2-pro	照片级写实效果最佳；将原图作为 image 参考，以保留构图
替换面孔／人物并保持身份一致	gemini-3-pro-image (Nano Banana Pro)	最擅长在多次渲染中持续保留或有意替换主体
多语言配音	eleven-multilingual-v2	在不同地区保持声音一致——在 defaults 中设置 voice ID
仅替换背景	gen-ai change-bg（子命令）	主体像素完全一致，场景符合当地文化

使用 gen-ai models 确认 ID。

流程

• 文本扩展确实存在。 德语比英语长 30%，法语长 20%，日语／中文短 30%，但字符密度更高。渲染前，请在文本安全区域预留 25-30% 的空间。
• 切勿自动翻译广告文案。 合规团队负责审批。先收集经人工审核的译文，再进行渲染。
• 从右向左书写的语言需要镜像布局。 阿拉伯语／希伯来语需要翻转主视觉构图，并让标题从右向左阅读。请在提示词中明确说明。
• 人物和场景应符合当地文化。 柏林场景放在东京会显得格格不入。如果主视觉中有人物，请尽早决定是保留人物（通过 Nano Banana Pro 保持身份一致）还是按市场替换。
• ideogram-v3 是唯一能可靠渲染非拉丁文字叠加文本的选项。 其他模型会将日语／阿拉伯语／韩语渲染成乱码。任何包含文字的素材都应使用它。
• 一次处理一个地区，并进行端到端审核。 并行处理 5 个地区，会让提示词问题一直到你花掉 5 倍额度后才显现。
• 母语人士审核必不可少。 大模型会遗漏文化细微差异。发布前，每个地区都必须由当地人士审核。
• 文件名中的地区代码可用于直接上传到广告平台。 launch_de-DE_9x16.webp 能被 Meta / Google / TikTok 的 CSV 导入器正确解析。
• 在多语言配音中保持 voice ID 一致。 所有市场使用相同声音 = 保持品牌连贯性。在 defaults 中设置 voice，不要按任务单独设置。

常见问题

• 德语／俄语／芬兰语文本超出安全区域。 主版布局没有考虑文案扩展——本地化前请预留 25-30% 的边距。
• 日语／阿拉伯语／韩语文本渲染成乱码。 模型选错了。任何非拉丁文字叠加文本都应使用 ideogram-v3，而不是 flux/recraft。
• 从右向左书写的布局未镜像。 阿拉伯语用户看到的标题方向错误，主视觉构图也显得不自然。明确要求镜像即可解决。
• 图像不符合当地文化。 在穆斯林占多数的市场使用圣诞主题视觉，或在东南亚使用左手手势——应针对每个市场进行文化审核。
• 在提示词中让大模型翻译。 广告文案需经过合规审核；不要让模型在提示词中途“将此标题翻译成德语”。请使用经人工审核的译文。
• 一开始就并行处理所有 5 个地区。 一个提示词问题就会浪费 5 个地区的额度。按顺序处理；审核完德语后，再启动法语。
• 配音在不同地区间声音不一致。 各地区使用不同的 voice ID 会破坏品牌连贯性——所有 TTS 任务都应使用同一个声音 ID。
• 跳过母语人士审核。 “上次模型处理德语效果不错”正是发布错误译文的原因。

验证

运行 gen-ai whoami 确认身份验证，然后使用 --debug 重新运行失败的命令。

成本与时间

将包含 9 个素材的营销活动本地化为 5 种语言（共渲染 45 次）的粗略估算：

素材类型	每种语言的数量	模型	每次所需积分	每种语言	5 种语言
主视觉 + 广告 + 邮件 + LP（替换主题图案）	5	qwen-image-edit-plus	~2	10	50
带文字的素材（标题、CTA）	4	ideogram-v3	~3	12	60
图像小计	9			~22	~110 积分
配音（如果是视频营销活动）	每种语言 1 个	eleven-multilingual-v2	~1-3	~2	~10
总计					~120 积分
总耗时（按语言依次处理，每种语言内并发数为 4）				~3 分钟	~15 分钟

使用 flux-2-pro 完全重新生成，图像积分大约会翻倍。花费前，请使用 gen-ai batch run localize-{locale}.json --dry-run 明确估算。

另请参阅

• gen-ai-use/SKILL.md — 完整 CLI 参考（标志、模型目录、身份验证、TTS 模型）
• gen-ai-workflows/SKILL.md — 通用多步骤模式
• gen-ai-batch/SKILL.md — 清单格式、占位符、并发
• workflows/marketer-campaign-kit/SKILL.md — 先运行此项以生成营销活动主版本
• workflows/marketer-ad-variant-factory/SKILL.md — A/B 测试选出胜出版本后，再对其进行本地化