用語の整理

• refererId：トラッキング用に整形・保管されるクエリ文字列（例：ad=summer&cid=789）。
• 保存先：LIFF 用 LineConfig API（PATCH /line/line-config/:id/referer-id）。
  LINE Config User に紐づけて保管します。
• サーバー更新：line_config_users.refererId を更新し、同時に referer_log に履歴を残します（既存値と同一なら更新スキップ）。

動作フロー

A. saveReferer（保存）

1. ユーザーが saveReferer=true 付きの LIFF URL を開く。
2. 現在のクエリから saveReferer・lineConfigId・popupReportId を除外して整形。
3. 整形結果を refererId として PATCH /line/line-config/:id/referer-id に保存（LINE Config User に紐づく）。
4. サーバー側で line_config_users.refererId を更新、referer_log に履歴を記録（同一値はスキップ）。
5. 以後、後続処理や集計で参照可能に。

B. referer（再利用・連携）

1. ユーザーが referer=true 指定の LIFF「transfer」ページにアクセス。
2. lineConfigId が分かっている場合、/line/line-config/:id/line-config-user から refererId を取得。
3. refererId を & で分解・バリデーションして queries 配列へ格納。
4. リダイレクト先URLのクエリに付与して遷移（既存クエリがある場合はマージ）。
5. 新しい値の保存は行わない（あくまで再利用）。

サンプル

1) 初回保管（saveReferer）

2) 再利用（referer）

よくある質問

Q1. referer=true だけで新しい値を保存できますか？

いいえ。referer=true は保存済みの値を付け直すだけです。初回の保管は saveReferer=true を利用してください。

Q2. lineConfigId が無い場合は？

保存／参照対象の LINE Config User が特定できないため、refererId の取得・付与が行えません。

Q3. 同じ refererId が既にある場合は？

既存値と同一の場合、保存更新はスキップされます（履歴の重複記録も避けます）。

Q4. どこに保存されますか？

LIFF 用 LineConfig API（PATCH /line/line-config/:id/referer-id）により、LINE Config User に紐づけて保存し、referer_log に履歴を残します。

Q5. 外部サイトにも引き継げますか？

はい。transfer ページが refererId を遷移先URLのクエリに付与するため、別ページや外部サイトに連携できます。

導入・運用のヒント

テスト手順（チェックリスト）

1. saveReferer=true 付き URL にアクセスし、line_config_users.refererId が更新されたか確認。
2. 同一値で再アクセスし、更新スキップ（履歴重複なし）を確認。
3. referer=true の transfer ページから、遷移先URLに refererId が正しく付与されるか確認。
4. 既存クエリとのマージ、URL エンコードの崩れが無いか確認。
5. 集計基盤で referer_log が期待通りに計上されるか確認。