marketer-localize-campaign

キャンペーンのローカライズ

完成したキャンペーンを、翻訳済みコピー、文化に適したビジュアル、AR／HE 向けの右から左へのレイアウト処理、テキスト拡張に耐えるレイアウトを備えた形で、複数の市場向けに展開します。一貫性（市場ごとに同じキャンペーンのアイデンティティを維持）とスピード（ロケールごとに一括処理）を実現します。

使用するタイミング

• ある市場で公開済みのキャンペーンがあり、さらに 3 つ以上のロケールで展開する必要がある場合。
• 「DE、FR、JP、BR、ES 向けにローカライズ」／「市場ごとにクリエイティブを翻訳・調整」／「AR 向けの RTL 版」。
• マスターキャンペーンに、画像内テキスト、人物、またはロケールごとに差し替えが必要な文化的モチーフが含まれている場合。
• 純粋なテキスト翻訳（LLM を直接使用してください）や、新規キャンペーンの作成（まず marketer-campaign-kit を使用してから、このスキルを使用してください）には使用しないでください。

前提条件

ブリーフに記載がない場合は、最初に確認してください（1 つのメッセージにまとめてください）。

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. ロケールは並列ではなく、順番に実行します。 次のロケールに着手する前に、1 つのロケールの出力を最初から最後まで確認してください。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（サブコマンド）	被写体はピクセル単位で同一のまま、ロケールに適したシーンにします

IDはgen-ai modelsで確認してください。

手順

• テキストは実際に長くなります。 ドイツ語は英語より30％長く、フランス語は20％長くなります。日本語／中国語は30％短いものの、文字が密になります。レンダリング前に、テキスト用の安全領域に25〜30％の余裕を持たせてください。
• 広告コピーを自動翻訳しないでください。 承認はコンプライアンス担当が行います。人がレビューした翻訳を用意してからレンダリングしてください。
• RTLロケールではレイアウトを反転させます。 アラビア語／ヘブライ語では、メインビジュアルの構図を反転し、見出しを右から読めるようにする必要があります。プロンプトで明示してください。
• 文化に適した顔や設定を使います。 東京ではベルリンのシーンは違和感があります。マスターに人物がいる場合は、早い段階で決めてください。維持する（Nano Banana Proでアイデンティティの一貫性を保つ）か、市場ごとに入れ替えるかを選びます。
• 画像上の非ラテン文字テキストに使える信頼性の高い選択肢はideogram-v3だけです。 ほかのモデルでは日本語／アラビア語／韓国語が文字化けします。テキストを含むアセットにはこれを使ってください。
• ロケールは一度に1つずつ、最初から最後までレビューします。 5つのロケールを並行して進めると、クレジットを5倍消費するまでプロンプトの不具合に気づけません。
• ネイティブスピーカーによるレビューは必須です。 LLMは文化的なニュアンスを見落とします。公開前に、すべてのロケールをその市場の人に確認してもらってください。
• ファイル名にロケールコードを含めると、広告プラットフォームに直接アップロードできます。 launch_de-DE_9x16.webpは、Meta／Google／TikTokのCSVインポーターで正しく解析されます。
• 多言語ナレーションでは音声IDを統一してください。 市場間で同じ音声を使うことで、ブランドの一貫性を保てます。ジョブごとではなく、defaultsでvoiceを設定してください。

注意点

• DE／RU／FIでテキストが安全領域からはみ出します。 マスターのレイアウトでコピーの拡張を考慮していませんでした。ローカライズ前に25〜30％の余白を確保してください。
• 日本語／アラビア語／韓国語のテキストが文字化けします。 モデルの選択が誤っています。画像上の非ラテン文字テキストには、flux／recraftではなくideogram-v3を使ってください。
• RTLレイアウトが反転されていません。 アラビア語のユーザーには、見出しの向きもメインビジュアルの構図も不自然に映ります。反転するよう明示すれば解決できます。
• 文化的に配慮を欠いた画像になります。 イスラム教徒が多数を占める市場でクリスマスをテーマにしたビジュアルを使う、東南アジアで左手のジェスチャーを使う、といった事態を避けるため、市場ごとに文化的なレビューを行ってください。
• LLMを使ってプロンプト内で翻訳しています。 広告コピーはコンプライアンス確認が必要です。プロンプトの途中でモデルに「この見出しをドイツ語に翻訳して」と指示しないでください。人がレビューした翻訳を使います。
• 5つのロケールすべてを最初から並行して進めています。 1つのプロンプトの不具合で、5つのロケール分のクレジットが無駄になります。順番に進め、DEをレビューしてからFRを開始してください。
• ナレーションのロケール間で音声が一貫していません。 ロケールごとに異なるvoice IDを使うとブランドの一貫性が損なわれます。すべてのTTSジョブで同じ音声IDを設定してください。
• ネイティブスピーカーによるレビューを省略しています。 「前回、モデルはドイツ語をうまく処理できた」という考えが、誤訳を公開する原因になります。

検証

gen-ai whoamiを実行して認証を確認し、その後、失敗したコマンドを--debug付きで再実行してください。

コストと所要時間

5つのロケールで9点のアセットをローカライズする場合の概算（レンダリング合計45点）：

アセットタイプ	ロケールあたりの数	モデル	1点あたりのクレジット	ロケールあたり	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 で全面的に再生成すると、画像のクレジットはおよそ2倍になります。クレジットを消費する前に、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 テストで勝者が決まった後、勝者の広告をローカライズにかけてください