localization-strategy

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Strategies: Localization

策略：本地化

Guides localization strategy for AI/SaaS products expanding into global markets. Covers i18n implementation, translation, pricing, and marketing adaptation--not just text translation.

When invoking: On first use, if helpful, open with 1-2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.

为面向全球市场扩张的AI/SaaS产品提供本地化策略指导，覆盖i18n落地、翻译、定价、营销适配等全流程，而不仅仅是文本翻译。

调用时：首次使用时如果合适，可以先用1-2句话介绍本技能覆盖的范围和价值，再输出核心内容。后续调用或者用户要求跳过介绍时，直接输出核心内容即可。

Initial Assessment

初始评估

Check for product marketing context first: If

.claude/product-marketing-context.md

.cursor/product-marketing-context.md

exists, read it for product, target markets, and brand.

Identify:

Target markets: Priority languages/regions
Product type: SaaS, AI tool, content
Technical stack: Next.js, React, etc.

首先检查产品营销上下文：如果存在

.claude/product-marketing-context.md

或

.cursor/product-marketing-context.md

文件，读取其中的产品、目标市场、品牌相关信息。

识别以下信息：

目标市场：优先覆盖的语言/区域
产品类型：SaaS、AI工具、内容产品
技术栈：Next.js、React等

Localization vs. Translation

本地化 vs 翻译

Localization includes:

Product: Features, UI/UX, cultural adaptation
Pricing: True localization (adjust by market) vs. cosmetic (currency only)
Marketing: Channels, content, user personas
Compliance: GDPR, local regulations

本地化包含：

产品层面：功能、UI/UX、文化适配
定价层面：真正的本地化（按市场调整价格）vs 表面适配（仅转换货币）
营销层面：渠道、内容、用户画像
合规层面：GDPR、当地法规

Technical (i18n)

技术（i18n）

URL Structure

URL结构

Choose one; be consistent:

Option	Example	Pros / Cons
Subdirectories	`/en/` , `/de/` , `/zh/`	Recommended; maintains domain authority
Subdomains	`de.example.com`	Separate hosting; less authority transfer
ccTLD	`example.de`	Strongest geo signal; costly

Use subdirectories, not subdomains for i18n; subdomains transfer less authority.
Default locale: Root path for default (e.g.
```
/
```
for English); prefix for others (
```
/zh/
```
,
```
/de/
```
).
IETF BCP 47: Use valid codes (
```
en
```
,
```
en-US
```
,
```
zh-CN
```
,
```
pt-BR
```
). Same language, different country (e.g.
```
de-DE
```
vs
```
de-AT
```
) needs ≥20% content difference for Google to differentiate.

选择一种方案并保持一致：

选项	示例	优缺点
子目录	`/en/` 、 `/de/` 、 `/zh/`	推荐使用；可保留域名权重
子域名	`de.example.com`	需要独立托管；权重传递能力较弱
国家顶级域名（ccTLD）	`example.de`	地理信号最强；成本较高

i18n优先使用子目录而非子域名，子域名传递的权重更低。
默认locale：根路径对应默认语言（例如
```
/
```
对应英文），其他语言加路径前缀（
```
/zh/
```
、
```
/de/
```
）。
IETF BCP 47：使用合法编码（
```
en
```
、
```
en-US
```
、
```
zh-CN
```
、
```
pt-BR
```
）。同语言不同国家的版本（例如
```
de-DE
```
和
```
de-AT
```
）需要至少20%的内容差异，Google才会将其区分开。

i18n SEO Principles

i18n SEO原则

No hardcoded strings: All user-facing text via translation dictionary.
Symmetric alternates: Every locale page lists ALL other versions (including self-reference). ~75% of international sites have hreflang errors; missing reciprocal links is the most common.
x-default: Always include for fallback when user language/location doesn't match any version.
Canonical alignment: Canonical must match the same regional version hreflang refers to; misalignment causes Google to ignore hreflang.
Full SEO coverage: Metadata, OpenGraph, JSON-LD (
```
inLanguage
```
), and sitemap all locale-aware.

不要硬编码字符串：所有用户可见文本都通过翻译字典管理。
对称替代链接：每个locale版本的页面都要列出所有其他语言版本（包括自身）。约75%的国际化网站存在hreflang错误，最常见的就是缺失双向回指链接。
x-default：始终配置该fallback项，用于用户语言/位置不匹配任何现有版本的场景。
Canonical对齐：Canonical标签必须与hreflang指向的对应区域版本一致，对齐错误会导致Google忽略hreflang配置。
完整SEO覆盖：元数据、OpenGraph、JSON-LD（
```
inLanguage
```
字段）、站点地图都要支持locale感知。

Common Issues (Next.js + next-intl)

常见问题（Next.js + next-intl）

Issue	Solution
Route conflict	`generateStaticParams()` ; validate locale
Auto redirect	`localeDetection: false`
Middleware	Apply only to prefixed paths (e.g. `/zh` )
URL duplication	Manual switcher; `getLocalizedHref()`

问题	解决方案
路由冲突	调用 `generateStaticParams()` ；校验locale
自动重定向	配置 `localeDetection: false`
Middleware逻辑	仅对带前缀的路径生效（例如 `/zh` ）
URL重复	手动切换器；使用 `getLocalizedHref()`

SEO

Hreflang on all language versions; self-reference + symmetric annotations.
Language switcher: Use
```
<a>
```
not
```
<button>
```
; links in initial HTML.
Canonical: Handle multi-domain if using local TLDs; align with hreflang.
SPAs: Use sitemap-based hreflang as backup when HTML head is JS-rendered.

所有语言版本都配置Hreflang；包含自身引用+对称标注。
语言切换器：使用
```
<a>
```
标签而非
```
<button>
```
；链接要出现在初始HTML中。
Canonical标签：如果使用本地顶级域名，要处理多域名场景；与hreflang对齐。
SPA：当HTML头部由JS渲染时，使用基于站点地图的hreflang作为备份。

Keyword Research by Market

按市场开展关键词研究

Market	Tool
Russia	Yandex Wordstat
Korea	Naver DataLab
Global	Google Keyword Planner, SEO tools

Consider: Cultural expressions, search habits, competition, long-tail in small markets.

市场	工具
俄罗斯	Yandex Wordstat
韩国	Naver DataLab
全球	Google Keyword Planner、各类SEO工具

考虑因素：文化表达、搜索习惯、竞争情况、小市场的长尾关键词。

Terminology & Translation

术语与翻译

Translation workflow, glossary, style guide: See translation for full workflow
Avoid machine translation for product/marketing: See translation (Human vs MT)

翻译工作流、术语表、风格指南：完整工作流参考translation模块。
产品/营销内容避免使用机器翻译：参考translation模块（人工翻译vs机器翻译）。

Pricing Strategies

定价策略

Strategy	Use
True localization	Adjust price by purchasing power
Cosmetic	Display currency only; same price
Tools	Parity Deals, Chargebee

策略	适用场景
真正本地化定价	根据购买力调整价格
表面适配定价	仅展示对应货币，价格保持一致
工具	Parity Deals、Chargebee

i18n SEO Checklist (New Feature / New Locale)

i18n SEO检查清单（新功能/新Locale）

New feature with i18n

支持i18n的新功能

Add translation keys to all locale JSON files. Use translation for glossary, style guide, and translation workflow.
Add
```
generateMetadata()
```
with alternates (hreflang) per page.
Add JSON-LD with
```
inLanguage
```
and translated fields.
Add page to sitemap with hreflang annotations.
Set
```
lang
```
attribute on
```
<html>
```
; UTF-8 encoding.

向所有locale的JSON文件添加翻译key。使用translation模块获取术语表、风格指南和翻译工作流支持。
每个页面配置
```
generateMetadata()
```
，包含替代链接（hreflang）。
添加带
```
inLanguage
```
字段和翻译后字段的JSON-LD。
将页面添加到带hreflang标注的站点地图中。
为
```
<html>
```
标签设置
```
lang
```
属性；使用UTF-8编码。

New locale

新Locale上线

Add locale code to config; create
```
{code}.json
```
dictionary.
Register in sitemap locale list; regenerate.
Add OpenGraph
```
locale
```
and
```
alternateLocale
```
.
Ensure all alternates are symmetric (every page lists all versions).

在配置中添加locale编码；创建
```
{code}.json
```
翻译字典。
注册到站点地图的locale列表中；重新生成站点地图。
添加OpenGraph的
```
locale
```
和
```
alternateLocale
```
配置。
确保所有替代链接是对称的（每个页面列出所有版本）。

Multilingual Risks

多语言风险

Batch publishing: Too many translated pages at once can trigger de-indexing or thin-content penalties.
Mitigation: Roll out slowly; ensure content is product/industry relevant; avoid Wikipedia-like breadth; monitor indexing in GSC.

批量发布：一次性上线太多翻译页面可能触发去索引或薄内容惩罚。
缓解方案：缓慢逐步上线；确保内容与产品/行业相关；避免类维基百科的宽泛内容；在GSC中监控索引情况。

Avoid

注意规避

IP-based redirects that override user preferences.
Machine translation without localization for product/marketing (see translation).
Missing reciprocal hreflang between language versions.
Canonical tags that conflict with hreflang.

覆盖用户偏好的IP-based重定向。
产品/营销内容仅做机器翻译未做本地化（参考translation模块）。
语言版本之间缺失双向hreflang回指。
Canonical标签与hreflang冲突。

Output Format

输出格式

Market priority
i18n approach
Keyword strategy per market
Pricing recommendation
Technical checklist
i18n SEO checklist (if applicable)

市场优先级
i18n落地方案
各市场的关键词策略
定价建议
技术检查清单
i18n SEO检查清单（如适用）