システム連携仕様書
メディア様向けポストバック連携仕様書
ポストバック連携(ソケット連携)とは?
ポストバック機能とは、メディアの広告から流入したユーザーが、
広告主のサイトやサービスでコンバージョン(成果)を達成した際に、
そのデータをメディア側のシステムに送信する機能です。
ポストバック連携の仕組み
貴社
弊社
貴社とポイントバック連携(ソケット連携)の際では、
クリック発生時に貴社システム発行のセッションIDをCATSで受け取り、
成果発生時に貴社システム発行のセッションIDをCATSから渡します。
※セッションIDとは、CATSが1クリック毎のアクセスを管理する為の識別IDとなります。
ポストバック連携の際に貴社側で行っていただく内容
◆貴社システムでご設定頂く内容
①広告URLにパラメータを付与してください。
(クリック発生時に貴社システム発行のセッションIDをCATSで受け取るための設定です。)
②ポストバックURLをご教示ください。
(成果発生時に貴社システム発行のセッションIDをCATSから渡すための設定です。)
貴社
弊社
例)¶m1=[セッションID]
①広告URL ②CATSのパラメータ ③貴社の変数
※[]で囲まれた部分に変数を代入してください。
※上記はサンプルです。広告URLはCATSの管理画面より取得してください。
◆広告URL(メディア入稿URL)にパラメータを付与してください。
https://~~弊社ドメイン~~/cl/xxxxxxxxxxxxx/?bid=xxxxx¶m1=[セッションID]
・param1に貴社システムで発行するセッションIDの変数を付与して通知してください。
・param1で受け取った貴社発行セッションIDを成果発生時に貴社指定URLに付与してポストバックをいたします。
・bid=xxxxxは発行する広告URL単位で値が決定いたします。
1.クリック発生時のセッションID通知方法
・上記広告URLはサンプルURLとなりますので、入稿する広告URLは運営者管理画面より取得をしてメディア様へご入稿ください。
<貴社(CATS連携先のサービス様)のご対応>
<CATS運営者様のご対応>
◆ポストバックURLをご教示ください。
①ポストバックURL ②貴社のパラメータ ③CATSの変数
2.成果発生時の成果情報の受け取り方法
返却可能パラメータ | パラメータ説明 |
貴社のパラメータ | 貴社システムがリダイレクト時に発行したユニークID |
広告ID | CATS上で登録されている広告毎に発行されたID |
CATS発行セッションID | CATSで発行したセッションID |
成果情報 | 広告主様より成果時に通知されたユニークID(注文番号等) |
成果通知時、CATSから下記のパラメータを返却することが可能です。
※パラメータ名の変更が必要な場合は、別途担当までご連絡ください。
https://~~貴社ドメイン~~?xxx=xxx&xxx=xxx&xxx=xxx