X広告と成果連携(コンバージョンAPI連携)したいです

概要

サブスクラインでは ポストバック機能 を使って X 広告（旧 Twitter Ads）の Web Conversions API（CAPI） へイベントを直接送信できます。
これによりブラウザ側の Pixel だけでは拾い切れない LINE 友だち追加・課金完了などの成果を確実に X 広告マネージャーへ返送し、広告の最適化・類似オーディエンス生成・LTV 分析に活用できます。
設定は ①ピクセル／イベント ID 取得 → ②OAuth 1.0a トークン準備 → ③twclid 引き継ぎ → ④サブスクラインで POST 設定 → ⑤動作テスト の 5 工程です。

---

1. 事前準備

1-1. X Pixel とイベント ID を取得

1. X 広告マネージャーの ［ツール ▸ イベントマネージャー］ で「イベントソースを追加」→ X Pixel を選択します。すると Pixel ID が自動発行されます。

2. Pixel 詳細画面で「Conversions API を使用」を選び、紐付ける イベント ID（例：CompleteRegistration）をメモします。既存 Pixel と同じイベント ID を使うとブラウザ／サーバーの 重複除外 が有効になります。

1-2. OAuth 1.0a 資格情報を取得

Ads API では OAuth 1.0a 署名付き Authorization ヘッダー が必須です。Developer Portal でアプリを作成し、次を控えます：

種別	用途
Consumer Key / Consumer Secret	アプリ識別子
Access Token / Access Secret	対象広告アカウントへの権限

---

2. クリック ID（twclid）の引き継ぎ

• X 広告のクリック URL には twclid が自動付与されます。

• LP からトラッキング対応 LIFF 経由で LINE 友だち追加を行います。

---

3. サブスクライン側設定

3-1. ポストバック URL

管理画面 → ［自動応答 ▸ ポストバック通知URL］ に以下のように登録します。

https://api.subscline.jp/api/v1/client/##CLIENT_ID##/postback/post
?header={
"Authorization":"OAuth oauth_consumer_key=\"##API_KEY##\", oauth_token=\"##ACCESS_TOKEN##\", oauth_signature_method=\"HMAC-SHA1\", oauth_timestamp=\"{{now}}\", oauth_nonce=\"{{now}}\", oauth_version=\"1.0\", oauth_signature=\"{referer.signature}\""
}
&body={
"conversions":[
{
"conversion_time":"{{now}}",
"event_id":"{line_user.hashId}",
"identifiers":[{"twclid":"{referer.twclid}"}],
"value":"100.00",
"price_currency":"JPY"
}
]
}
&url=https://ads-api.x.com/12/measurement/conversions/##PIXEL_ID##

• 以下、置き換えが必要な変数

  • ##CLIENT_ID##: サブスクラインのクライアントID。

    • ・LINEログインを利用中の場合（ミニアプリを登録していない場合）

      →弊社担当者に確認いただくか、現在利用中のLINEログインチャネル編集画面にて、一時的に「ミニアプリ」を選択し、下記「ミニアプリを利用中の場合」と同じ箇所にて確認してください。変更後、保存ボタンをクリックしないようご注意ください。

      ・ミニアプリを利用中の場合

      →LIFFアプリ編集画面（ミニアプリ）のエンドポイントURL内で確認可能です。

  • ##API_KEY##: 開発者ポータルの App 設定で発行したAPI KEYを指定
  • ##ACCESS_TOKEN##: Ads アカウントに紐づくAccess Tokenを指定
  • ##PIXEL_ID##: X広告ピクセルのID（ピクセルコード）。先ほど控えたIDを指定

  • ##HMAC_SIGNATURE##: コンバージョンイベント名。例：「CompleteRegistration」など​

• 以下、置き換え不要な変数

  • {line_user.hashId}: イベントの一意ID。重複計測防止のためのユニークなIDを設定（例：LINEユーザーID）​

  • {{now}}: コンバージョン発生時刻のタイムスタンプ（Unix秒）​

  • {referer.twclid}: X広告のクリックID​（LPからの引き継ぎが必要です）
  • {referer.signature}: X広告のOAuth認証に必要なsignature（LPからの引き継ぎが必要です）
    • signatureの作成方法はX開発者プラットフォームをご参照ください。

• 備考

  • 同一 event_id / conversion_id を Pixel にも付与すると 48 h 以内は deduplication されます。

---

4. 動作テスト & 運用

1. テスト広告 をクリック→LINE 友だち追加→数分～最大 24 h 後に Ads Manager のイベントタブで「TRACKING」ステータスを確認。

2. イベントが反映されない場合：

   • 署名パラメータ（oauth_timestamp など）が欠落していないか。

   • twclid が空でないか。

   • 15 分あたり 60 k 件の レート制限 を超えていないか。

---