【CATS】FacebookAPI連携のエラーの対処方法
本ガイドでは、CATS管理画面でFacebookAPI連携を利用する際に発生する可能性のあるエラーについて、エラー内容・原因・対処法を一覧でまとめています。
<目次>
1.エラー一覧と対処法
【設定時のエラー】(管理画面での操作時に表示されるエラー)
| エラーメッセージ | Facebook媒体からの情報取得に失敗しました |
|
原因 |
入力したアカウントIDやアクセストークンでFacebookから広告アカウント情報を取得できなかった |
| 対処法 | ① アカウントIDとアクセストークンが正しいか確認する ② Metaビジネスマネージャでトークンが有効か確認する ③ トークンの有効期限が切れていれば再発行する |
| エラーメッセージ | 認証されたFacebookアカウントには、取得できる広告アカウントが存在しません |
|
原因 |
トークン自体は有効だが、そのアカウントに紐づく広告アカウントが見つからない |
| 対処法 |
① Metaビジネスマネージャで該当アカウントに広告アカウントが紐づいているか確認する |
| エラーメッセージ | アクセストークンは必須です |
| 対処法 | アクセストークンが未入力 Metaビジネスマネージャのイベントマネージャからアクセストークンを取得して入力する |
| エラーメッセージ | 接続アカウント情報は必須です |
| 対処法 | 接続アカウント情報(メールアドレス)が未入力 Facebook連携に使用するアカウントのメールアドレスを入力する |
| エラーメッセージ | 既に登録されている連携名です |
|
原因 |
同じ連携名がすでにコンバージョンAPI連携設定に登録されている |
| 対処法 | 別の連携名を入力する(例:「Facebook連携_2」など重複しない名前にする) |
| エラーメッセージ | 存在しないAPI連携名です |
|
原因 |
広告のFacebookコンバージョン設定で選択したAPI連携名が、コンバージョンAPI連携設定に存在しない |
| 対処法 | 「設定 → コンバージョンAPI連携」でFacebook用の連携設定が登録されているか確認する、削除されている場合は再登録する |
| エラーメッセージ | ピクセルIDは必須です |
| 対処法 | ピクセルID(データセットID)が未入力 MetaイベントマネージャからピクセルIDをコピーして入力する |
| エラーメッセージ | 発生イベント名は必須です |
| 対処法 | イベント名が未入力 Facebookの標準イベント名を入力する(例:Purchase、Lead、CompleteRegistration など) |
| エラーメッセージ | 発生イベント名の入力形式エラー |
| 対処法 | イベント名に使用できない文字が含まれている 半角英数字・ハイフン(-)・アンダースコア(_)のみ使用可能 |
| エラーメッセージ | イベントソースURLの形式エラー |
| 対処法 | URLの形式が正しくない https:// で始まる正しいURL形式で入力する、空欄でもOK |
| エラーメッセージ | 登録情報エラー:登録情報を確認して下さい |
| 対処法 | 広告の登録情報全体に不整合がある 入力内容を全体的に見直し、必須項目がすべて正しく入力されているか確認する |
| エラーメッセージ | 存在しない媒体IDです |
| 対処法 | 指定した媒体IDがCATSに登録されていない CATS管理画面で正しい媒体IDを確認して入力する |
| エラーメッセージ | 存在しない広告IDです |
| 対処法 |
指定した広告IDがCATSに登録されていない CATS管理画面で正しい広告IDを確認して入力する |
【API実行時のエラー】(コンバージョン通知時にFacebook側から返されるエラー)
| エラーメッセージ | アクセストークンが不正です(Invalid OAuth access token) |
|
原因 |
登録したアクセストークンの形式が正しくない、またはコピー時に余分な文字が混入している |
| 対処法 |
① Metaビジネスマネージャのイベントマネージャからトークンを再コピーする |
| エラーメッセージ | アクセストークンを復号できませんでした(The access token could not be decrypted) |
|
原因 |
アクセストークンの有効期限が切れた、またはMeta側でアクセストークンが無効化された |
| 対処法 |
Metaイベントマネージャで新しいアクセストークンを再生成し、コンバージョンAPI連携設定で更新する |
| エラーメッセージ |
データセットID(XXXXXX)が不正です(Object does not exist / missing permissions) |
|
原因 |
指定したデータセットIDが存在しない、またはアクセストークンにそのデータセットの操作権限がない |
| 対処法 | ① Metaイベントマネージャで正しいデータセットIDを確認する ② トークン生成時のデータセットと設定のIDが一致しているか確認する ③ トークンの権限を確認する |
| エラーメッセージ | データセットIDは整数または整数文字列である必要があります |
| 対処法 | データセットIDに数字以外の文字が含まれている 数字のみで再入力する |
| エラーメッセージ | 認証エラー(AuthorizationException) |
| 対処法 | アクセストークンの権限不足、期限切れ、またはMetaアカウント側の問題 Metaビジネスマネージャでトークンの状態を確認し、必要に応じて再生成する。ビジネスアカウントの権限設定も確認する |
2.用語解説
| 用語 | 説明 |
| アクセストークン | FacebookのコンバージョンAPIに接続するための認証キー。Metaビジネスマネージャのイベントマネージャから取得する。 |
| データセットID | 旧称「ピクセルID」。コンバージョンデータの送信先を特定するためのID。Metaイベントマネージャで確認できる数字の文字列。 |
| イベント名 | コンバージョンの種類を示す名前(例:Purchase=購入、Lead=リード獲得、CompleteRegistration=登録完了)。 |
| イベントURL | コンバージョンが発生したページのURL。空欄の場合は自動設定される |
| テストイベントコード | API連携が正しく動作しているか確認するためのテスト用コード。一定時間で無効になるため、テストの都度取得が必要。 |
| マッチクオリティ | コンバージョンイベントをFacebookユーザーと紐付ける精度のスコア。顧客情報(メール・電話番号等)を多く送信するほど向上する。 |
| fbclid | Facebookがクリックやブラウザを識別するためのパラメータ。 |
ーーーーーーーーーーーーーーーーーーーーーーー
📅 最終更新: 2026年7月1日