LINE Harnessの流入経路・トラックリンク設定｜QRとクリック計測の違い
友だち追加用のリファラルURLと、配信後クリックを測るトラックリンクの違い、QR表示、タグ・シナリオ連携を解説します。 友だち追加用の/r/:refを作り、スマホのLINE遷移とPCのQR表示を実機確認します。 外部URLを/t/:linkIdへ変換し、クリック記録、タグ、シナリオ、アプリ遷移を確認します。
この記事はHarness Academyの教材データを基に、各Harnessの公式リポジトリにある実装箇所と照合して構成しています。秘密情報や本番データを記事・AIチャットへ貼らず、外部送信は必ず検証対象を限定してください。
この記事の目次
最初に確認すること
- リファラル登録ページとQRを確認する: 流入元別URLが正しいPoolと配信へつながり、PCでは安全なQRが表示される
- トラックリンクでクリック後の行動を作る: 配信内リンクのクリックを人物単位で測り、必要なタグ・シナリオを安全に実行できる
リファラル登録ページとQRを確認する
友だち追加用の/r/:refを作り、スマホのLINE遷移とPCのQR表示を実機確認します。
この工程のゴール: 流入元別URLが正しいPoolと配信へつながり、PCでは安全なQRが表示される
リファラルリンクは友だち追加の入口です。URLは<Worker>/r/<ref_code>で、タグ、送り先Pool、起動シナリオ、即時push、アカウント標準シナリオの並走を入口ごとに設定できます。
現行実装ではPCアクセス時に240pxのQRを表示し、QRにはLIFF URLを入れます。モバイルはLINEアプリを開くCTA/リダイレクトです。ブラウザはWorkerの/api/qrから画像を取得し、xh:で始まる外部へ出してはいけないtokenはLIFF URLとQRから除外されます。
手順
1. 入口設計
媒体名が分かるref_codeと、タグ・Pool・配信モードを決めます。
2. 登録ページ作成
リファラルリンク画面で設定し、公開URLを取得します。
3. PCでQR
デスクトップブラウザで開き、QR画像が表示されることを確認します。
4. 実機で友だち追加
QRとスマホ直リンクの両方を通し、流入、配信、ファネルを確認します。
完了条件
- PCでQRが表示される
- QRとスマホ直リンクの両方でLINEへ進める
- 正しいref_code・Pool・タグ・配信が記録される
- 外部へ出せないtokenがQRに含まれない
注意: QRが表示されたことだけでは成功ではありません。実機で読み取り、友だち追加後の流入記録まで確認します。
Academy教材: LINEをAIから運用する / Lesson 4-8
トラックリンクでクリック後の行動を作る
外部URLを/t/:linkIdへ変換し、クリック記録、タグ、シナリオ、アプリ遷移を確認します。
この工程のゴール: 配信内リンクのクリックを人物単位で測り、必要なタグ・シナリオを安全に実行できる
トラックリンクは友だち追加用ではなく、配信後に外部URLを開くクリック計測です。保存項目は名前、遷移先URL、クリック時タグ、シナリオなどで、公開URLは<Worker>/t/<linkId>です。
一斉配信ではURLの自動トラッキング処理もあります。InstagramやYouTubeなどのUniversal Link対象は、アプリを開きやすいHTML/intent方式へ分岐します。
手順
1. 用途を分離
新規友だち獲得なら/r、既存友だちの外部クリックなら/tを選びます。
2. リンクを作る
名前、original URL、タグ、シナリオを設定します。
3. 配信へ配置
検証テンプレートまたは検証一斉配信へURLを置きます。
4. クリック検証
LINE内、Safari/Chrome、対象アプリで遷移と一回の副作用を確認します。
完了条件
- trackingUrlが/t/:linkId
- 遷移先URLが正しい
- 人物付きクリック履歴を確認
- タグ・シナリオの重複影響を確認
注意: リファラルリンクの/rと、外部クリック用の/tを混同しません。短縮URLだけを見ず、必ず最終遷移先hostを確認します。
Academy教材: LINEをAIから運用する / Lesson 4-9
公式ソース
- LINE Harness / apps/web/src/app/inflow-links/page.tsx — リファラル一覧と公開URL
- LINE Harness / apps/web/src/app/inflow-links/_components/edit-route-modal.tsx — Pool・タグ・配信設定
- LINE Harness / apps/worker/src/index.ts — /r/:refとPC用QR
- LINE Harness / apps/worker/src/routes/liff.ts — LIFF URLとtoken除外
- LINE Harness / apps/worker/src/routes/tracked-links.ts — クリック記録と遷移
- LINE Harness / apps/worker/src/services/auto-track.ts — 配信URLの自動変換
- LINE Harness / packages/mcp-server/src/tools/create-tracked-link.ts — MCP作成
- LINE Harness / packages/mcp-server/src/tools/get-link-clicks.ts — クリック確認
関連ガイド
Academy会員はコピペ実行用プロンプトと演習を開くと、同じ手順をAIへ渡して実機で進められます。