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

【CATS】ポストバック連携の仕様

ポストバック連携の仕様・よくある質問に関してご案内します。

＜目次＞

  1. ポストバック連携とは
  2. 用語整理
  3. 連携パターン別の考え方
  4. パラメータの仕様
  5. よくある質問
    　・計測の仕様　
    　・ログの見え方
    　・設定に関する質問
    　・通知に関する質問
    　・パラメータに関する質問
    　・外部連携に関する質問

 

 

 

1.ポストバック連携とは

Q.ポストバック連携とは何ですか？　

　ポストバック連携とは、広告の成果（コンバージョン）情報をサーバー間でやりとりする仕組みです。

ポストバック連携の仕組み (1)


CATSでは、ポストバック連携は大きく2つの方法に分かれます。

 

 

CATSが成果を受け取るケース（上流からの受信）

上流のASP（広告主側）からCATSに対して「成果が発生した」という通知が送られてくるケースです。

広告主 / 上流ASP  →（成果通知）→  CATS

  • 上流ASPがCATSの成果受信URL（ポストバックURL）に対して、セッションIDや成果情報をパラメータとして送信します。
  • CATSはこの通知を受けて成果を記録し、必要に応じて下流（パートナー側）にポストバック通知を行います。

 

 

CATSが成果を送信するケース（下流への送信）

CATSが成果を記録した後、パートナー（媒体）側のシステムに対して成果情報を通知するケースです。

CATS  →（ポストバック通知）→  パートナー / 下流ASP

  • パートナーサイトに設定された通知先URLに対して、成果情報（広告ID、金額、セッションIDなど）をパラメータとして送信します。
  • パートナー側のシステムはこの通知を受け取り、成果を計測し自社のレポートへ反映します。

 

 

Q.API連携・タグ連携との違いは何ですか？

ポストバック連携と混同しやすい概念を整理します。

概念 内容 ポストバックとの違い
ポストバック連携 サーバー間で成果情報をやりとりする仕組み。ソケット方式。 ポストバック連携そのもの。
タグ連携 成果ページにJavaScriptタグを埋め込み、ブラウザ経由で成果を通知する方式。 成果の「取得方法」。CATSが成果を受け取る手段の1つ。ポストバックはその後の「送信」の話。
API連携 Facebook/Google/LINE/TikTokなど外部広告プラットフォームのAPIに成果を送信する仕組み。 ポストバック通知とは別に動作する外部API送信。パートナーへの通知ではなく、広告プラットフォームへの連携のこと。
ダイレクト計測 LPにタグを設置し、ブラウザ上でクリック計測を行う方式。 クリックの「計測方法」。成果通知とは別の概念。

 

 

 

2.用語整理

上流と下流について

用語

 意味
上流 成果を発生させる側。広告主、広告主側ASPのこと。
CATSに成果を通知してくる方向。
下流 成果通知を受ける側。パートナー（媒体）、媒体側ASPのこと。
CATSから成果を通知する方向。

 

セッションIDについて

セッションID

  • 広告クリック時に発行されるユニーク値のこと（例：abcdef1234567890）
  • クリック情報と成果情報を紐づけるために使用する
  • 上流から成果を受け取る際も、下流に成果を送信する際も、セッションIDが情報連携の鍵になる

 

主要パラメータについて

パラメータ 用途
cid CATS発行の広告ID。どの広告の成果かを識別する。
gid CATS発行のグループID。広告グループ単位で成果を管理する場合に使用する。
sid CATS発行のクリック時に発行されるセッションID。
上流からの成果通知ではこのパラメータ名で送信する。
uid/uid2 広告ユーザーID。
注文番号や会員IDなど、成果確定時の照合に利用する。

param1~
param5

 パートナー指定のID。
クリック時にパートナーが付与し、ポストバック時にそのまま返却される。
amount 売上金額。定率報酬の場合、この値の%が報酬となる。
status 成果ステータス。1:承認待ち、2:承認、3:否認

 

 

 

3.連携パターン別の考え方

①CATSが成果を受信する場合

上流ASPや広告主がCATSに対して成果通知を行うパターンです。

 

Q.どの情報を受けとりますか？

CATSの成果受信URL（ポストバックURL）に対して、以下のパラメータを受け取ります。

 https://[計測用ドメイン]/[uniqueId]/ac/?cid=[広告ID]&sid=[セッションID]&uid=[成果情報1]&uid2=[成果情報2]&amount=[売上金額] 

パラメータ 必須 説明
cid 〇 広告ID（CATSで発行された広告のID）
sid 〇 セッションID（クリック時に発行されたID）
uid × 注文番号、会員IDなどユーザー識別ID（成果確定時の照合に利用）
uid2 × ユーザー識別ID その2
amount × 売上金額（定率報酬の場合は報酬計算に使用。定額報酬の場合は参考値として記録）

 

Q.セッションIDは必要ですか？

はい、必須です。 セッションID（afパラメータ）がないと成果を紐づけることができません。
セッションIDはクリック時に発行されるため、クリック計測が行われていることが前提です。

 

Q.どの成果が計上対象ですか？

  • クリックログに紐づくセッションIDが存在すること
  • 同じセッションID × 成果地点の組み合わせで重複成果がないこと（重複時はエラー）
  • 広告の稼働ステータスが有効であること
  • 提携関係が有効であること

 

 

②CATSが成果を送信する場合

CATSが成果を記録した後、下流のパートナーや媒体側ASPに対して成果情報を通知するパターンです。

 

Q.どの値を返すことができますか？

ポストバック通知先URLに、以下の置換パラメータ（マクロ）を埋め込むことで、成果情報を動的に送信できます。

値 マクロ 説明
広告ID ##CID## CATSの広告ID
セッションID

##SID##

 クリック時に発行されたセッションID
売上金額 ##AMOUNT## 広告主から通知された売上金額
パートナー指定ID

##PARA1##　～
##PARA5##

 パートナーがクリック時に付与した識別ID
ユーザーID ##CONTENT_UID1## 広告主が成果通知時に付与したユーザーID
トラッキングユーザーID ##TUID##  

相手ASP側の指定に合わせるべき項目

  • 通知先URL自体：相手ASPから指定されたURL
  • パラメータ名：CATSの「マクロ名」を相手ASPが指定したパラメータ名に組み込みます

 

Q.パラメータ名は相手依存ですか？

はい、パラメータ名は相手ASP依存です。
CATSが送信する「値」は固定ですが（マクロで定義）、それをURLのどのパラメータ名に入れるかは、相手ASPの仕様に合わせて設定します。

例：

  • 相手が session_id で受け取る場合 → ?session_id={sessionId}
  • 相手が afid で受け取る場合 → ?afid={sessionId}

 

 

③多段連携の場合

上流ASPからCATSを経由して、さらに下流の媒体へ成果情報を通知するパターンです。

上流ASP（広告主側）  →  CATS  →  下流パートナー（媒体側）

 

ASP → CATS → 媒体の流れ

  1. 上流ASPがCATSの成果受信URLに通知
    上流ASPから af=セッションID を含む成果通知がCATSに届きます。
  2. CATSが成果を記録
    セッションIDをもとにクリック情報と紐づけ、成果を記録します。
  3. CATSが下流パートナーにポストバック通知
    パートナーサイトに設定された通知先URLに対して、マクロで置換した成果情報を送信　　します。

 

CATSコードを使った時に、どこまで通知されるかの考え方

  • 上流からの受信時： CATSのセッションIDを使ってクリックと成果を紐づけます。上流ASPが送信してきたパラメータ（uid, amount等）はCATSに記録され、ポストバック通知時にマクロで下流に転送できます。
  • 下流への送信時： パートナーサイトの通知先URLに設定されたマクロの範囲でのみ通知されます。マクロに設定されていない情報は下流に渡りません。
  • param1～param5： クリック時にパートナーが付与した値がそのまま保持され、ポストバック時に {param1} ～ {param5} で返却されます。これは媒体側のユーザー識別に利用されます。
  • userId1～userId25： 広告主が成果通知時に付与した値で、{userId1} ～ {userId25} で返却可能です。

 

 

4.パラメータの仕様

「どのパラメータが使えるか分からない」という質問が最も多いため、以下の表をご活用ください。

通知先URLで使用できる置換パラメータ（マクロ）一覧

マクロ 説明 値の例 備考
{CID} 広告ID    
{CONTENT_UID1}~
{CONTENT_UID25}		 広告ユーザーID （成果通知時に付与された値） 広告主が成果通知時に設定

{AMOUNT}

 売上金額 1000  
{SID} セッションID abcdef1234567890  

{PARA1}~
{PARA5}

 パートナー指定ID （クリック時に付与された値） パートナーがクリック時に設定

注意： ポストバック通知先URLの文字数上限は 1,024文字 です。多くのマクロを使用する場合はご注意ください。

 

 

5.よくある質問

＜計測の仕様＞

Q. セッションが切れた場合はどうなりますか？

A. セッションIDはクリック時に発行され、Cookie（広告ごとに設定された有効期限：1～365日）に保存されます。

  • Cookie有効期限が切れた場合： Cookie方式での成果計測は行えません。ただし、ソケット連携の場合はブラウザのCookieに依存しないため、セッションIDを広告主側のサーバーで保持していれば計測可能です。
  • ソケット連携の場合： セッションIDを上流ASPのサーバーで管理しているため、Cookieの有効期限切れの影響は受けません。セッションIDが正しく保持されていれば成果計測は可能です。

 

Q. リピートCV（繰り返しのコンバージョン）は取得できますか？

A. 同一セッションID × 同一成果地点の組み合わせでの重複成果はエラーとなります。

  • 同じユーザーの同じクリックに対して、同じ成果地点で2回目の成果通知が来た場合は「重複成果」として弾かれます。
  • ただし、異なる成果地点（pid）での成果は別扱いです。成果番号（pid: 1～10）を使い分けることで、同一セッションで複数の成果地点を計測できます。
  • 広告UID重複判定の設定により、同一ユーザーIDでの成果を一定期間ブロックすることも可能です。

 

Q. ダイレクト計測との併用は可能ですか？

A. はい、可能です。
ダイレクト計測はクリックの計測方式であり、ポストバック連携は成果通知の送信方式です。両者は別の概念のため併用できます。

  • ダイレクト計測でクリックを計測 → ソケット連携で成果を受信 → ポストバック通知で成果をパートナーに送信
  • ダイレクト計測でクリックを計測 → 成果タグで成果を受信 → ポストバック通知で成果をパートナーに送信

いずれのパターンも問題なく動作します。

 

Q. ステータス連携は可能ですか？

A. いいえ、不可能です。
CATSではステータス連携は仕様上できかねます。

 

＜ログの見え方＞

Q. レスポンスログで同一IPが表示されるのはなぜですか？

A. ソケット方式のポストバック通知は、CATSのサーバーから送信されるためです。

  • ソケット方式では、CATSサーバー（固定のキックバック用IP）からパートナーの通知先URLにアクセスします。
  • そのため、レスポンスログではCATSサーバーのIPアドレスが表示されます。
  • COOKIE方式やJavaScript方式の場合は、ユーザーのブラウザ経由で通知されるため、ユーザーのIPが記録されます。

 

Q. User-Agentに「Kickback/1.0」と表示されるのはなぜですか？

A. CATSのソケット方式のポストバック通知では、User-Agentとして Kickback/1.0 が使用されます。これはCATSサーバーからのサーバー間通信（ポストバック連携）であることを示しています。

相手ASP側のログでこのUser-Agentが見える場合は、CATSからのポストバック通知が正常に送信されていることを意味します。

 

＜設定に関する質問＞

Q. ポストバック通知方式はどれを選べばよいですか？

A. ソケット方式 を推奨します。サーバー間通信のため精度が高く、Cookie制限の影響を受けません。パートナー側にサーバー環境がない場合は、COOKIEまたはJavaScript方式をご利用ください。

 

Q. 否認時の通知方式を変更できますか？

A. いいえ、否認時の通知方式は ソケット方式に固定 されています。否認はバッチ処理で行われるため、ブラウザ経由の通知方式は使用できません。

 

Q. JavaScript通知はどの計測方式でも使えますか？

A. いいえ。JavaScript通知は 成果タグ計測（ブラウザ経由）の場合のみ 利用可能です。ポストバック連携で成果を受信した場合は、JavaScriptの実行環境がないため使用できません。

 

Q. 通知先URLの文字数制限はありますか？

A. 最大1,024文字 です。多くのマクロを使用する場合は文字数にご注意ください。

 

Q. JavaScriptタグの文字数制限はありますか？

A. 最大5,000文字 です。

 

＜通知に関する質問＞

Q. ポストバック通知が届きません。

A. 以下をご確認ください：

  1. パートナーサイトの通知方式が「利用しない」になっていないか
  2. 通知先URLが正しい形式（http:// または https://）で設定されているか
  3. 広告側の計測方式との組み合わせに問題がないか（ソケット計測 × JavaScript通知は不可）
  4. レスポンスログで通知結果とエラーメッセージを確認

 

Q. ポストバック通知に遅延があります。

A. ソケット方式では、非同期処理（Redis JOBキュー + バッチサーバー経由）で通知を行うため、最大60秒程度のタイムラグ が発生する場合があります。これは正常な動作です。

 

Q. 同じ成果に対してポストバックが複数回送信されませんか？

A. 同じセッションID × 成果ステータスの組み合わせに対する重複チェックが実装されています。初回通知済みの場合は重複送信されません。


Q. 通知が失敗した場合、自動的にリトライされますか？

A. ソケット方式の場合のみ 、30分間隔の自動リトライが行われます。COOKIE方式・JavaScript方式はブラウザ経由のためリトライ機能はありません。

 

＜パラメータに関する質問＞

Q. 通知先URLのマクロが置換されません。

A. マクロの記法（{sessionId} など）が正確か確認してください。大文字・小文字の区別があります。利用可能なマクロ名は「パラメータ仕様」セクションをご参照ください。


Q. CONTENT_UID3以降のパラメータは使えますか？

A. はい、{CONTENT_UID3} ～ {CONTENT_UID25} まで利用可能です。ただし、途中で追加されたパラメータのため、広告主からの成果通知に含まれていない場合は空文字になります。


Q. 改ざん検知機能とは何ですか？

A. ポストバック通知URLのパラメータ値をHMAC-SHA256でハッシュ化し、ハッシュ値をURLに付与する機能です。パートナー側で同じ秘密鍵を使ってハッシュを検証することで、データの改ざんがないことを確認できます。

 


＜外部連携に関する質問＞

Q. CAPI（Conversion API）連携とポストバック連携の違いは何ですか？

A. ポストバック連携はパートナー（媒体）への成果通知です。CAPI連携はFacebook/Google/LINE/TikTok/Yahoo!などの広告プラットフォームへの成果データ送信で、ポストバック連携とは独立して動作します。パートナーサイトごとにON/OFF設定できます。


Q. 対応しているCAPIは？

A. Facebook Conversion API、Google Conversion API（CSV連携）、Google Ads Click Conversion API、Yahoo! Conversion API、Yahoo! ディスプレイ広告 Conversion API、TikTok Events API、LINE Conversion APIに対応しています。

 

 

本FAQは CATS システムのポストバック連携機能についてまとめたものです。ご不明点がございましたら、サポート窓口までお問い合わせください。

 

 

 

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

📅 最終更新: 2026年6月1日