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

A8.net 連携（卸し連携）

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

備考

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

概要​

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

A8ロゴ

  • 広告を卸す側：アフィリコード・システム
  • 広告を仕入れる側：A8.net
ご利用システムのIPアドレスの連絡について

A8.net側でAPI認証キーの取得にあたり、ご利用システムのIPアドレスを連絡する必要があります。

  • ご利用システムのIPアドレスは、納品時メールに、【 システム設置先のIPアドレス　XXX.XX.XXX.XX 】 のような記載でご連絡しております。
  • IPアドレスがご不明な場合は、サポートまでお問い合わせください。

A8.net Documents | API を使用する前の準備：
https://document.a8.net/a8docs/ecsales-api/ecsales-api-doc.html#api

主な機能​

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

発生成果の通知のみでよい場合は、標準のポストバック設定で連携してください。

  1. パラメータ設定　| メディア識別パラメータ ： パラメータ変換 pbid →　a8　
  2. ポストバック通知先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側の仕様詳細はドキュメントをご確認ください。

1. 連携に必要な情報を取得​

承認ステータスの連携を行う場合は、A8.netに確定APIの申請を行ってください。
広告主様からA8.netの営業担当者宛てに、APIの利用をお伝えいただく流れになります。

A8.net側の必要な情報は以下2点です。

  • APIキー
  • 対象のプログラムID（PGID）

2. アフィリコード・システムの設定​

2-1：事前確認​

事前に以下をご確認ください。
ポストバック通知（連携設定）は、メディア単位で行います。

  • 連携する広告の成果計測が成功している
  • 連携するアフィリエイターとメディアが登録済み。

2-2：連携設定​

ポストバック設定​

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

  • A8ポストバック設定画面に「APIキー」と「プログラムID」を入力します
  • 通知先URL設定などの必要はなく、設定に応じて自動で連携します

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

項目内容
A8ポストバック設定連携する場合は、設定する を選択
APIキーA8.netで発行されたAPIキーを入力
メディア識別パラメータ連携用のパラメータは、自動変換されます　pbid → a8
プログラムIDA8.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円報酬」は設定しないでください

3. 入稿​

広告管理 > 広告一覧 > 詳細 > アフィリエイトリンク
取得したアフィリエイトリンクを連携先の担当者に共有します。
※クリック識別子は、A8側で付与されます

4. 連携テスト​

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

5. API連携失敗時のメール通知​

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