楽天RPP除外CSVビルダー

概要

楽天RPPでは、特定の商品・キーワードを広告から除外するためのCSVをRMSにアップロードします。本スキルは除外条件（在庫切れ／低粗利／商標問題／薬機景表抵触／実績不振など）を整理し、楽天仕様のCSV（コントロールカラム n/d/u）を生成します。

CSVは Shift_JIS（CP932）／CR+LF／BOMなしという楽天独自仕様で、文字コードや改行コードのミスでアップロードが失敗するケースが多発します。本スキルはフォーマット検証と差分管理（既存除外との重複防止）まで含めて設計します。

最重要原則

「除外理由を必ずreason列に書く／n/d/uを正しく使い分ける／適用前にバックアップ／文字コードはShift_JIS+CR+LF」。除外理由が記録されないと「なぜ外したか」が忘れ去られ、再運用時に混乱する。

知識ベース

楽天RPP除外CSVの基本仕様：

項目	内容
文字コード	Shift_JIS（CP932）／BOMなし
改行コード	CR+LF
拡張子	.csv
コントロールカラム	n（新規追加）／d（削除＝再配信対象に戻す）／u（更新）
商品管理番号	32byte以内、半角英数

詳細：

• CSVフォーマット詳細（必須カラム・サンプル）：references/csv-format.md
• 除外判定ロジック（在庫・粗利・商標・実績）：references/exclusion-logic.md
• 差分管理（既存除外との突合・履歴）：references/diff-management.md
• 完成CSV例：references/examples.md

除外の主要カテゴリ：

カテゴリ	例	判定
在庫切れ	残0、入荷未定	一時除外（d で復帰）
低粗利	理論CPC<20円	恒久除外
商標問題	競合ブランド名KW	恒久除外
薬機景表抵触	「シミに効く」「最安」	恒久除外
実績不振	30日CV0かつクリック30+	一時除外
終売／製造中止	該当商品	恒久除外

処理フロー

Step 1：除外条件の整理

ユーザーから除外したい条件を確認（不足時は仮定）：

• 除外対象（商品／キーワード／両方）
• 除外理由カテゴリ
• 既存の除外リスト有無
• 適用タイミング

Step 2：対象抽出

実績CSV／在庫CSV／キーワードリストから条件に合う対象を抽出。それぞれの抽出ロジックは references/exclusion-logic.md 参照。

Step 3：差分管理

既存除外リストとの突合：

• 既に除外済み → スキップ（重複登録防止）
• 状態変更（復帰／更新）→ d または u
• 新規 → n

詳細：references/diff-management.md

Step 4：CSV生成

楽天仕様で生成：

control,item_id,reason
n,ABCD123,在庫切れ_補充未定
n,EFGH456,粗利率8%_広告非効率
n,IJKL789,終売

キーワード除外の場合：

control,keyword,reason
n,競合ブランド名,商標問題
n,シミに効く,薬機法抵触
n,最安,景表法抵触

Step 5：フォーマット検証

• 文字コード：Shift_JIS（CP932）／BOMなし
• 改行：CR+LF
• 商品管理番号：32byte以内、半角英数のみ
• 空行・全角空白の混入なし

Step 6：適用前確認

• バックアップ（既存リスト＋今回CSV）を保管
• 大量変更時は段階的適用を提案
• 適用後の確認項目（数時間で反映）

代表例

例：在庫切れ商品＋商標KW除外（10件）

control,item_id,reason
n,SHOP-A-001,在庫切れ_2026-05-20再入荷
n,SHOP-A-015,終売
n,SHOP-B-003,粗利率10%_広告非効率
d,SHOP-A-099,補充済み_配信再開
u,SHOP-C-007,理由更新_季節終了

control,keyword,reason
n,ティファール,競合ブランド_商標問題
n,デロンギ,競合ブランド_商標問題
n,シミに効く,薬機法抵触
n,最安値,景表法抵触
n,No.1,景表法_根拠不明

完全な例集：references/examples.md

出力フォーマット

# RPP除外CSV生成：[案件名]

## 1. 除外条件の整理
- 対象：商品／キーワード／両方
- 適用日時：
- 既存除外リストの有無：
- 主要除外理由：

## 2. 除外対象一覧

### 商品除外
| 商品管理番号 | 商品名 | 除外理由 | コントロール（n/d/u） |
|---|---|---|---|

### キーワード除外
| キーワード | 除外理由 | コントロール |
|---|---|---|

## 3. 差分管理
- 既存除外と重複：◯件 → スキップ
- 状態変更：◯件
- 新規：◯件

## 4. 生成CSV

### 除外商品CSV（Shift_JIS / CR+LF / BOMなし）
```csv
control,item_id,reason
n,XXX,YYY
```

### 除外キーワードCSV
```csv
control,keyword,reason
n,XXX,YYY
```

## 5. フォーマット検証
- [ ] Shift_JIS（CP932）
- [ ] CR+LF
- [ ] BOMなし
- [ ] 商品管理番号32byte以内・半角英数
- [ ] 空行・全角空白なし

## 6. 適用手順
1. 既存除外リストをバックアップ
2. 本CSVをRMS RPP管理画面からアップロード
3. プレビュー・差分確認
4. 適用
5. 数時間後に動作確認

## 7. 復帰計画（一時除外の場合）
| 商品/KW | 復帰条件 | 想定タイミング |
|---|---|---|

## 8. 最終チェック
- [ ] reason列全件記入
- [ ] 文字コード／改行確認
- [ ] バックアップ保管
- [ ] 復帰計画あり（一時除外の場合）

品質ゲート

• すべての行に reason 列が埋まっているか（空白禁止）
• n／d／u が用途通り使われているか（新規追加にdを使わない等）
• 文字コードがShift_JIS（CP932）、改行がCR+LF、BOMなし
• 商品管理番号が32byte以内・半角英数のみ
• 既存除外との重複登録がないか
• 一時除外には復帰条件と想定タイミングを記載しているか
• バックアップ手順を出力に含めているか

エッジケース

• 大量除外（1,000件超）：段階的適用を推奨（一気に適用しない）
• 季節商品の一時除外：復帰条件を「◯月◯日に d で復帰」と明示
• 競合ブランド名KW：商標問題で恒久除外、社内記録のみ
• 薬機景表KW：再運用時も恒久、リストから外さない
• CSV文字化け：Excel保存時のUTF-8混入に注意、テキストエディタでShift_JIS指定

注意事項

• 楽天RPPのCSV仕様は管理画面で随時改定されるため、最新フォーマットはRMSヘルプで確認
• 適用前に既存除外リストを必ずバックアップ（適用後ロールバックのため）
• 商品管理番号や除外理由に顧客情報・取引先情報を含めない
• 商標問題のあるKWは社内記録のみ、商品ページや公開資料に記載しない
• CSVをExcelで開くと文字化け・先頭0落ち・改行コード変換が起きるため、テキストエディタ推奨

references/ 一覧

• references/csv-format.md：CSVフォーマット詳細とサンプル
• references/exclusion-logic.md：除外判定ロジック（カテゴリ別）
• references/diff-management.md：差分管理と履歴管理
• references/examples.md：完成CSV例集

参考公式情報源

• RMSのRPP管理画面ヘルプ「除外商品／除外キーワードCSV」
• 楽天市場 出店者向けマニュアル「RPP広告」