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

【CATS】GoogleとのAPI連携方法(オプション)

<連携手順>

1. API用コンバージョンアクションを作成する

①コンバージョンアクションの作成ページに遷移

以下の手順で、コンバージョンアクションの作成を開始します。

メニュー > 作成 > コンバージョンアクション

 

②データソースの選択画面にて、「オフラインコンバージョン」を選択

CATS/L-adからGoogleAPIを使用して成果通知を行うため、オフラインコンバージョンを選択してください。
   
  

③該当するコンバージョンカテゴリを選択

イベントの内容に1番近いコンバージョンのカテゴリを選択してください。
   
  

④コンバージョンの発生元で「後で接続するデータソース」を選択

※環境や過去の設定内容によって異なる可能性があるため、ご確認ください。

「+コンバージョンを作成」を選択してください。

  
 
 ⑤オフラインデータソースの追加

 オフラインコンバージョンを選択する際にデータソースの選択が必須になります。

  

 「この手順を省略し、後でデータソースを設定する」を選択してください。
 
  

⑥コンバージョンアクションの作成を完了

このページ上で必要な設定はございません。
完了ボタンを押すと、新しいコンバージョンの作成が完了します。

以下の手順で、設定が完了しているかご確認いただけます。

メニュー>目標>コンバージョン>概要

コンバージョンの発生元が「ウェブサイト(クリックからのインポート)」で作成できていれば、コンバージョンアクションの作成は完了です。

  

※注意事項

①コンバージョンアクションのカウント方法について
コンバージョンアクションのカウント方法が「全件のみ」であることをご確認ください。
Googleの仕様にて「初回のみ」を指定する場合、gbraidまたはwbraidパラメータのCVは反映ができなくなります。(gclidのみ使用可能となります。)

スクリーンショット 2025-07-30 10.02.57

②コンバージョンアクション作成時の有効タイミングについて
API用のコンバージョンアクションは作成してから有効となるまで6時間程かかります。
有効後にコンバージョンの通知が受け取れるようになります。
有効前はイベント通知が受け取れません。(googleの仕様となります)

2. Google広告管理画面より情報を取得する

Google広告管理画面より以下の情報を取得してください。
①クライアント顧客ID ②コンバージョンアクションID

☆取得方法
①クライアント顧客ID
 管理画面の右上、アカウント名の上部にございます

G_CATS_2.png

②コンバージョンアクションID
 ツールと設定>コンバージョン>対象のコンバージョンを押下>アドレスバーのctlidを取得ください

無題のプレゼンテーション

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

設定>API連携登録>Google 選択

G_CATS_4.png

取得したクライアント顧客IDを記入してください
*クライアント顧客IDはそのままコピペいただく形で問題ございません

G_CATS_5.png

クライアント顧客ID設定後、Googleアカウント連携画面に遷移します。
『Sign in with Google』を押下して連携を完了します

G_CATS_6.png

Google連携時に

「Google広告のアカウントおよびデータの参照、編集、作成、削除。です」

のチェックボックスにチェックを入れます。

スクリーンショット 2024-12-03 11.46.55

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

1225_13.png

CATSの管理画面の設定は以上になります

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

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

スクリーンショット 2024-11-07 22.09.37

5. 重複除外対策を行う(APIとピクセルタグを併用する場合)

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

*タグ連携の場合:①と②を実施、ポストバック連携の場合:①と③を実施

①イベントスニペットタグの書き換え
 イベントスニペット上で注文番号を取得する設定をお願いします
 Google広告アカウントより取得したタグ内に変数を追記するようにクライアント様へお伝えください

G_CATS_8.png

②グループ成果タグの書き換え(タグ連携している場合)
 ソケット連携の場合は不要になります

 タグ管理>グループ成果タグ>JSタグ より成果タグを取得し、
 注文番号を取得頂くようにクライアント様へご依頼ください

G_CATS_9.png
G_CATS_10.png

③ポストバックURL(ソケット)の書き換え(ポストバック連携の場合)
 タグ連携の場合は不要になります
 
 タグ管理>グループ成果タグ>ソケットURLよりポストバック(ソケット)を発行し、
&googleAdsClickConversionOrderId=[注文番号]のパラメータを付け加えてください。

G_CATS_11.png
 
 
 

6. 注意事項

デマンドジェネレーションキャンペーンにおいて「最終ページURL」以外のURLへ遷移されるケースがございます。「最終ページURL」以外のページへ遷移した場合、計測パラメータが欠落し計測ができないケースがございます。
 
 
 

7. エラーの対処法

 
エラーメッセージ 対処法
コンバージョンアクションIDが正しくありません


CATS管理画面>媒体一覧>メニュー>  詳細>コンバージョンアクションIDに     正しいコンバージョンアクションIDが   設定されているかご確認ください


コンバージョンアクションがインポートに   対応していません


Google広告管理画面上で         インポートのコンバージョンアクションを 作成してください

コンバージョンアクションの設定で      One-per-clickが指定されている場合、      gbraid/wbraidは指定できません

コンバージョンアクションのカウント方法を全件に変更してください


Googleアカウントの再認証が必要です


CATS管理画面>設定>API連携一覧>   メニュー>詳細>[Sign in with Google]の  ボタンからGoogleアカウントの再認証を  行ってください

クリック日時が期間外です
クリック日時が期間外のため、        
API通知ができません


クライアント顧客IDで発行されたgclidでは   ありません


CATS管理画面>設定>API連携一覧>   メニュー>詳細>クライアント顧客IDに     正しいクライアント顧客IDが       設定されているかご確認ください 

クライアント顧客IDで発行されたwbraidでは   ありません
Google Ads API の内部エラーが生じました

Googleのサポートへお問い合わせください

Google OAuth サーバーの障害が生じました
Google OAuth サーバーがダウンしています
 
 
 

8.CATSからGoogle広告に送っている情報

1回のコンバージョンにつき、CATSからは以下の項目をGoogleへ送信しています。

GoogleAPI上の項目名 内容 CATSでの値
customer_id(送信先アカウント) 通知先となるGoogle広告アカウントのID  
conversion_action どのコンバージョン設定に紐づけるかを示すリソース名  
conversion_value 成果金額  
conversion_date_time 成果発生日時 Asia/Tokyo タイムゾーンで YYYY-MM-DD HH:MM:SS+09:00 形式 に変換
currency_code 金額の通貨コード JPY 固定
gclid / gbraid / wbraid のいずれか1つ 広告クリックを一意に特定するID 必ず1つだけセット(優先順位は2を参照)

 

 
 

9.Google広告パラメータの送信優先順位

CATSでは、Google広告へのコンバージョン通知を行う際、GoogleのAPI仕様に沿って以下のルールでパラメータを送信しています。

 

クリック識別子(gclid / gbraid / wbraid)の送信優先順位

Google広告のAPI仕様上、1件のコンバージョン通知に設定できるクリック識別子は、gclid・gbraid・wbraid のいずれか1つのみです。
そのためCATSでは、複数の識別子が取得できた場合、以下の優先順位で1つだけを選んで送信します。

 優先順位
 gclid > gbraid > wbraid

  • gclid:通常のGoogle広告クリックID
    主にPCブラウザやモバイルWebでの一般的なコンバージョン計測に使用されます。
  • gbraid:iOSアプリ関連のクリックID
    主にiOS14以降のプライバシー制約下で利用されます。
  • wbraid:iOSのWebトラフィック向けクリックID

※3つすべてが未取得の場合は、Googleへの送信は行われず、CATS側では送信失敗として記録されます。

 

 

 

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

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