LINE公式アカウント連携（友だち追加などをCVとして送る）

← コンバージョンAPI設定にもどる

対応状況: 対応済み。LINE公式アカウント(Messaging API)の 友だち追加やメッセージなどのイベント を、そのユーザーが もともと流入してきた広告媒体(Google / Yahoo!ディスプレイ・LINE / TikTok / Meta)へコンバージョンとして送り返せます。

仕組み（2つの時間をつなぐ）

1. 広告クリック時: LPに設置した配布タグがクリックID(gclid など)をクッキーに保存します。
2. 友だち追加時: LPの「LINEで友だち追加」ボタンが LINEログイン(友だち追加の確認画面つき)を経由することで、LINEのユーザーIDとクリックIDが紐付きます。
3. LINEイベント発生時(直後〜数十日後): 友だち追加やメッセージが Webhook でアプリに届き、登録したイベントだけが、紐付いたクリックIDの媒体へCVとして送信されます。

事前に用意するもの

手順A【媒体】LINE Developers でチャネルを準備する

1. LINE Developers で、対象の LINE公式アカウントの Messaging API チャネル を開き、チャネルID / チャネルシークレット を控えます。「応答設定」で Webhook を ON にします。

2. 同じプロバイダーに LINEログインチャネル を作成(既にあればそれを使用)し、チャネルID / チャネルシークレット を控えます。

3. LINEログインチャネルに、手順1の LINE公式アカウントをリンクします(友だち追加の確認画面を出すために必要です)。コンソールでの手順は次のとおりです。

   1. LINE Developersコンソール にログインし、LINEログインチャネルがあるプロバイダーをクリック。
   2. LINEログインチャネルをクリック。
   3. 「チャネル基本設定」タブをクリック。
   4. 「リンクされたLINE公式アカウント」の「編集」 をクリック。
   5. 友だち追加させたい LINE公式アカウントを選び、「更新」 をクリック。

   ※ この操作には、LINEログインチャネルの Admin 権限と、LINE公式アカウントの管理者権限が必要です。

4. LINEログインチャネルに コールバックURL(リダイレクトURL) を登録します。コンソールでの手順は次のとおりです。

   1. 同じ LINEログインチャネルで、「LINEログイン設定」タブをクリック(「チャネル基本設定」タブではありません)。
   2. 「コールバックURL」の「編集」 をクリック。
   3. 次の値を貼り付けて 「更新」 をクリック: https://app.ad-submission.com/api/line/link/callback
   4. 「コールバックURL」の一覧に、いま登録した URL が表示されていることを確認します。

   ※ Messaging API チャネルにはコールバックURLの欄がありません。 見つからない場合は、開いているチャネルが LINEログインチャネルかどうかを確認してください。

手順B【アプリ】チャネルを登録する

1. 左のツリーで プロジェクト を選び、プロジェクト概要の 「LINE公式アカウント連携」 セクションを開きます。
2. 「＋ チャネル登録」 で手順Aの4つの値(表示名は任意)を入力して登録します。
3. 登録したチャネルの 「Webhook URL をコピー」 を押し、LINE Developers の Messaging API 設定の Webhook URL に貼り付けて 「検証」 を実行します(成功すればOK)。

手順C【サイト】友だち追加ボタンを cvLineLink() 経由にする（最重要）

1. LPに 共通手順 の 配布タグ を設置します(未設置の場合)。
2. LPの「LINEで友だち追加」ボタンを、静的なリンクではなく 配布タグの cvLineLink() を呼ぶ形に変更します:

<button onclick="cvLineLink('<チャネルのchannel値>')">LINEで友だち追加</button>

<チャネルのchannel値> は、アプリのチャネル一覧の 「友だち追加リンクをコピー」 で得られる URL の channel= の値です。

ボタンを押したユーザーには、LINEログインの同意画面 → 友だち追加の確認画面が表示され、完了後は元のページへ戻ります。

手順D【アプリ】どのLINEイベントをCVにするか登録する

「LINE公式アカウント連携」の 「イベント → CV マッピング」 で登録します。

1. イベント種別: 友だち追加(follow)/ メッセージ受信(message)/ ポストバック(postback)など。
2. マッチ条件(任意): postback の data やメッセージ本文で絞る場合は「完全一致」「前方一致」を選びます(条件なし = そのイベント全部)。
3. アプリ内CV名: 例 CompleteRegistration(Meta 標準イベント名に準拠)。value(CV価値)も任意で設定できます。
4. 各媒体フォルダの「コンバージョン設定」で、このアプリ内CV名 → 媒体側CVの対応付けを登録します(共通手順の手順2と同じです。媒体ごとの取得方法は各媒体ページ参照)。

確認のしかた

• 運用状況(チャネル選択時に表示): 紐付け済みユーザー数・クリックID充足率・受信イベント内訳・媒体別の転送結果を確認できます。
• 転送結果の「対象外(no_match_key)」は、その媒体から流入していないため送っていない正常な動作です(この機能は流入元の媒体にだけCVを返します)。
• 最終的には各媒体の管理画面(コンバージョン計測)でCVが計上されることを確認してください。

友だち追加リンクが「400 Bad Request / Invalid redirect_uri value」になる

このボタンは静的な友だち追加リンクではなく、LINEログインを経由して友だち追加します(そうしないとクリックIDと紐付きません)。そのため、LINEログインチャネルにコールバックURLが登録されていないと、LINE側で次のエラーになります。

Invalid redirect_uri value. Check if it is registered in a LINE developers site.

アプリが送っているリダイレクトURLはエラー画面のアドレスバーに redirect_uri= として表示されています。 その値と、LINE Developers に登録した値を見比べてください。原因はほぼ次のいずれかです。

1. 手順Aの4を実施していない(コールバックURLが未登録)。
2. 登録先のチャネルが違う: Messaging API チャネルではなく、LINEログインチャネルの「LINEログイン設定」タブに登録します。
3. 文字列が一致していない: http/https、ポート番号、末尾スラッシュの有無、パスの綴りを確認します。
4. アプリに登録したログインチャネルIDが別チャネルのもの: コールバックURLを登録したチャネルのIDと同じか、アプリのチャネル登録内容を確認します。
5. 本番の NEXT_PUBLIC_APP_URL が未設定/localhost のまま: 送られるリダイレクトURLが本番ドメインになりません。

よくある質問

• QRコードやLINE内検索から友だち追加した場合は? — クリックIDの紐付け機会がないため、Google / TikTok / Meta へはCVを返せません。Yahoo!ディスプレイ/LINE のみ、コンバージョン設定で channel_id(対象の公式アカウント)を選択しておくと、LINEのユーザーIDを使ってLINE面に限りCVを返せます。
• 同じCVが複数媒体に計上される? — 複数媒体の広告をクリックしていた場合、有効期限内のすべての流入元媒体へ返します。媒体をまたいだCV合計は重複を含む点に注意してください。
• ブロック(unfollow)もCVにできる? — 登録すれば送れてしまいます。誤設定にご注意ください。