---
title: 【AFAD】XとのAPI連携（オプション）
description: 　
---

[コンテンツまでスキップ](https://support.markecats.co.jp/cats-faq/-afad-xapi-0#main-content)

日本語

翻訳のサブメニューを表示

![★背景透過\_白地用.png\]](https://support.markecats.co.jp/hs-fs/hubfs/%E2%98%85%E8%83%8C%E6%99%AF%E9%80%8F%E9%81%8E_%E7%99%BD%E5%9C%B0%E7%94%A8.png?height=40&name=%E2%98%85%E8%83%8C%E6%99%AF%E9%80%8F%E9%81%8E_%E7%99%BD%E5%9C%B0%E7%94%A8.png)

メインナビゲーションを開く

メインナビゲーションを閉じる

- 日本語
  
  翻訳のサブメニューを表示

 CATS FAQ

- 検索フィールドが空なので、候補はありません。

1. [CATS\_FAQ](https://support.markecats.co.jp/cats-faq?hsLang=ja)
2. [API連携の設定方法](https://support.markecats.co.jp/cats-faq/api%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja)
3. [AFAD](https://support.markecats.co.jp/cats-faq/api%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#afad)

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

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

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

 

 

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

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

 

#### **＜連携手順＞**

1. [**X広告アカウントでコンバージョンAPIのアクセストークンを生成する**](https://support.markecats.co.jp/cats-faq/-afad-xapi-0#x1)
2. [**AFAD管理画面に設定する**](https://support.markecats.co.jp/cats-faq/-afad-xapi-0#x2)
3. [**グループ計測タグを設置する（記事LPを利用する場合）**](https://support.markecats.co.jp/cats-faq/-afad-xapi-0#x3)
4. [**重複除外対策を行う（APIとピクセルタグを併用する場合）**](https://support.markecats.co.jp/cats-faq/-afad-xapi-0#x4)
5. [**媒体管理画面の確認方法**](https://support.markecats.co.jp/cats-faq/-afad-xapi-0#x5)
6. [よくある質問](https://support.markecats.co.jp/cats-faq/-afad-xapi-0#x6)

 

 

 

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

①[ads.x.com](http://ads.x.com) にログインし、広告アカウントにアクセスします。

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

「ツール」タブから 表示されない場合は、クレジットカードが登録されていない可能性があります。![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Jul-31-2026-05-36-18-9032-AM.png?width=670&height=322&name=undefined-Jul-31-2026-05-36-18-9032-AM.png)

③「Install pixel（ピクセルのインストール）」をクリックし、実装方法と してConversion API」を選択します。 ![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Jul-31-2026-05-37-27-3279-AM.png?width=546&height=309&name=undefined-Jul-31-2026-05-37-27-3279-AM.png)

![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Jul-31-2026-05-37-45-2674-AM.png?width=651&height=200&name=undefined-Jul-31-2026-05-37-45-2674-AM.png)

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

 

 

 

### **2.AFAD管理画面に設定する**

パートナー登録＞パートナーサイト登録の順に必要な情報を登録します。

 

#### **＜パートナー登録＞**

①パートナー管理＞パートナー登録/編集　をクリックします。

②X広告コンバージョンAPI認証情報＞追加　をクリックします。

③アクセストークンを入力し登録します。![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Oct-15-2026-07-40-15-8301-AM.png?width=670&height=121&name=undefined-Oct-15-2026-07-40-15-8301-AM.png) 

#### **＜パートナーサイト登録＞**

①パートナー管理＞パートナーサイト登録/編集　をクリックします。

②利用API設定＞X広告　を選択します。![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Oct-15-2026-07-43-28-4888-AM.png?width=670&height=107&name=undefined-Oct-15-2026-07-43-28-4888-AM.png) 

③必要な情報を入力し登録します。

- **アクセストークン**：先ほど作成した該当のアクセストークンを選択します
- **ピクセルID**：広告のピクセルIDを入力します
- **イベントID**：広告のイベントIDを入力します

 

 

 

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

Xへ記事LPを入稿している場合は、セッションIDをひき回すため、必ず記事LP内にCATSが発行したグループ計測タグを設置してください。![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Oct-15-2026-07-45-02-6917-AM.png?width=670&height=376&name=undefined-Oct-15-2026-07-45-02-6917-AM.png) 

 

 

 

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

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

 

#### **☆タグ連携の場合**

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

 

（詳細）

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

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

![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Jul-31-2026-07-44-53-1695-AM.png?width=670&height=232&name=undefined-Jul-31-2026-07-44-53-1695-AM.png) 

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

 

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

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

![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Oct-15-2026-07-45-57-9532-AM.png?width=652&height=539&name=undefined-Oct-15-2026-07-45-57-9532-AM.png)

 

 

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

①Xイベントコードの書き換え  
③ポストバックURL（ソケット）の書き換え

 

（詳細）

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

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

![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Jul-31-2026-07-44-53-1695-AM.png?width=670&height=232&name=undefined-Jul-31-2026-07-44-53-1695-AM.png)

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

 

 

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

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

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

**![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Jul-31-2026-07-49-18-9616-AM.png?width=631&height=44&name=undefined-Jul-31-2026-07-49-18-9616-AM.png)**

 

 

 

### **5.媒体管理画面の確認方法**

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

**広告マネージャー＞Conversion Diagnostics**

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

![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Jul-31-2026-07-53-32-8970-AM.png?width=670&height=300&name=undefined-Jul-31-2026-07-53-32-8970-AM.png) 

 

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

**![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Jul-31-2026-07-54-16-2509-AM.png?width=670&height=300&name=undefined-Jul-31-2026-07-54-16-2509-AM.png)**

 

 

 

### **6.よくある質問**

**Q. イベントマネージャーにコンバージョンが反映されません**

A. まずAFADのX広告コンバージョンログをご確認ください。エラーが出ている場合は内容に沿ってご対応をお願いします。送信成功と表示されている場合は、X側の反映遅延、クリックURLの設定不備（twclidの未紐付け）、またはピクセル設定エラーの可能性が考えられます。

**Q. 「twclid、email、phoneのいずれか1つは必要です」とエラーが出ます**

A. ユーザーの識別情報（XクリックID・メールアドレス・電話番号）が取得できていません。X広告の遷移先にAFADのクリックURLを設定するか、成果タグでメールアドレス／電話番号を連携してください。

**Q. ピクセルとAPIで成果が二重計測されます**

A. 重複排除のためには、成果タグとピクセル双方の「conversion\_id」に、注文番号などの一意な共通値を設定する必要があります。未設定の場合は二重計上となりますのでご注意ください。

**Q. 個人情報は暗号化（ハッシュ化）されて送信されますか？**

A. はい。ブラウザ上でSHA-256方式によりハッシュ化された上で送信されます。平文がAFADや外部へ渡ることはありません。

**Q. 成果金額は連携されますか？**

A. 現時点では未対応です。

**Q. 送信に失敗した通知は自動で再送されますか？**

A. 一時的な通信エラーなどは自動再送されます。ただし、トークン失効などの設定不備による失敗は再送されないため、設定修正後に成果の再登録を行ってください。

**Q. マッチング率（精度）を向上させるには？**

A. twclidが最も精度への寄与が大きい項目です。X広告の遷移先にクリックURLを設定し、計測タグによる引き継ぎでtwclidが成果ページまで渡るようにしてください。あわせて成果タグでemail / phoneを連携いただくと、twclidが無い場合でもマッチングできます。  
※ポストバックで成果計測している場合は、email/phoneは取得できないため、ご了承ください。

 

**★email / phoneの連携方法**

グループ成果タグの赤枠の箇所に、メールや電話番号を取得できる変数をそれぞれ追記します。  
 ![](https://support.markecats.co.jp/hs-fs/hubfs/undefined-Oct-19-2026-07-19-18-9831-AM.png?width=843&height=698&name=undefined-Oct-19-2026-07-19-18-9831-AM.png) 

変数でメールや電話番号を取得できた場合に、その情報をX広告へ返却します。

 

**Q. テスト送信機能はありますか？**

A. テスト専用モードはありません。X広告のイベントマネージャーにて、実際のイベント受信状況をご確認ください。

 

 

 

 

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

📅 最終更新: 2026年10月15日

- [スタートガイド](https://support.markecats.co.jp/cats-faq/%E3%82%B9%E3%82%BF%E3%83%BC%E3%83%88%E3%82%AC%E3%82%A4%E3%83%89?hsLang=ja#main-content)

    - [AFADスタートガイド](https://support.markecats.co.jp/cats-faq/%E3%82%B9%E3%82%BF%E3%83%BC%E3%83%88%E3%82%AC%E3%82%A4%E3%83%89?hsLang=ja#afad%E3%82%B9%E3%82%BF%E3%83%BC%E3%83%88%E3%82%AC%E3%82%A4%E3%83%89)
    - [CATSスタートガイド](https://support.markecats.co.jp/cats-faq/%E3%82%B9%E3%82%BF%E3%83%BC%E3%83%88%E3%82%AC%E3%82%A4%E3%83%89?hsLang=ja#cats%E3%82%B9%E3%82%BF%E3%83%BC%E3%83%88%E3%82%AC%E3%82%A4%E3%83%89)
    - [一括登録/編集/承認](https://support.markecats.co.jp/cats-faq/%E3%82%B9%E3%82%BF%E3%83%BC%E3%83%88%E3%82%AC%E3%82%A4%E3%83%89?hsLang=ja#%E4%B8%80%E6%8B%AC%E7%99%BB%E9%8C%B2-%E7%B7%A8%E9%9B%86-%E6%89%BF%E8%AA%8D)
- [L-adの設定方法](https://support.markecats.co.jp/cats-faq/l-ad%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#main-content)

    - [基本的な登録](https://support.markecats.co.jp/cats-faq/l-ad%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#%E5%9F%BA%E6%9C%AC%E7%9A%84%E3%81%AA%E7%99%BB%E9%8C%B2)
    - [友だち追加後の成果計測方法](https://support.markecats.co.jp/cats-faq/l-ad%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#%E5%8F%8B%E3%81%A0%E3%81%A1%E8%BF%BD%E5%8A%A0%E5%BE%8C%E3%81%AE%E6%88%90%E6%9E%9C%E8%A8%88%E6%B8%AC%E6%96%B9%E6%B3%95)
    - [エラー対応方法](https://support.markecats.co.jp/cats-faq/l-ad%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#%E3%82%A8%E3%83%A9%E3%83%BC%E5%AF%BE%E5%BF%9C%E6%96%B9%E6%B3%95)
- [タグ連携の設定方法](https://support.markecats.co.jp/cats-faq/%E3%82%BF%E3%82%B0%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#main-content)

    - [AFAD](https://support.markecats.co.jp/cats-faq/%E3%82%BF%E3%82%B0%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#afad)
    - [CATS](https://support.markecats.co.jp/cats-faq/%E3%82%BF%E3%82%B0%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#cats)
    - [GTM](https://support.markecats.co.jp/cats-faq/%E3%82%BF%E3%82%B0%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#gtm)
- [ポストバック連携の設定方法](https://support.markecats.co.jp/cats-faq/%E3%83%9D%E3%82%B9%E3%83%88%E3%83%90%E3%83%83%E3%82%AF%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#main-content)

    - [AFAD](https://support.markecats.co.jp/cats-faq/%E3%83%9D%E3%82%B9%E3%83%88%E3%83%90%E3%83%83%E3%82%AF%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#afad)
    - [CATS](https://support.markecats.co.jp/cats-faq/%E3%83%9D%E3%82%B9%E3%83%88%E3%83%90%E3%83%83%E3%82%AF%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#cats)
    - [システムとの連携](https://support.markecats.co.jp/cats-faq/%E3%83%9D%E3%82%B9%E3%83%88%E3%83%90%E3%83%83%E3%82%AF%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E3%81%A8%E3%81%AE%E9%80%A3%E6%90%BA)
- [カートシステムとの連携方法](https://support.markecats.co.jp/cats-faq/%E3%82%AB%E3%83%BC%E3%83%88%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E3%81%A8%E3%81%AE%E9%80%A3%E6%90%BA%E6%96%B9%E6%B3%95?hsLang=ja)
- [アプリ/チャットボットとの連携方法](https://support.markecats.co.jp/cats-faq/%E3%82%A2%E3%83%97%E3%83%AA-%E3%83%81%E3%83%A3%E3%83%83%E3%83%88%E3%83%9C%E3%83%83%E3%83%88%E3%81%A8%E3%81%AE%E9%80%A3%E6%90%BA%E6%96%B9%E6%B3%95?hsLang=ja#main-content)

    - [アプリ連携](https://support.markecats.co.jp/cats-faq/%E3%82%A2%E3%83%97%E3%83%AA-%E3%83%81%E3%83%A3%E3%83%83%E3%83%88%E3%83%9C%E3%83%83%E3%83%88%E3%81%A8%E3%81%AE%E9%80%A3%E6%90%BA%E6%96%B9%E6%B3%95?hsLang=ja#%E3%82%A2%E3%83%97%E3%83%AA%E9%80%A3%E6%90%BA)
    - [チャットボット連携](https://support.markecats.co.jp/cats-faq/%E3%82%A2%E3%83%97%E3%83%AA-%E3%83%81%E3%83%A3%E3%83%83%E3%83%88%E3%83%9C%E3%83%83%E3%83%88%E3%81%A8%E3%81%AE%E9%80%A3%E6%90%BA%E6%96%B9%E6%B3%95?hsLang=ja#%E3%83%81%E3%83%A3%E3%83%83%E3%83%88%E3%83%9C%E3%83%83%E3%83%88%E9%80%A3%E6%90%BA)
- [API連携の設定方法](https://support.markecats.co.jp/cats-faq/api%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#main-content)

    - [AFAD](https://support.markecats.co.jp/cats-faq/api%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#afad)
    - [CATS](https://support.markecats.co.jp/cats-faq/api%E9%80%A3%E6%90%BA%E3%81%AE%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95?hsLang=ja#cats)
- [ポストバック連携が失敗している](https://support.markecats.co.jp/cats-faq/%E3%83%9D%E3%82%B9%E3%83%88%E3%83%90%E3%83%83%E3%82%AF%E9%80%A3%E6%90%BA%E3%81%8C%E5%A4%B1%E6%95%97%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B?hsLang=ja#main-content)

    - [AFAD](https://support.markecats.co.jp/cats-faq/%E3%83%9D%E3%82%B9%E3%83%88%E3%83%90%E3%83%83%E3%82%AF%E9%80%A3%E6%90%BA%E3%81%8C%E5%A4%B1%E6%95%97%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B?hsLang=ja#afad)
    - [CATS](https://support.markecats.co.jp/cats-faq/%E3%83%9D%E3%82%B9%E3%83%88%E3%83%90%E3%83%83%E3%82%AF%E9%80%A3%E6%90%BA%E3%81%8C%E5%A4%B1%E6%95%97%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B?hsLang=ja#cats)
- [タグ連携が失敗している](https://support.markecats.co.jp/cats-faq/%E3%82%BF%E3%82%B0%E9%80%A3%E6%90%BA%E3%81%8C%E5%A4%B1%E6%95%97%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B?hsLang=ja#main-content)

    - [AFAD](https://support.markecats.co.jp/cats-faq/%E3%82%BF%E3%82%B0%E9%80%A3%E6%90%BA%E3%81%8C%E5%A4%B1%E6%95%97%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B?hsLang=ja#afad)
    - [CATS](https://support.markecats.co.jp/cats-faq/%E3%82%BF%E3%82%B0%E9%80%A3%E6%90%BA%E3%81%8C%E5%A4%B1%E6%95%97%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B?hsLang=ja#cats)
    - [GTM](https://support.markecats.co.jp/cats-faq/%E3%82%BF%E3%82%B0%E9%80%A3%E6%90%BA%E3%81%8C%E5%A4%B1%E6%95%97%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B?hsLang=ja#gtm)
- [実数値との乖離](https://support.markecats.co.jp/cats-faq/%E5%AE%9F%E6%95%B0%E5%80%A4%E3%81%A8%E3%81%AE%E4%B9%96%E9%9B%A2?hsLang=ja)
- [活用方法](https://support.markecats.co.jp/cats-faq/%E6%B4%BB%E7%94%A8%E6%96%B9%E6%B3%95?hsLang=ja#main-content)

    - [AFAD](https://support.markecats.co.jp/cats-faq/%E6%B4%BB%E7%94%A8%E6%96%B9%E6%B3%95?hsLang=ja#afad)
    - [CATS](https://support.markecats.co.jp/cats-faq/%E6%B4%BB%E7%94%A8%E6%96%B9%E6%B3%95?hsLang=ja#cats)
    - [その他](https://support.markecats.co.jp/cats-faq/%E6%B4%BB%E7%94%A8%E6%96%B9%E6%B3%95?hsLang=ja#%E3%81%9D%E3%81%AE%E4%BB%96)
- [よくある質問](https://support.markecats.co.jp/cats-faq/%E3%82%88%E3%81%8F%E3%81%82%E3%82%8B%E8%B3%AA%E5%95%8F?hsLang=ja)

[![★背景透過\_白地用](https://support.markecats.co.jp/hs-fs/hubfs/%E2%98%85%E8%83%8C%E6%99%AF%E9%80%8F%E9%81%8E_%E7%99%BD%E5%9C%B0%E7%94%A8.png?width=150&height=37&name=%E2%98%85%E8%83%8C%E6%99%AF%E9%80%8F%E9%81%8E_%E7%99%BD%E5%9C%B0%E7%94%A8.png "★背景透過_白地用")](http://markecats.co.jp)

markecats.co.jpヘルプセンター

Copyright © 2025, CATS株式会社