メインコンテンツまでスキップ

afb

A8.net 連携（卸し連携）

A8.net 連携（卸し連携）について解説します。

備考

ドキュメントの内容は作成時点の仕様に基づいているため、連携先の仕様変更により一部の手順や設定が異なる場合があります。
最新情報は、ご利用サービスの公式ドキュメントやサポートへご確認ください。

A8.net 連携｜概要​

アフィリコード・システムから広告（案件）を卸す連携になります。

A8ロゴ

広告を卸す側アフィリコード・システム
広告を仕入れる側A8.net

主な機能​

  • 成果発生時の通知 ： ソケット連携によるポストバック
  • 承認ステータスの連携 ： API連携による通知
  • 管理者へのメール通知 ： ステータス連携が行えなかった場合のメール通知
成果通知のみ連携する場合

発生成果の通知のみでよい場合は、標準のポストバック設定を行ってください。
追加パラメータ設定 ： pbid →　a8　　kbp1 → pid

A8.net 連携｜事前準備​

承認ステータスの連携を行う場合は、A8.netに確定APIの申請を行ってください。

広告主様からA8.netの営業担当者宛てに、APIの利用をお伝えいただく流れになります。

A8.net 連携｜通知詳細​

成果発生時は標準のポストバックと同様、ソケット通信で通知します。承認ステータスはAPIで連携します。

承認ステータス連携の期限

APIによる承認ステータスの変更は、A8側で「売上データの確定・キャンセル処理」が行われた当日のみとなります。

連携イメージ ① ： 成果を自動承認にしている場合

  • 9/1　アフィリコード：成果発生時にポストバック通知 →　A8：未確定売上データとして処理される
  • 9/2　アフィリコード：成果発生翌日（AM2:00）に確定通知　→　A8：確定売上データを処理

ステータス連携フロー

連携イメージ ② ： 成果を手動承認にしている場合

  • 9/1　アフィリコード：成果発生時にポストバック通知 →　A8：未確定売上データとして処理される
  • 9/3　アフィリコード：未承認から承認に切り替え　→　A8：確定売上データを処理
  • A8側は「基本的に、未確定売上となってから45日経過後、成果が自動的に確定される」という仕様です。
    アフィリコード側で「未承認のまま＝（未確定のまま）」経過した成果は、A8側で「45日経過後」に確定処理されます。

ステータス連携フロー

A8側の仕様詳細はドキュメントをご確認ください。

A8.net 連携｜基本手順​

事前確認
  • 連携する広告の成果計測が成功している
  • 連携するアフィリエイターとメディアアカウントの登録が完了している
1. アフィリエイターを登録登録がまだの方：アフィリエイターの登録2. メディアを登録登録がまだの方：メディアの登録3. ポストバック設定

成果発生時、A8に成果情報を送信するための設定です。

専用の設定画面から成果ステータスの連携に使用するAPIキーを入力してください。
その他は特に設定の必要はなく、自動で連携します。 設定（通知する値）は管理画面の表示どおりです。

アフィリエイター管理 > メディア一覧 > 連携設定 > A8ポストバック設定 a8ポストバック設定

A8ポストバック設定連携する場合は、設定する を選択
APIキーA8広告に設定したAPIキーを入力
通知タイミング

全て通知（発生・承認／キャンセル）
※発生成果のみ通知する場合は、標準のポストバック設定を利用してください

ポストバックURL

購入金額（price）、商品テーブル（pg）なし：
https://px.a8.net/a8fly/earnings?a8={クリック識別パラメータ}&pid={s0000000****0**}&so={注文番号}&si={ネット価格}-1-{ネット価格}-1

購入金額（price）あり：
https://px.a8.net/a8fly/earnings?a8={クリック識別パラメータ}&pid={s0000000****0**}&so={注文番号}&si={購入金額}-1-{購入金額}-1

商品テーブル（pg）あり：
https://px.a8.net/a8fly/earnings?a8={クリック識別パラメータ}&pid={s0000000****0**}&so={注文番号}&si={商品単価}-{商品数}-{商品合計金額}-{商品ID}

連携パラメータ

ポストバック連携用のパラメータは、自動変換されます
pbid → a8　　 kbp1 → pid

ポストバックURLの通知内容

成果発生時のトラッキング状況により、システムで適切に処理されます。 　

  • soパラメータで連携照合用に一意のIDを通知する必要があります。アフィリコード・システムの成果IDを通知します。
  • 購入金額（price）、商品テーブル（pg）を利用しない場合は、siパラメータでネット価格を通知します。
  • 商品テーブル（pg）は利用しないが、購入金額（price）がある場合は、siパラメータでprice値を通知します。
  • 商品テーブル（pg）利用時は、pg=[] に格納された値をA8側で受け取れるように変換してポストバックします。
    複数商品がある場合は、&si=商品1&si=商品2&si=商品3のような形式で通知します。
  • 報酬額が0円の場合は、1円で通知します。基本的に「0円報酬」は設定しないでください。

4. アフィリエイトリンクの取得・共有 広告管理 > 広告一覧 > 詳細 > アフィリエイトリンク
取得したアフィリエイトリンクの末尾に &a8=[pbid]&pid=[kbp1] を追記してください。

https://アフィリコードドメイン/link.php?i=****&m=****&a8=[pbid]&pid=[kbp1]

入稿URLとして連携先の担当者に共有してください。

詳細 ： アフィリエイトリンク

5. 連携テスト a8で発行したURLから連携テストを行ってください。
両社で成果が発生したら、成果通知の連携は完了です。ステータスの連携は、成果発生翌日に確認してください。

A8.net 連携｜API連携失敗時のメール通知​

承認ステータスの連携に失敗した場合（変更可能な期限後にステータス変更を行った等）は、管理者宛てにメールが通知されます。