【CATS】GoogleAPI連携のエラーの対処方法

【API連携時のエラー】（コンバージョン通知時に表示・記録されるエラーメッセージ）

エラーメッセージ	コンバージョンアクションIDが正しくありません
原因	指定したコンバージョンアクションID（conversion_action）がGoogle広告側に存在しない、または誤っている
対処法	CATS管理画面＞媒体一覧＞メニュー＞詳細＞コンバージョンアクションIDに、正しいコンバージョンアクションIDが設定されているかご確認ください

エラーメッセージ	コンバージョンアクションがインポートに対応していません
原因	対象のコンバージョンアクションが「インポート（値のインポート）」に対応した種類になっていない
対処法	Google広告管理画面上で、インポートのコンバージョンアクションを作成してください

エラーメッセージ	コンバージョンアクションの設定でOne-per-clickが指定されている場合、gbraid/wbraidは指定できません
原因	カウント方法が「One-per-click（1クリックにつき1回）」の場合、gbraid / wbraid での通知はGoogle側で受け付けられない
対処法	コンバージョンアクションのカウント方法を「すべてのコンバージョン」に変更してください

エラーメッセージ	Googleアカウントの再認証が必要です
原因	Google認証情報（リフレッシュトークン）が失効し、API接続の再認証が必要になっている
対処法	CATS管理画面＞設定＞API連携一覧＞メニュー＞詳細＞[Sign in with Google]のボタンから、Googleアカウントの再認証を行ってください

エラーメッセージ	クリック日時が期間外です
原因	gclid等のクリック日時が有効期間（一般に90日）を超過しており、API通知ができない
対処法	クリック日時が期間外のため、API通知はできません。gclid取得から有効期間内に成果が連携されるフローになっているかご確認ください

エラーメッセージ	クライアント顧客IDで発行されたgclidではありません
原因	通知先のクライアント顧客ID（customer_id）と、gclidが発行されたアカウントが一致していない
対処法	CATS管理画面＞設定＞API連携一覧＞メニュー＞詳細＞クライアント顧客IDに、正しいクライアント顧客IDが設定されているかご確認ください

エラーメッセージ	クライアント顧客IDで発行されたwbraidではありません
原因	通知先のクライアント顧客ID（customer_id）と、wbraidが発行されたアカウントが一致していない
対処法	CATS管理画面＞設定＞API連携一覧＞メニュー＞詳細＞クライアント顧客IDに、正しいクライアント顧客IDが設定されているかご確認ください

エラーメッセージ	Google Ads API の内部エラーが生じました
原因	Google Ads API側で一時的な内部エラーが発生している（Google側の問題）
対処法	Googleのサポートへお問い合わせください

エラーメッセージ	Google OAuth サーバーの障害が生じました
原因	Google OAuthサーバー側で障害が発生している（Google側の一時的なダウン）
対処法	Google OAuthサーバーの復旧をお待ちいただくか、Googleのサポートへお問い合わせください

【エラーメッセージが表示されないケース】

エラーメッセージ	クリック識別子（gclid / gbraid / wbraid）がすべて空で、Googleに送信されず失敗として記録される
原因	成果に紐づくクリックID（gclid等）が1つも取得できていない（クリック計測前の直アクセス、計測パラメータの欠落など）
対処法	① 広告リンクに gclid 等が正しく付与されているか確認する ② 計測タグ・リダイレクトが正しく動作しているか確認する

【重複について】

CATSは注文ID（order_id）をGoogleへ送っていないため、Google側の重複排除機能は働きません。同一の成果イベントが複数回連携されると、Google管理画面上でも重複してカウントされる可能性があります。

【対処時のポイント】

顧客から「Google広告の管理画面にコンバージョンが表示されない」と問い合わせがあった際は、まずCATS管理画面上のCAPI実行ログで「送信成功／失敗」を確認してください。

用語	説明
gclid	通常のGoogle広告クリックID。PCブラウザやモバイルWebでの一般的なコンバージョン計測に使用。
gbraid	iOSアプリ関連のクリックID。iOS14以降のプライバシー制約下で使用。
wbraid	iOSのWebトラフィック向けクリックID。
conversion_action	どのコンバージョン設定に紐づけるかを示すGoogle広告側のリソース名。
MCC（Login Customer ID）	代理店管理アカウント。配下の複数アカウントをまとめて管理する。無い場合は顧客アカウントIDを使用。
Refresh Token	CATSアプリケーション自体がGoogle広告APIを利用するための資格情報。

Q. Google広告の管理画面にコンバージョンが表示されないのはなぜですか？

A. まずCATSのCAPI実行ログをご確認ください。通知自体が失敗している場合はエラー内容をご案内します。通知が成功している場合は、Google広告側の反映タイミング（数時間〜最大数日）や、コンバージョンアクションの設定、gclidの有効期限（90日）等の可能性がございます。

Q. 同じ成果が2回計上されました。

A. CATS側では重複排除を行っていません。同一の成果イベントが2回連携された場合、2回通知します。またCATSからは注文IDをGoogleへ送っていないため、Google側での重複排除も働きません。

Q. iOSアプリ経由の成果は通知されますか？

A. gbraid / wbraid を用いて通知しています。ただし gclid が取得できているケースを優先して送信します。

Q. 外貨（USD等）で成果を通知できますか？

A. 現時点では日本円（JPY）固定の実装となっており、外貨アカウントには対応していません。

Q. メールアドレスや電話番号を使った拡張コンバージョン（Enhanced Conversions）は使えますか？

A. 現時点では未対応です。gclid等のクリック識別子のみで通知しています。

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

A. されません。CATS側ではアプリケーションリトライを行っておらず、失敗した場合はログに記録され、そのまま確定します（一時的なネットワーク不調でも自動再送はされません）。

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

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

CATS管理画面でGoogleAPI連携を利用する際に発生する可能性のあるエラーについて、エラー内容・原因・対処法を一覧でまとめています。