postback(自動応答の発火)
自社サイトや外部のショッピングカートで購入が完了したときに、そのお客様の LINE 側で自動応答を発火させられます。既存のカートをそのまま使いながら、購入をきっかけにサンクスメッセージの配信、ラベル付与、配信グループの切り替え、広告のコンバージョン戻しまで自動で動かせます。
外部の予約システムで予約が完了したときも同じしくみです。このページの「購入完了ページ」を「予約完了ページ」と読み替えてお読みください。
決済そのものは連動しません
このタグで送られるのは「発火キーワード」だけです。購入金額・商品明細・注文番号はサブスクラインへは渡りません。購買明細をサブスクライン側のデータとして持たせたい場合は、商品管理で購入導線をサブスクライン側に置いてください。
このページは、タグの設置やサーバー間の呼び出しを実装する方向けです。トークンの発行と自動応答の作成は管理画面で行います(管理者向けの手順)。
全体の流れ
事前準備
次のものを管理者から受け取ってください。
| 受け取るもの | 内容 | 入手先 |
|---|---|---|
| 発火用トークン | postback スコープの接続トークンです | トークンの発行 |
| 発火キーワード | 自動応答に設定したキーワードです | 自動応答の作成 |
lcid | LINE 公式アカウントの識別子です | LINE から送るリンクに識別子を付ける |
1. お客様を識別できるようにする
タグは「どの LINE 公式アカウントの、どのお客様か」が分からないと発火しません。次の 2 つの値を購入完了ページで使える状態にします。
| パラメータ | 内容 |
|---|---|
lcid | LINE 公式アカウントの識別子。アカウントごとに固定値です。お客様へそのリンクを配信したアカウントの値を使います |
luid | お客様の識別子。配信や自動応答のメッセージ本文に書いたリンクでは、差し込み変数 {line_user.hashId} がお客様ごとの値に置き換わります |
lcid の確認と、LINE から送るリンクへ lcid / luid を付ける設定は、管理画面で行います。手順は操作マニュアルの LINE から送るリンクに識別子を付ける で説明しています。設定が済むと、お客様は次の形の URL で自社サイトへ着地します。
https://example.com/lp?lcid=xZy7mZKLr9EcrEfabGgD&luid=3IWALNrcArd1DAOMCxmU購入完了ページで lcid / luid を使えるようにする方法は 2 つです。
ページの URL にパラメータが付いているだけでは発火しません
postback タグが識別子を読むのは、タグ自身の src に書かれた値か、query-getter タグが保存した値のどちらかだけです。購入完了ページのアドレスに ?lcid=…&luid=… が付いていても、タグはそれを読みません。下記のどちらかを必ず行ってください。
方法A: query-getter タグで保存する
lcid / luid が URL に付いているページへ、次のタグを設置します。読み込んだ時点でその URL のパラメータを保存し、あとから読み込まれる postback タグがその値を使います。着地ページと購入完了ページのどちらに付いていても構いませんが、同じページに置く場合は postback タグより前に書いてください。
<script src="https://cdn.subscline.jp/sdk/query-getter/v1/latest.js?type=setter"></script>外部予約タグでプロフィール値を渡す場合
query-getter の予約完了タグへ氏名・メールアドレスなどを付ける場合、値は URL 用に 1 回だけエンコードしてください。タグ側で1回デコードしてプロフィールへ反映するため、%・+・= を含む値もそのまま保持されます。壊れた percent encoding が含まれる項目は、誤った文字列でプロフィールを上書きせず、その項目だけ更新しません。
プロフィールへの反映には、配信のリンクに付く署名(r_sig)が必要です
配信・自動応答の本文に r_uid={line_user.hashId} を付けたリンクを書くと、お客様へ送る時にサブスクラインが同じリンクへ署名 r_sig を自動で付けます(スタッフ向けの通知・通知メール・ポストバック先URLには付けません)。有効期限は送信から14日です。
予約完了タグは、この署名が正しいときだけプロフィールへ反映します。署名の無いリンク・別の会員や別のアカウントの署名・送信から14日を過ぎたリンクからは反映されません。反映する項目は姓・名・セイ・メイ・生年月日・電話番号・メールアドレスの7つです。
- この変更より前に送った配信のリンクには署名が付いていないため、そこから開かれた場合はプロフィールへ反映されません。
- 予約完了タグの
srcへr_uidを直接書き出している場合は、着地ページに query-getter タグ(type=setter)を置いて署名を保存するか、着地したページの URL に付いていたr_sigも同じタグへそのまま書き出してください。保存した署名は、タグのr_uidが保存時と同じ会員のときだけ使われます。 <!-- claim-evidence: sdk/query-getter/test/signature.test.cjs (2026-10-26 node --test で同じ会員のときだけ保存済みの署名を使うことを確認) --> - query-getter タグ(
type=setter)は署名を保存したあと、ページのアドレスからr_sigだけを取り除きます(ページは再読み込みされません)。 <!-- claim-evidence: sdk/query-getter/test/signature.test.cjs (2026-10-26 node --test で r_sig だけを外し他のパラメータを残すことを確認) --> r_uidを URL エンコードして別の URL の中に埋め込んだリンクには署名が付きません。r_uidはリンク自身のパラメータとして書いてください。
方法B: カート側のサーバーでタグに直接書き出す
購入完了ページを生成する時点で値が分かっているなら、2. 購入完了ページにタグを設置するのとおり postback タグの src へ lcid / luid を直接出力します。保存値に依存しないため、着地ページと購入完了ページのドメインが違う場合はこちらが必要です。
query-getter タグは、パラメータが付いているページにだけ設置してください
このタグは読み込むたびに、保存済みの値をそのページの URL パラメータで上書きします。lcid / luid が付いていないページ(サイト全体の共通テンプレートなど)に設置すると、保存済みの値が消えて発火しなくなります。
保存値を共有できるのは「スキーム・ホスト名・ポートが完全に一致する」ページ同士だけです
保存先はこの3つの組み合わせごとに分かれています。次はいずれも別扱いになり、着地ページで保存した値を購入完了ページから読めません。
https://www.example.comとhttps://shop.example.com(サブドメインが違う)https://example.comとhttp://example.com(スキームが違う)https://example.comとhttps://example.com:8443(ポートが違う)https://example.comとhttps://cart.example.net(別ドメインの外部カート)
外部カートを使う構成や、カートだけ別サブドメインの構成では、次の2. 購入完了ページにタグを設置するのとおりカート側のサーバーで lcid / luid をタグへ直接出力してください。
2. 購入完了ページにタグを設置する
購入完了ページ(サンキューページ)に次のタグを貼ります。keyword は自動応答の作成で設定したキーワード、data-token はトークンの発行のトークンです。
<script
src="https://cdn.subscline.jp/sdk/postback/v1/latest.js?keyword=ec_purchase_complete"
data-token="subscline_xxxxxxxxxxxx"
></script>lcid / luid をサーバー側で出力できる場合は、保存値に頼らずタグへ直接書けます。
<script
src="https://cdn.subscline.jp/sdk/postback/v1/latest.js?lcid=xZy7mZKLr9EcrEfabGgD&luid=3IWALNrcArd1DAOMCxmU&keyword=ec_purchase_complete"
data-token="subscline_xxxxxxxxxxxx"
></script>トークンは data-token 属性に書いてください
src のクエリにトークンを書いても読み取られません(送信時に認証が付かず失敗します)。あわせて、URL に書いたトークンは CDN や中間サーバーのアクセスログに残ります。必ず data-token 属性で渡してください。
タグの読み込み方と動作の有無
タグは自分自身の <script> から設定(src のパラメータと data-token)を読み取ります。読み込み方によって、動作するかどうかが次のように分かれます。
- HTML に直接書く(上の例の形): 動作します。
- タグマネージャーなどで
<script>要素を生成して挿入する: 動作します。document.createElement('script')で要素を作り、srcとdata-tokenを設定してページに追加する形です。 innerHTMLなどで HTML 文字列として挿入する: 動作しません。HTML 文字列として入れた<script>はブラウザが実行しないためです(このタグに限らない、HTML の一般的な仕様です)。type="module"を付ける: 現在は読み込めず、動作しません。配信元の CDN が CORS ヘッダー(Access-Control-Allow-Origin)を返さないため、ブラウザが読み込みを止めます(開発者ツールのコンソールに CORS のエラーが出ます)。HTML に直接書くか、<script>要素を生成して挿入する形にしてください。
タグ自体は、type="module" で読み込まれたときもページ内から自分の <script> を探して動作する作りになっています。CDN から type="module" で読み込めるようになった時点で、この説明を更新します。
その場合も、type="module" で読み込むときは 1 ページに postback タグを 1 枚だけ置いてください。同じページに 2 枚以上あると、どれが自分のタグか判別できないため、送信せずにブラウザの開発者ツールのコンソールへ警告を出して終了します(別のタグの lcid / luid / keyword / data-token で誤って発火させないための動作です)。複数のタグを同じページに置く場合は、type="module" を付けない読み込み方にしてください。
キーワードは半角英数字とアンダースコア(例: ec_purchase_complete)で設定してください。日本語のキーワードは変換されずに送信され、自動応答側と一致しません。
同じ発火を 1 回に抑える(event_id)
タグは読み込まれるたびに送信するため、そのままではお客様が購入完了ページを再読み込みしたり「戻る」で開き直したりするたびに発火します。広告媒体への成果通知まで設定している場合、コンバージョンがその回数分だけ二重に計上されます。
タグの event_id に、その 1 件で一意な値(注文番号・予約番号)を渡すと、同じ値での 2 回目以降は無視されます(判定は 7 日間保持)。
<script
src="https://cdn.subscline.jp/sdk/postback/v1/latest.js?keyword=ec_purchase_complete&event_id=ORDER-20260906-0012"
data-token="subscline_xxxxxxxxxxxx"
></script>- 値はカート・予約システム側が発行する番号をそのまま出力してください(毎回変わる値・固定値のどちらもこの目的には使えません)。テンプレートが展開されず
のような固定文字列のまま出力されると、2 件目以降のお客様の発火が消えます。 - 190 文字までです。超えると発火しません。
- 判定はキーワードごとに分かれます。同じ注文番号でも、別のキーワードでの発火は止まりません。
event_idを渡さない設置は従来どおり、読み込みのたびに発火します。
event_id を出力できない場合は、初回の発火でラベルを付与し、そのラベルを持たない人だけを条件にしたユーザーグループを自動応答の配信グループに指定する方法もあります。ただしラベルの付与は返信の送信が終わってから行われるため、ほぼ同時に 2 回届いた場合は両方とも配信されます(時間をおいた再読み込みは抑えられます)。1 回だけであることが会計上重要な処理(ポイント付与・クーポン発行など)は、この方法だけに頼らないでください。
なお、送信したキーワードは、そのお客様のトーク履歴にテキストとして記録されます。管理画面のチャット画面に表示されるため、お客様に見せても差し支えない文字列にしてください。
3. 動作を確認する
- テスト用の LINE ユーザーで、LINE から送るリンクから自社サイトへ入る
- テスト購入を行い、購入完了ページを表示する
- LINE に自動応答が届くことを確認する
- ポストバックログで、広告媒体への成果通知まで設定している場合はその送信結果を確認する
発火しないときは、まずポストバックログの「受信ログ」タブで、postback が届いたか・拒否された理由を確認してから、次を確認してください。
| 症状 | 確認すること |
|---|---|
| 何も起きない(通信もしない) | lcid / luid がページで取得できているか。どちらかが無い場合、タグはリクエストを送らずに終了します。同じページに postback タグを 2 つ以上置いていないか。innerHTML などで HTML 文字列として挿入していないか/type="module" を付けていないか(どちらもタグが実行されません。上の2. 購入完了ページにタグを設置するの「タグの読み込み方と動作の有無」を参照) |
401 が返る | data-token のトークンが正しいか、無効化していないか。src のクエリに書いていないか |
403 が返る | トークンのスコープに postback があるか、許可オリジンに設置サイトのオリジンが入っているか、そのトークンと lcid / luid が同じテナントか |
| 自動応答が動かない | 自動応答のきっかけが「ポストバック」になっているか、キーワードとマッチタイプが一致しているか、自動応答が有効か、配信グループの対象に入っているか |
| 一部のお客様だけ動かない | そのお客様が LINE 経由で自社サイトへ入っているか。LINE を経由したことがないブラウザには luid が無いため発火しません |
| 2 回目以降が発火しない | event_id に毎回同じ値を出力していないか(1 件ごとに変わる番号を渡してください) |
| 別のお客様として発火した | 着地ページで保存した値は期限なしで残ります。共用端末では前の利用者の値が使われることがあります(上の2. 購入完了ページにタグを設置するのサーバー側出力に切り替えてください) |
4. タグを使わずサーバー間で発火する
予約システム・カートに「完了時に任意の URL へ通知を送る」機能(Webhook 送信)がある場合や、タグを設置できない場合は、そちら側のサーバーから直接呼び出せます。ブラウザを経由しないため、lcid / luid の受け渡しやページ再読み込みの影響を受けません。
トークンはトークンの発行と同じ postback スコープの接続トークンを使いますが、サーバー間で使うトークンは「許可オリジン」を空のまま発行してください(Origin ヘッダーを送らない呼び出しになるため)。この場合トークンそのものが秘密情報なので、呼び出し元のサーバーにだけ保管し、HTML には載せないでください。
| 項目 | 内容 |
|---|---|
| メソッド・URL | POST https://api.subscline.jp/api/v1/line/postback/{lcid}/{luid} |
| 認証 | Authorization: Bearer subscline_xxxxxxxxxxxx |
| ヘッダー | Content-Type: application/json |
| ボディ | keyword(発火させるキーワード)、eventId(重複送信の抑止キー・任意) |
curl --request POST \
--url 'https://api.subscline.jp/api/v1/line/postback/xZy7mZKLr9EcrEfabGgD/3IWALNrcArd1DAOMCxmU' \
--header 'Authorization: Bearer subscline_xxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{ "keyword": "ec_purchase_complete", "eventId": "ORDER-20260906-0012" }'{lcid}は1. お客様を識別できるようにするの LINE 公式アカウントの識別子、{luid}はお客様の識別子です。どちらもお客様を LINE から誘導した時点で受け取り、注文・予約に紐づけて保存しておく必要があります(サーバー間の呼び出しでは、その場でブラウザから取得できません)。eventIdは重複送信の抑止キーです。リトライで同じ値を送っても、発火は 1 回だけになります(7 日間保持・キーワードごとの判定)。発火に失敗して500が返った場合は抑止されないので、そのままリトライしてください。- 応答は
200。{ "ok": true, "duplicated": true }が返った場合は、同じeventIdで既に発火済みのため無視されたことを示します。
エラー時の応答は次のとおりです。
| コード | 意味 |
|---|---|
400 | eventId が 190 文字を超えているなど、ボディの形式が不正 |
401 | トークンが無い・無効・失効している |
403 | トークンに postback スコープが無い、許可オリジンの指定と一致しない、またはトークンのクライアントと {lcid} / {luid} の所属が違う |
404 | {lcid} / {luid} が存在しない |
注意点
- 送信できるのはキーワードだけです。金額・商品名・数量・注文番号は送れません。
- LINE を経由したことがないブラウザ(自然検索・他媒体からの直接流入だけ)は識別子を持たないため、発火対象になりません。
- 一方で、着地ページで保存した識別子は期限なしでブラウザに残ります。過去に一度 LINE 経由で来たブラウザなら、その後は検索から直接入って購入しても、保存済みの値で発火します。共用端末では前の利用者に対して発火することがあるため、購入者を確実に一致させたい場合は2. 購入完了ページにタグを設置するのサーバー側出力を使ってください。
- 着地ページで保存した値を使う構成では、別の端末・ブラウザで購入した場合や、購入完了ページのスキーム・ホスト名・ポートのいずれかが着地ページと違う場合は発火しません(サブドメイン違いも別扱いです)。外部カートを使う場合は
lcid/luidをタグへ直接出力してください。 - 自社サイトの購入完了ページに設置する前に、テスト用の LINE ユーザーで必ず確認してください。実在のお客様を接続試験に使用しないでください。
- 友だち追加そのものを自社サイトから計測したい場合は、トラッキング用 LIFF URLとポップアップを使います。