【AFAD】媒体とのポストバック連携(ソケット連携)方法

<動画解説>

目次

1.計測の仕組み

2.設定方法

3.注意点

4.セッションIDの保存形式

 

1.計測の仕組み

ポストバック連携とは?

ポストバック連携(ソケット連携)とは、媒体から流入したユーザーが、広告主のサイトでコンバージョン(成果)をした際に、広告主側計測システムから媒体側計測システムに成果データを送信する機能です。

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

ポストバック連携(ソケット連携)では通常、クリック時に媒体側システム発行のセッションID(CL付加情報)をAFADで受け取り、成果発生時にAFADがセッションID(CL付加情報)を媒体システムに渡します。
※セッションID:AFADが1クリック毎のアクセスを管理する為の識別IDとなります。

2. ポストバック機能の設定内容

媒体とポストバック連携を行う際は以下の手順を踏む必要がございます。

ステップ① 広告URLにパラメータを付与する

クリック発生時に媒体発行のセッションID(CL付加情報)をAFADで受け取るための設定です。

(1)クリックURLを発行してください。
登録手順③:クリックURLを発行する(リダイレクト計測の場合)

(2)クリックURLにパラメータを追加します。

媒体発行のセッションID(CL付加情報)を取得するための設定になります
※パラメータについては媒体により異なります。ご不明な場合は媒体にお問い合わせください。

【設定イメージ】

(param1がAFADのパラメータです。セッションID部分には媒体側のセッションIDパラメータを付与してください)
スクリーンショット 2024-09-05 18.28.36

※パラメータは、入稿URLに「?」が含まれていない場合は「?」で繋ぎ、「?」が含まれている場合は冒頭を「&」で繋いでください。

◎メディアに入稿するURLの末尾にパラメータを付与する際は連携ツールをご利用いただけます。
ツール: メディア入稿URLの自動生成ツール
ID : tooluser
PASS: 7n3odmH9hsq9NXx7

3. ご利用方法について

● メディア入稿URLの自動生成ツールをお使いいただくには、連携ツール画面上部の「メディア入稿URL生成」を選択してください。

1218_2.png

①管理画面よりクリックURLを発行してください。

②ご記入いただく項目は以下の2つです。
(1) クリックURL
(2) 御社システム:AFAD
(3) 連携先(会社名/ドメイン/システム名)

③末尾にパラメータがついた状態のものが出てきます。
表示されたURLをメディア様にお渡しください。

● メディアに仕様書を送る場合は以下をご活用ください。
資料:【メディア様向け】AFAD_ポストバック連携仕様書_1223

ステップ② ポストバックURLの設定する

成果発生時に媒体システム発行のセッションIDを媒体システムに渡すための設定です。
スクリーンショット 2024-09-05 18.31.20

(1)AFAD管理画面>パートナーサイト登録/編集画面> ポストバック通知方式>ソケットを選択

(2)広告が手動承認の場合は「承認待ち」、自動承認の場合は「承認」に設定してください。
どちらのパターンの広告とも紐づける場合は3つ全てに設定してください。
(全く同じURLを設定してしまうと、成果を重複して通知してしまう場合があるため、できる限り承認ステータスのパラメータを付与してください。)

ポストバック通知方式に入力するURLは以下の連携ツールをご利用いただけます。

ツール:ポストバックURL自動生成ツール
ID : tooluser
PASS : 7n3odmH9hsq9NXx7

参考:ワンタグ(ASP)連携ツールの使い方【ポストバックURL生成】

【使用可能変数】

下記の変数を使用することで媒体システム側に情報をお渡しすることが出来ます

変数 説明
##cid## 広告ID
##cname## 広告名
##gid## グループID
##clickAt## クリック日時(例.YYYYMMDDHHIISS)
##actionAt## コンバージョンが発生した日時
##admitAt## 成果確定日時(例.YYYYMMDDHHIISS)
##amount## コンバージョン時の売上金額
##retryCount## ポストバック送信回数
##commission## 報酬額
##estimatedCommission## 報酬予定額
##sessionId## セッションID
##programId## 成果番号
##point## 還元ポイント
##param1## CL付加情報1(パートナー指定ID)
##param2## CL付加情報2(パートナー指定ID)
##param3## CL付加情報3(パートナー指定ID)
##param4## CL付加情報4(パートナー指定ID)
##param5## CL付加情報5(パートナー指定ID)
##userId1## 注文番号等、ユーザーの成果ごとの固有のID
##userId2## 注文番号等、ユーザーの成果ごとの固有のID

 

3. ポストバック機能のご利用における注意点

・この機能を使用するためには、媒体側がポストバック機能を提供していることが前提となります。各媒体におけるポストバック機能の有無については、媒体側に直接お問い合わせください。
・各媒体でのポストバック可否について、弊社では動作保証を行っていません。そのため、お客様側で設定および事前テストを行っていただく必要があります。
・媒体側でエラー等が発生した際には、ポストバックURLの設定あるいは媒体側の入稿URLの設定を見直してください。媒体側のエラー状況等については、媒体側にお問い合わせください。

4.セッションIDの保存形式

セッション形式で弊社DBに保存します