1. CATS_FAQ
  2. 仕様書がほしい
  3. カートシステムと連携したい

【CATS】ECフォースとの成果連携

ECフォースとCATSの成果連携方法のページとなります。 ポストバック方式/タグ方式を選んでご対応下さい。

<目次>

ポストバック連携の場合はこちら

タグ連携の場合はこちら

<ポストバック連携の場合>

1.広告主向けマニュアル

カート管理画面の設定については以下の資料でカート運営者様向けにご案内しております。広告主様にポストバックURL(ソケット)の設置を依頼する際にご活用ください。

資料:【CATS】ECフォース運用者向け仕様書

2.ECフォースとの接続方法(ソケット通信設定)

ECフォース管理画面メニューより
「広告管理<ソケット通信管理」に遷移します。
新規作成を選択して、ポストバックURLを以下の通り設定します

<CATSの場合>

スクリーンショット 2024-05-21 115221
 登録内容(下記の内容を入力していきます。)
・名前:媒体名やサービス名等を入力
・通知先URL:catsで発行したポストバックURLを設定します。
 ECフォースご利用可能パラメータ
 セッションID(CATS発行):{sid}
 注文番号:{order_number}
設定例)
https://ac.yourdomain.com/xxxxxxxxxxxxxx/ac/?gid=◯◯&sid={sid}&uid1={order_number}
・通知方式:GETを選択 
・入力パラメータ1:sidと入力
※入力パラメータ1で設定したパラメータが弊社システムで設定する広告URLで利用するパラメータ名となります。
※入力パラメータ2以降には値を設定しないで下さい。※上記タグはサンプルです。実際に設置するタグは必ず管理画面より取得してください。

3.ポストバックURLの設定

ECフォース管理画面メニューより「広告管理>広告URL管理>対象広告URL>編集」に遷移します。
設定したポストバックURLと広告URLの紐付けを下記の通り行います。

スクリーンショット-2020-07-31-12.53.50のコピー-1024x306

登録内容(下記の内容を入力していきます。)
・セッション期限(日):ソケット通信のセッション保存期間を設定します。0は無制限という意味になります。
・ソケット通信:作成したポストバックURLを選択します。(選択するとグレー表示になります)

4.CATS管理画面上での設定

広告登録時に設定するECフォースのURL末尾に
&sid=##sessionId##
をつけて、広告登録をします。

例)
htttps://●●.jp?u=●●&sid=##SID##

<タグ連携の場合>

1.ECフォースとの接続の仕方(成果通知タグ「JSタグ」)

ECフォース管理画面より
「広告管理<LP管理<LPタグ管理<新規登録」に遷移します。
登録フォームが表示されますので以下の通りに登録を行います。

CATS-ECフォースタグ設定-1024x653

2.JSタグの設定

・広告主 … 登録している広告主名を選択
・タグ名 … タグ管理用の名前を入力
・説明 … タグの説明を入力
・タグ表示個所 … body 要素の最初に追加を選択

取得したJSタグに対して注文番号を取得できるように、
「使用できる変数一覧」より、適当なタグを選び設置いたします。
ECフォースご利用可能タグ
注文番号 … 
商品合計金額(税込み) … 
以下のように設置いたします。

設置例)

※下記はサンプルタグなのでこのまま設置しても動かないのでご注意ください。

<script>
(function(){
var gid="●●";
var sid="";
var uid1="";
var uid2="";
var amount=""
var uqid="1234567890ABCDEF";
var trackingUserId="";
var firstCookie=document.cookie;
var catsOptions={
};
var a=document.createElement("script");
a.src="//ac-自社ドメイン/ac/1234567890ABCDEF/action.js";
a.id="ac_1234567890ABCDEF";
a.addEventListener("load",function(){CATS_GroupAction(gid, sid, uid1, uid2, uqid,options);});
document.body.appendChild(a);
})();
</script>

取得する場所は、自社管理画面より「タグ管理 < グループ成果タグ一覧」に遷移します。該当する媒体の成果タグを取得そてください。

②ECフォース様管理画面にて、
広告管理<広告URL管理<広告URLID<編集
設定したタグと広告URLの紐付けを下記の通り行います。

ECフォース広告URL編集修正-1024x395

サンクスページ登録内容(下記の内容を入力していきます。)
・PCテンプレート … 設定をしたテンプレートを選択
・Mobile テンプレート … 設定をしたテンプレートを選択
・タグ … 登録をした「タグ名」を選択
※グレー表示が選択中のタグです。設定するタグはすべて選択(グレー表示)して下さい。