コンテンツまでスキップ
日本語
サインイン
  • 検索フィールドが空なので、候補はありません。

【CATS】XとのAPI連携（オプション）

XコンバージョンAPIについて

X広告が提供するコンバージョンAPI機能です。
本機能を利用することでCATS/L-adが計測したコンバージョンをX広告管理画面へ反映する事ができます。

 

※本記事に記載されているX（旧Twitter）側の設定画面や手順は、記事作成時点のものです。Xの仕様変更により、事前の予告なく実際の画面や設定手順が変更される場合がございます。

また、X側の仕様変更に起因する動作不良や損害等につきましては、弊社では責任を負いかねますので、あらかじめご了承ください。最新の仕様についてはXの公式ドキュメント等をご確認ください。

 

＜連携手順＞

  1. X広告アカウントでコンバージョンAPIのアクセストークンを生成する
  2. X広告画面より情報を取得する
  3. CATS管理画面に設定する
  4. グループ計測タグを設置する（記事LPを利用する場合）
  5. 重複除外対策を行う（APIとピクセルタグを併用する場合）
  6. 媒体管理画面の確認方法
  7. 注意事項

 

 

 

1.X広告アカウントでコンバージョンAPIのアクセストークンを生成する

①ads.x.com にログインし、広告アカウントにアクセスします。

②「ツール」から「イベントマネージャー」を選択します。

「ツール」タブから 表示されない場合は、クレジットカードが登録されていない可能性があります。 

③「Install pixel（ピクセルのインストール）」をクリックし、実装方法と してConversion API」を選択します。 


 

④コンバージョンAPIのアクセストークンを生成します。

 

 

 

2.X広告画面より情報を取得する

X広告画面より以下の情報を取得してください。

①コンシューマーキー
②コンシューマーキーシークレット
③アクセストークン
④アクセストークンシークレット



☆取得方法

開発者アカウントにログインします。

  

左メニューのアプリから取得したいプロジェクトを選択します 

Keys and tokens にある 

OAuth 1.0 キーから
①コンシューマーキー
②コンシューマーキーシークレット
③アクセストークン
④アクセストークンシークレット
を取得します。

※Xの仕様上、シークレット情報は安全上、生成時に一度だけ表示され、後から再表示できないようになっています。

※再生成すると、以前のキー・トークンは無効になる可能性がありますので何かに設定している場合はそちらも更新をお願い致します。

   


 
 

 

 

 

3.CATS管理画面に設定する

XAPI連携登録・X媒体登録が必要になります。

＜XAPI連携登録＞

設定＞API連携登録＞X　を選択 

必須項目を入力します。 

  • API連携名：CATSで使用する名前です、任意の名称を入力します
  • APIキー：X側から取得した①コンシューマーキーを入力します
  • シークレットAPIキー：X側から取得した②コンシューマーキーシークレットを入力します
  • アクセストークン：X側から取得した③アクセストークンを入力します
  • シークレットトークン：X側から取得した④アクセストークンシークレットを入力します

 

＜X媒体登録＞

媒体管理＞媒体登録 / 媒体一覧　にて情報を記入します 

  • 成果地点：APIで通知したい成果を選択します
  • API連携名：登録したXのAPIを選択します
  • ピクセルID：広告のピクセルIDを入力します
  • イベントID：広告のイベントIDを入力します

 

 

 

4.グループ計測タグを設置する（記事LPを利用する場合）

Xへ記事LPを入稿している場合は、セッションIDをひき回すため、必ず記事LP内にCATSが発行したグループ計測タグを設置してください。 

 

 

 

5.重複除外対策を行う（APIとXイベントコードを併用する場合）

※Xイベントコードと弊社APIを併用される場合は、それぞれでCVをするため多重発火となります。
そのため、片方の成果を除外する『重複除外設定』が必須になります。
(弊社APIのみをご利用の場合は、不要になります)

 

☆タグ連携の場合

①Xイベントコードの書き換え
②CATSグループ成果タグの書き換え

 

①Xイベントコードの書き換え

Xのイベントコードに重複排除キーを取得するよう設置を行います。

 

※重複排除キーは成果発生時に発行される値をご設定ください。(例：注文番号、申込み番号、予約番号等)

 

②CATSグループ成果タグの書き換え

タグ管理＞グループ成果タグ＞JSタグ　より成果タグを取得し、
xAds: {conversion_id: ""},に重複排除キーを取得するよう設定する

 

 

☆ポストバック連携の場合

②CATSグループ成果タグの書き換え
③ポストバックURL（ソケット）の書き換え

③ポストバックURL（ソケット）の書き換え

タグ管理＞グループ成果タグ＞ソケットURLよりポストバック（ソケット）を発行し、重複排除を行うためのパラメータの追加します。


◯追記するパラメータ
&xAdsConversionId=重複排除キー(注文番号等)

 

 

 

6.媒体管理画面の確認方法 

☆媒体上での実行結果の確認方法

広告マネージャー＞Conversion Diagnostics

Conversion APIがWorkingになっている場合、API連携が完了です。

 

 

Conversion APIがNot set upになっている場合、X側でAPIの通知を受け取る事ができていない状態です。
設定を見直して頂くようにお願いいたします。

 

 

 

7.注意事項

 

 

 

 

 

ーーーーーーーーーーーーーーーーーーーーーーー

📅 最終更新: 2026年7月31日