guide

メルマガ制作ガイド

NOAHL 向けの制作フローです。 Claude Code で新しいセッションを開いてメルマガを依頼するとき、どのような流れで制作されるかをまとめています。

大原則

実績データを参照せずに作るなら AI である意味がない。
全ての提案・件名案・テンプレ選定・商品配置は過去データの根拠を提示してから行う。

✅必須 4 項目push 前に絶対揃える

品番

manageNumber

ユーザー提示

割引率

クーポン適用後 %

ユーザー提示

件名

subject

Claude 提案 → 確認

配信日時

scheduledAt

Claude 提案 → 確認

※ 3 と 4 は確認なしで push しない

🚀生成フロー

楽天 RMS から商品・クーポン情報を取得

品番（manageNumber）を元に 楽天 RMS の ItemAPI から商品データ（商品名・価格・カラー別画像・在庫等）を取得。

並行して Coupon API から該当商品に紐づく発行中クーポンを取得（割引率・期間・対象品番・getCoupon URL）。割引率や期間で絞り込み可能。

認証情報（serviceSecret / licenseKey）は Vercel 環境変数に保存しているため、Claude は直接叩かず以下の優先順でアクセス：

① キャッシュ: 過去取得済みならファイル読込で完了
② Vercel API: RMS API のラッパー経由
③ GitHub Actions プロキシ: 通信制限環境の保険

直近イベント確認

events.json で告知解禁日チェック。解禁前の配信は楽天規約違反。

過去配信実績の確認

outputs.json で同商品・同カテゴリの過去配信、直近テンプレ使用履歴を確認。

3.5

過去データから学習（最重要）

AURL別クリック数 — 同品番の過去配置と順位 / クーポンURLの最有効配置 / 0クリック商品の特定
BAI 分析 — strengths を踏襲、weaknesses を回避、nextActions を実行
C件名パターン — 開封率 TOP3 の形式を踏襲、40%未満形式は採用しない
Dテンプレ選定 — 同イベント×同規模で score 4+ を出した過去テンプレを優先
E商品数構成 — 単品(1-2) / 中規模(3-5) / 大規模(6-10) で過去転換率の高い構成
FHTML 構造 — 売上/通・転換率 TOP5/BOTTOM5 の html を Read してセクション順序・CTA配置・コピートーンを抽出

効率化: 全件は読まない。成績で絞り込んでから上位下位 3〜5 件だけ Read。

提案（メイン1案 + 代替2案）

過去データを必ず引用してから提示。「過去 TOP の構造に倣う」「BOTTOM のアンチパターンを回避」など根拠付きで。

件名・配信日時を確認

件名は過去パターン参考に 1〜2 案 / 配信日時は直近イベント・告知解禁・通常運用時間を踏まえ提案

生成 → push → 自動マージ

outputs.json 追記 → branch push → draft PR → CI green → squash merge → Production → URL 報告

⚙️HTML 制約（楽天 R-Mail 互換）

✅使う

・ <table> レイアウト
・ <font color size>
・ <b> <strike> <br>
・ inline style (padding / line-height)
・ [[BUTTON:coupon|...]] マクロ
・楽天 cabinet 画像のみ

❌使わない

・ <style> ブロック / class
・ <a> への style 属性
・ CSS Grid / Flexbox / display:flex
・ background-image / @media / Webフォント
・ inline で <a><font><b> 組み（マクロ必須）
・ placehold.jp / Unsplash / AI生成画像

🌿NOAHL ブランド絶対ルール

○ 守る

・ブランド色を固定（メルマガごとに変えない）
・件名は title フィールドに入れる（subject は作らない）
・件名形式: 【タグ】メイン訴求＊サブ訴求
・ナチュラル・柔らかい・カフェのような落ち着き

× 禁止

・冒頭の「○○○様」（RMS で差し込み）
・ NG ワード: 激安 / 格安 / 在庫処分 / お買い得 / 半額以下
・量産系: 大量入荷 / お一人様何点まで / ファミリーセール
・メルマガごとに色変更（差別化は写真・コピー・構図で）

🎟️クーポン使用時の必須

クーポン情報は Step 1 で 楽天 RMS Coupon API から自動取得済み（割引率・期間・対象品番・getCoupon URL）。Claude はその中から条件に合うクーポンを選んで本文に埋め込む。

outputs[].coupons[] を必ず追加label（RMS設定名そのまま）/ url / rate / startDate / endDate / note
商品ブロックに ◯◯%OFF を明示
CTA はマクロ使用[[BUTTON:coupon|<URL>|<ラベル>]]

📨生成完了報告（必須項目）

1ID とタイトル
2Web URL
https://mail-magazine.vercel.app/outputs/<id>/
3使用テンプレ・商品・イベント設定の要約
4次のアクション（楽天 RMS にコピペ等）

🛒チャネル別の違い（楽天 / futureshop）

項目	楽天 (NOAHL)	futureshop (NOAHL)
商品情報取得	楽天 RMS API `/api/rakuten/noahl/<品番>`	BigQuery (raw_official) `/api/futureshop/noahl-fs/<品番>`
クーポン	楽天クーポン取得 URL（getCoupon?getkey=...）	futureshop クーポンコード / カート適用 URL
配信実績	楽天 R-Mail メトリクス（開封/クリック/送客/転換/お気に入り） Tampermonkey で取り込み	GA4 Data API（セッション/エンゲージ/購入/売上） `/api/ga4/sync` で取り込み
配信費用	¥1 / 通（無料枠あり） → 広告比率カードで監視	無料 → 広告比率カード非表示
/results/ 表示	開封/クリック/送客/転換/お気に入り等の R-Mail カラム	セッション/エンゲージ率/購入/転換率/新規率等の GA4 カラム
UTM 自動付与	なし（楽天内クリック計測）	`utm_source=mailmagazine` 等を全リンクに自動付与
禁止表現	両チャネル共通: 激安・格安・在庫処分・大量入荷等の量産/価格売りワード（NOAHL ブランド規定）

ブランド切替はサイドバー / ヘッダーのブランドセレクタから。ブランドごとに templates / outputs が独立。

🔗UTM 自動付与と GA4 突合

メルマガ内の全リンクに utm_source / utm_medium / utm_campaign が自動付与されます。

・utm_source = ブランド config の tracking.utm.source（NOAHL は mailmagazine）
・utm_medium = email
・utm_campaign = output.id（メルマガ ID。例: fs-181-20260513）
・ボタンマクロ展開時のみ utm_content=button-coupon 等の content も付与

既に utm_source= が付いている URL・mailto: / # アンカー等は変更しません。

GA4 突合 (/api/ga4/sync) は以下の優先度でメルマガと売上をマッチします：

utm_campaign 直接マッチ: GA4 セッションの sessionCampaignName が fs- 始まりのとき、同名 ID の outputs を直接更新。 matchType=campaign
日付窓フォールバック: campaign 不明（(not set) 等）の場合、配信日 ±2日でセッションを合算しメルマガに按分。 matchType=date-window

UTM 自動付与により今後の配信は campaign マッチが基本になり、クロスデバイス・流入経路の精度が上がります。既存配信（UTM なし）は引き続き date-window マッチで按分されます。

🔁自動マージルール

メルマガ生成 PR は CI green になったら 確認なしで即 squash merge→ Production 反映。

データ削除を伴う系の PR は必ず確認を取る。競合発生時は Claude が解決してから再マージ。