1. CATS_FAQ
  2. 成果連携したい

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

【CATSの場合】

<連携手順>

1. Facebookイベントマネージャより、情報を取得する

用意して頂きたい情報

媒体管理画面より取得していただく情報は以下の通りです。
①データセットID(ピクセルID) / ②アクセストークン / ③イベント名

☆取得方法_
①データセットID(ピクセルID)
イベントマネージャー>データソース>設定>ピクセルID より取得いただけます
(管理画面上ではデータセットIDという名称になっております。)

②アクセストークン
イベントマネージャー>データソース>設定>アクセストークンを生成 
をクリックします。

2. CATSの管理画面に取得情報を設定する

●設定>ABI連携登録>Facebook で登録します
FB_3.png

API連携名/アクセストークンを入力し登録します。

 

● 媒体管理>媒体登録で設定を行います。
①API連携で「ON」を選択します。
②接続媒体で「Facebook」を選択します。
③コンバージョン発生地点を選択します。
④成果地点を選択します。
⑤API連携名で先ほど登録したアクセストークンを選択します。
⑥ピクセルIDを入力します。
⑦発生イベント名を入力します。
(?ボタンを押していただきますと、FBの標準イベント名一覧が表示されます。標準イベントをご利用の場合は該当のイベント名をコピーし、張り付けてください。)
⑧複数のアカウントとコンバージョン連携を行う際は右下の「+」ボタンよりコンバージョン登録を追加します。

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

facebookに記事を入稿する場合、かならず「記事」に「グループ計測タグ」を設置してください。
※計測タグの設置を行わない場合、FacebookコンバージョンAPIの計測が正常に行われない為、ご注意ください。
※既にCATSの計測タグをお使いになられている場合は再度タグ管理からグループ計測タグを取得してください。

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

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

☆重複除外対策とは?
ピクセルタグとAPIを併用される場合は、重複してCVになってしまいます。
そのため、片方のCVを除外する対策が必要となります。

①ピクセルタグの書き換え
 下記の記述をタグに追記してください
 fbq('track', 'Purchase', {value: 1, currency: 'JPY'}, {eventID: '[注文番号]'});
 [注文番号]は、クライアント様の変数をご設定ください
※イベント名を「purchace」に設定している場合のタグになります。送りたいイベント名に合わせてタグを書き換えてください。
※イベント発生時に注文番号等、成果ごとの固有のIDを取得できる場合のみ重複対策の設定を行うことができます。

FB_CATS_1.png

②成果タグの書き換え (タグ連携の場合)
タグ管理>グループ成果タグ>JSタグ より、タグを取得してください
下記の記述をタグに追記してください

  fb: {eventId: "注文番号"},

注文番号は、クライアント様の変数をご設定ください

※既にCATSの成果タグをお使いになっている場合は、新しく成果タグを取得するとAPI用のタグを取得することができます。

FB_8.png
FB_9.png

③ポストバックURL(ソケット)の書き換え (ポストバック連携の場合)
 タグ管理>グループ成果タグ>ソケット よりポストバックURL(ソケット)を発行してください

下記の記述を追記してください
&fbEventId=[注文番号]

FB_CATS_2.png

5. テストを行う

自分あてのメッセージにクリックURLを投稿し、クリック遷移する事で「Facebook経由での遷移」となります。このようにする事でFacebookが発行するセッションID(FBclid)が取得できます。
※スマートフォンのアプリではなく、ブラウザのメッセンジャーでテストを行ってください。

FB_AFAD_5.png

☆成果の確認方法
● CATS上の実行結果
ログ集計 > CAPI実行ログ
こちらのページでFBへの通知状況が確認できます。

FB_AFAD_3.png

確認していただく場所は3か所ございます。

①実行結果
Facebookへの通知自体が正しく出来ているかを確認できます。

FB_CATS_4.png

②イベント名
通知時に指定しているイベント名を確認いただけます。
意図したイベント名になっているかをご確認ください。

FB_CATS_5.png

③FBクリックID
Facebookが発行するセッションID(Fbclid)を取得できているか確認できます。
空欄の場合は取得に失敗しています。必ずFBのメッセンジャーからテストを行ってください。

FB_CATS_6.png

● 媒体上の実行結果
イベントマネージャ>データソース>対象のピクセル>概要
でイベントを受け取った履歴を確認することができます。

FB_AFAD_10.png

確認していただく場所は2か所ございます。
①イベントで指定したイベント名の記載があるか。
②統合で「サーバー」もしくは「コンバージョンAPI」の記載があるか。

FB_AFAD_11.png

6.注意点

iOS ATTの仕様により、APIよりイベント通知した場合でも、イベント計測がされない場合がございます。予めご了承ください。