サブスクライン マニュアル

Appearance

質問フォーラム

広告の成果通知（ポストバック）設定 ​

広告（Google・Yahoo!・Meta・X・TikTok など）から流入したお客様が、LINE上で「友だち追加」「会員登録」「予約完了」などの成果（コンバージョン）に至ったことを、各広告媒体に通知して計測できるようにする機能です。

これにより「どの広告がどれだけ成果につながったか」を広告媒体側のレポートで正しく評価でき、広告の費用対効果（CPA・ROAS）の改善に使えます。

成果通知は、自動応答メッセージの「ポストバック設定（V2）」に連携先を登録して設定します。設定した自動応答が発火（友だち追加・予約完了などのイベントで起動）したときに、サブスクラインが各広告媒体へコンバージョンを送信します。

設定場所: 画面左メニュー「LINE」>「自動応答一覧」> 対象の自動応答を新規作成／編集 > 「ポストバック設定（V2）」

このページの位置づけ

自動応答メッセージ全体の使い方は 自動応答一覧 を、Google/Yahoo! のCSV取り込み連携は Google広告・Yahoo広告 を参照してください。このページは「広告ごとの成果通知（ポストバック）をどう設定するか」に絞って解説します。

成果通知のしくみ ​

広告の成果通知は、**広告クリック時に付与される「クリックID」**を手がかりに成立します。クリックIDは広告媒体ごとに名前が異なります。

広告媒体クリックID流入パラメータの例
Google広告gclid?gclid=xxxxx
Yahoo!広告（検索／ディスプレイ）yclid?yclid=xxxxx
Meta広告（Facebook / Instagram）fbclid?fbclid=xxxxx
X広告（旧Twitter）twclid?twclid=xxxxx
TikTok広告ttclid?ttclid=xxxxx

成果通知が成立するまでの流れは次のとおりです。

クリックIDが流入時に付与されている必要があります

成果通知は、お客様が流入したときのURLにクリックID（gclid など）が含まれていて初めて記録されます。広告の遷移先URL（LINE友だち追加URL・会員ページURLなど）に、媒体が自動付与するクリックIDが引き継がれるように設定してください。クリックIDが無いお客様（自然流入・別経路など）は計測対象になりません。

クリックIDは、流入時のURLパラメータとしてお客様（流入元情報）に保存されます。ポストバック設定の中で {referer.gclid} のように書くと、自動応答の発火時に保存済みの値へ自動的に置き換えられます。{referer.<キー>} は任意のクエリパラメータに対応しており、{referer.gclid} {referer.yclid} {referer.fbclid} {referer.twclid} {referer.ttclid} などが使えます。

2つの連携方式 ​

成果通知には大きく2つの方式があります。媒体・目的に応じて使い分けます。

方式対象動作
直接送信方式Meta広告 / X広告 / TikTok広告 / Yahoo!広告(検索) / Yahoo!広告(ディスプレイ) / Quoriza / カスタムURL / cURL自動応答が発火した瞬間に、サブスクラインが各広告媒体の計測APIへコンバージョンを送信します。CSVのアップロードは不要です。
CSV取り込み方式（オフラインCV）Google広告 / Yahoo!広告自動応答の発火でサブスクライン内にコンバージョン（クリックID＋コンバージョン名）を記録し、あとからCSVを書き出して広告媒体にアップロードします。

Google広告は仕様上オフラインコンバージョン（CSV取り込み）方式です。Yahoo!広告は「CSV取り込み方式」と「直接送信方式（検索／ディスプレイの各プリセット）」のどちらも利用できます。

V1（旧方式）について

以前は「ポストバック通知URL」欄にURLを直接登録する方式（旧ポストバック通知）や、配布SDKによる方式が使われていました。これらは現在も互換のため残っていますが、新しく設定する場合は「ポストバック設定（V2）」または cURL を使ってください。 本ページはV2を前提に説明します。

共通の設定手順（ポストバック設定 V2） ​

  1. 「LINE」>「自動応答一覧」を開き、対象の自動応答を新規作成または編集します。
  2. 成果の「きっかけ」に合わせてイベントタイプを選びます。たとえば友だち追加を成果にするなら「LINE友だち追加」、予約完了を成果にするなら予約完了が起こる自動応答に設定します。
  3. フォーム下部の 「ポストバック設定（V2）」 で「ポストバック設定を追加」を押します。
  4. 追加されたカードに次を設定します。
    • ポストバック設定の名前: 管理用の名前（例: Meta計測用）。
    • モード（必須）: 連携先の広告媒体・方式を選びます（全9種類。次節参照）。
    • 入力欄: モードに応じて、ポストバック先URL・各媒体の認証情報（アクセストークン・ピクセルID・コンバージョンIDなど）・送信パラメータ（キー／値）が表示されます。
  5. 入力欄では、値に差し込み変数（{referer.gclid} や {line_user.hashId} など）を使えます。入力欄を選択すると表示される「変数」検索パネルから挿入できます。
  6. 設定は有効／無効を切り替えられます。無効にしたポストバックは実行されません。複数追加した場合は「上へ」「下へ」で実行順を変更できます。
  7. 自動応答を保存します。

プリセットを選ぶと初期値が入ります

モードで広告媒体プリセットを選ぶと、ポストバック先URL・必要な入力項目・クリックIDの送信パラメータ（例: fbclid = {referer.fbclid}）が自動で用意されます。多くの場合、媒体側で取得した認証情報・IDを入力するだけで設定が完了します。

媒体別の設定 ​

各媒体で必要な入力項目は、画面のプリセットに従って表示されます。下表の「必要な入力」を、媒体の管理画面（広告マネージャ／イベントマネージャ等）で発行・確認して入力してください。前提クリックIDが流入時に付与されていることが共通の条件です。

Meta広告（Facebook / Instagram） ​

MetaのコンバージョンAPI（CAPI）へ直接送信します。

  • 方式: 直接送信
  • 前提クリックID: fbclid
  • 必要な入力:
    • アクセストークン（Metaのイベントマネージャで発行するCAPI用アクセストークン）
    • ピクセルID
    • イベント名（例: Purchase、Lead、CompleteRegistration など、Metaで計測したいイベント名）
  • 自動で送信される値: fbclid = {referer.fbclid}
  • 補足: 「送信パラメータ」で任意のカスタムデータを追加できます。

X広告（旧Twitter） ​

XのコンバージョンAPIへOAuth認証で送信します。入力項目が最も多い媒体です。

  • 方式: 直接送信
  • 前提クリックID: twclid
  • 必要な入力:
    • コンシューマーキー
    • コンシューマーシークレット
    • アクセストークン
    • トークンシークレット
    • ピクセルID
    • イベントID
    • コンバージョンID
  • 自動で送信される値: twclid = {referer.twclid}

TikTok広告 ​

TikTokのイベントAPIへ送信します。

  • 方式: 直接送信
  • 前提クリックID: ttclid
  • 必要な入力:
    • アクセストークン
    • ピクセルID
    • イベント名（例: CompleteRegistration、Purchase など）
  • 自動で送信される値: external_id = {line_user.hashId}、ttclid = {referer.ttclid}

Yahoo!広告（検索） ​

Yahoo!検索広告（リスティング）の計測APIへ直接送信します。

  • 方式: 直接送信
  • 前提クリックID: yclid
  • 必要な入力:
    • アプリケーションID
    • コンバージョンID（検索）
    • コンバージョンラベル（検索）
    • CV金額（例: 1000。{order.totalPrice} などの差し込み変数も使えます）
  • 自動で送信される値: yclid = {referer.yclid} のほか、流入URL・IPアドレス・UAが補完されます。

Yahoo!広告（ディスプレイ / YDA） ​

Yahoo!ディスプレイ広告（YDA）の計測APIへ直接送信します。

  • 方式: 直接送信
  • 前提クリックID: yclid
  • 必要な入力:
    • アプリケーションID
    • コンバージョンID（YDA）
    • コンバージョンラベル（YDA）
  • 自動で送信される値: yclid = {referer.yclid}

Yahoo!広告はCSV取り込みも選べます

Yahoo!広告は、上記の直接送信プリセットのほかに、コンバージョンをサブスクライン内に記録してCSVでアップロードする「CSV取り込み方式」も利用できます。CSVの書き出しや連携用情報（url / username / password）は Yahoo広告 の設定タブで扱います。

Google広告（オフラインCV） ​

Google広告はオフラインコンバージョン（CSV取り込み）方式です。自動応答が発火すると、gclid とコンバージョン名をサブスクライン内に記録します。記録したコンバージョンは、Google広告 の設定タブからCSVで書き出し、Google広告側に取り込みます。

  • 方式: CSV取り込み（サブスクライン内に記録 → CSVをGoogle広告へアップロード）
  • 前提クリックID: gclid
  • 必要な入力:
    • コンバージョン名（例: follow、reservation など。CSVの「Conversion Name」になります）
  • 自動で記録される値: gclid = {referer.gclid}

事前に「設定 > Google広告」の連携を有効化してください

このプリセットを使うには、先に 設定 > Google広告 で「コンバージョン連携を有効化」しておく必要があります。有効化すると、CSV取得用のURL・ユーザー名・パスワードが発行されます。

Quoriza ​

計測サービス Quoriza（クオリザ）へGETで送信するプリセットです。

  • 方式: 直接送信（GET）
  • 必要な入力:
    • 広告主キー（ak）
    • ユーザー識別子（uq）（初期値 {line_user.hashId}）
    • イベントコード（ec）（初期値 0）
    • 流入パラメータ（hc_uus）（初期値 {referer.hc_uus}）

ポストバックURLを指定（カスタムURL） ​

任意のURLへGETで送信します。プリセットが用意されていない計測サービスや、独自エンドポイントへ通知したいときに使います。

  • 方式: 直接送信（GET）
  • 必要な入力:
    • ポストバック先URL（差し込み変数を含められます。例: https://example.com/cv?uid={line_user.hashId}&gclid={referer.gclid}）

cURLコマンドを指定 ​

cURLコマンドの形で、メソッド・ヘッダー・ボディを自由に指定して連携します。プリセットでは表現できない細かなリクエストを送りたいときに使います（「CURLを使う」連携はここで設定します）。

  • 方式: 直接送信（cURL）
  • 必要な入力:
    • cURLコマンド（例: curl -X POST https://example.com/api -H "Content-Type: application/json" -d '{"uid":"{line_user.hashId}"}'）
  • 補足: コマンド内でも差し込み変数を使えます。メソッドは GET / POST に対応します。

よく使う差し込み変数（プレースホルダ） ​

入力欄の値には、自動応答の発火時に実際の値へ置き換わる差し込み変数を使えます。代表的なものは次のとおりです（全項目は画面の「変数」検索パネルで確認できます）。

変数内容
{referer.gclid} / {referer.yclid} / {referer.fbclid} / {referer.twclid} / {referer.ttclid}各広告媒体のクリックID（流入時のURLパラメータから取得）
{referer.<キー>}流入時URLの任意のクエリパラメータ
{line_user.hashId} / {line_user.id}お客様のハッシュID／ID
{line_user.email} / {line_user.displayName}メールアドレス／お名前
{line_config_user.refererUrl} / {line_config_user.ipAddress}流入元URL／IPアドレス
{reservation.totalPrice} / {order.totalPrice} / {subscription.planTitle}予約・注文・契約の情報
{now} / {nowMillis}現在時刻（UNIX秒／ミリ秒）

イベントに紐づく変数は発火元によって空になります

{reservation.*}・{order.*}・{subscription.*}・{cancel_subscription.*} などのイベント固有の変数は、その自動応答が該当イベント（予約・注文・契約・解約など）で発火したときだけ値が入ります。関係しないイベントで発火した場合は空になります。

動作確認とトラブルシュート ​

  • 「ポストバック(V2)設定数」列とログ: 自動応答一覧には、各自動応答に設定したポストバック(V2)の件数が表示されます。ログをエクスポートする権限がある場合は、この欄から**ポストバックの実行ログ（CSV）**を書き出せます。送信の成否や所要時間、エラー内容の確認に使えます。
  • 計測されないときは、次を確認してください。
    • 流入時のURLにクリックID（gclid など）が付与されているか（付与されていないお客様は計測対象外です）。
    • 自動応答のステータスが有効で、対象のお客様が配信グループに含まれているか。
    • ポストバック設定が有効になっているか（無効の設定は実行されません）。
    • 必要な入力項目（アクセストークン・各ID・コンバージョン名など）がすべて埋まっているか。
    • Google広告の場合、設定 > Google広告 の連携が有効化されているか。

注意点 ​

  • 認証情報（アクセストークン・各種シークレット）は機密情報です。 取り扱いに注意し、第三者に共有しないでください。
  • クリックIDの仕様変更: 各広告媒体のクリックID名やAPI仕様は媒体側の都合で変わることがあります。計測が止まった場合は媒体側の最新仕様もご確認ください。
  • 直接送信は即時、CSVは取り込みが必要: 直接送信方式は発火時に媒体へ送られますが、CSV取り込み方式（Google／Yahoo!のオフラインCV）は、書き出したCSVを媒体にアップロードして初めて反映されます。