afb
A8.net 連携（卸し連携）について解説します。
ドキュメントの内容は作成時点の仕様に基づいているため、連携先の仕様変更により一部の手 順や設定が異なる場合があります。
最新情報は、ご利用サービスの公式ドキュメントやサポートへご確認ください。
A8.net 連携｜概要
アフィリコード・システムから広告（案件）を卸す連携になります。
- 広告を卸す側 ： アフィリコード・システム
- 広告を仕入れる側 ： A8.net
主な機能
- 成果発生時の通知 ： システム連携によるポストバック通知
- 承認ステータスの連携 ： API連携による通知
- 管理者へのメール通知 ： ステータス連携が行えなかった場合のメール通知
発生成果の通知のみでよい場合は、標準のポストバック設定で連携してください。
- パラメータ設定 | メディア 識別パラメータ ： パラメータ変換
pbid→a8 - ポストバック通知先URL ： A8担当者から共有されたプログラムID（PGID）を
&pid=プログラムIDの形式で追記
通知仕様
成果発生時は標準のシステム連携による通知時と同様、指定したURLにポストバック通知を行います。 承認ステータスは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. 連携に必要な情報を取得
承認ステータスの連携を行う場合は、A8.netに確定APIの申請を行ってください。
広告主様からA8.netの営業担当者宛てに、APIの利用をお伝えいただく流れになり ます。
A8.net側の必要な情報は以下2点です。
- APIキー
- 対象のプログラムID（PGID）
A8.net 連携 | 2. アフィリコード・システムの設定
2-1：基本設定
- 連携する広告の成果計測が成功している
- 連携するアフィリエイターとメディアの登録が完了している
1. アフィリエイターを登録
登録がまだの方：アフィリエイターの登録2. メディアを登録
登録がまだの方：メディアの登録2-2：連携設定
ポストバック設定
成果発生時、A8に成果情報を送信するための設定を行います。
- A8ポストバック設定画面に「APIキー」と「プログラムID」を入力します
- 通知先URL設定などの必要はなく、設定に応じて自動で連携します
アフィリエイター管理 > メディア一覧 > 連携設定 > A8ポストバック設定
| 項目 | 内容 |
|---|---|
| A8ポストバック設定 | 連携する場合は、設定する を選択 |
| APIキー | A8.netで発行されたAPIキーを入力 |
| メディア識別パラメータ | 連携用のパラメータは、自動変換されます pbid → a8 |
| プログラムID | A8.netで発行されたプログラムIDを入力 |
| 通知タイミング | 全て通知（発生・承認／キャンセル） ※発生成果のみ通知する場合は、標準のポストバック設定を利用してください |
| ポストバックURL | 購入金額（price）、商品テーブル（pg）なし：https://px.a8.net/a8fly/earnings?a8={識別パラメータ}&pid={プログラムID}&so={成果ID}&si={ネット価格}-1-{ネット価格}-1購入金額（price）あり： https://px.a8.net/a8fly/earnings?a8={識別パラメータ}&pid={プログラムID}&so={成果ID}&si={購入金額}-1-{購入金額}-1商品テーブル（pg）あり： https://px.a8.net/a8fly/earnings?a8={識別パラメータ}&pid={プログラムID}&so={成果ID}&si={商品単価}-{商品数}-{商品合計金額}-{商品ID} |
ポストバックURLの通知詳細
| パラメータ | 内容 |
|---|---|
pid | 入力された プログラムID を通知 |
so | 連携照合用に一意のIDを通知。アフィリコード・システムの 成果ID を通知 A8側では「注文番号」としてレポートされます |
si | 購入金額（price）や商品テーブル（pg）を利用しない場合、ネット価格を通知 |
si | 商品テーブル（pg）を利用しないが、購入金額（price）がある場合、price 値を通知 |
si | 商品テーブル（pg）利用時は、pg=[] に格納された値を A8 側で受け取れるよう変換してポストバック複数商品がある場合は、 &si=商品1&si=商品2&si=商品3 のような形式で通知 |
| ― | 報酬額が0円の場合は、1 円で通知。基本的に「0円報酬」は設定しないでください |
A8.net 連携 | 3. 入稿
広告管理 > 広告一覧 > 詳細 > アフィリエイトリンク
取得したアフィリエイトリンクを連携先の担当者に共有します。
※クリック識別子は、A8側で付与されます
A8.net 連携 | 4. 連携テスト
a8で発行したURLから連携テストを行います。
両社で成果が発生したら、成果通知の連携は完了です。ステータスの連携は、成果発生翌日に確認してください。
A8.net 連携 | 5. API連 携失敗時のメール通知
承認ステータスの連携に失敗した場合（変更可能な期限後にステータス変更を行った等）は、管理者宛てにメールが通知されます。