Copy Title & URL

Bookmark

Share

ポストバック連携（卸し連携）

ポストバック連携（卸し連携）

公開日： 更新日：

アフィリコード・システム

目次

ポストバック連携（卸し連携）とは？
アフィリコード・システムで管理している広告を、連携先システム（メディア）に卸すことです。
お互いのシステムに連携用URLを設定して計測します。
やることは大きく分けて2つあります。
  • 連携先システムのポストバックURLを設定する
  • 連携先の担当者に、アフィリエイトリンクを共有する
※以下、アフィリコード・システムをACSと略します

STEP1: 事前確認

連携先の担当者に以下を確認してください。

  • ポストバック連携の対応可否
  • ポストバック連携の仕様書
  • 連携先システムのパラメータ名
  • ポストバックURL
▼ 詳細を読む
● ポストバック連携の対応可否
ACSが連携先システムに成果通知を送信します。
送信先URL（ポストバックURL）が存在するか確認してください。
● ポストバック連携の仕様書
連携設定に必要な情報が記載されている場合があります。
● 連携先システムのパラメータ名
連携先システムは、計測に必要なIDをACSのアフィリエイトリンクに付与します。
例：
前）https://ACSドメイン/link.php?i=***&m=***
後）https://ACSドメイン/link.php?i=***&m=***&〇〇=[ID1]&△△=[ID2]
IDが付与されるパラメータの名前（〇〇、△△部分）を確認してください。
※ パラメータの数は連携先システムによって異なります
● ポストバックURL
ACSの成果情報を送信するための成果通知先URLです。

目次にもどる

STEP2: メディア識別パラメータ設定

メディア識別パラメータとは？
連携先システムの計測IDを保存するための機能です。
計測IDは4つまで保存できます。
  • pbid
  • kbp1
  • kbp2
  • kbp3
※ 初期設定の名前です
アフィリエイター管理 > メディア一覧 > 連携設定（追加パラメータ設定）
ポストバック連携_メディア連携設定 ポストバック連携_追加パラメータ

「STEP1: 事前確認」連携先システムのパラメータ名を確認してください。
連携先システムは、計測IDをACSのアフィリエイトリンクに追加します。

例
前）https://ACSドメイン/link.php?i=***&m=***
後）https://ACSドメイン/link.php?i=***&m=***&〇〇=[ID1]&△△=[ID2]

追加するパラメータの名前（〇〇、△△部分）を確認してください。
追加する数は、連携先システムによって異なります。

▼ 参考1：○○△△部分が、メディア識別パラメータと「同じ名前」の場合
連携先もアフィリコード･システムをご利用の場合はこちら
○○ が pbid、△△ が kbp1の例
https://ACSドメイン/link.php?i=***&m=***&pbid=[ID1]&kbp1=[ID2]
この場合、メディア識別パラメータの設定は不要です。
初期設定のままで、連携先システムの計測IDが保存できます。
▼ 参考2：○○△△部分が、メディア識別パラメータと「異なる名前」の場合
連携先が外部システムをご利用の場合はこちら
○○ が AAA、△△ が BBBの例
https://ACSドメイン/link.php?i=***&m=***&AAA=[ID1]&BBB=[ID2]
この場合、メディア識別パラメータの設定が必要です。
設定を書き換えて、保存してください。
例の場合では、以下の設定になります。
pbid → 「 AAA 」、kbp1 → 「 BBB 」
ポストバック連携_メディア識別パラメータ
パラメータの名前を設定すると、連携先システムの計測IDが保存できるようになります。

目次にもどる

STEP3: ポストバック設定

ポストバック設定とは？
ACSに保存されている計測IDや成果データを、連携先システムに通知（返却）するための設定です。
ACSから成果通知を受け取ることで、連携先システムでも成果が発生するようになります。
アフィリエイター管理 > メディア一覧 > 連携設定（ポストバック）
ポストバック連携_ポストバック設定

通知タイミング

成果発生時のみ
  • 成果の手動承認/自動承認関係なく、成果発生時点で通知します
  • 成果の承認状態の変更通知はしません
承認成果のみ
  • 成果が自動承認される広告は、成果発生時点で通知します
  • 成果の承認状態を「承認」に変更した時点で通知します
全て
  • 成果発生時に通知します
  • 成果の承認状態を変更した時に通知します

通知先URL設定

基本的に「同じURLを設定する」で問題ありません。
成果の承認状態によってポストバックURLが異なる場合のみ「異なるURL」を設定してください。

ポストバックURL

連携先システムのポストバックURLを設定してください。
変数一覧から変数（IDを通知する文字列）を選んで、対象のパラメータに追記してください。

アフィリエイター管理 > メディア一覧 > 連携設定（ポストバック）
ポストバック連携_ポストバックURL
▼ 学ぶ：メディア識別パラメータ「設定なし」の例
1. 追加パラメータを理解する
連携先システムは、計測IDをACSのアフィリエイトリンクに追加します。
以下は、メディア識別パラメータ（pbid、kbp1）でIDが追加された場合の例です。
アフィリエイトリンク
https://ACSドメイン/link.php?i=***&m=***&pbid=[ID1]&kbp1=[ID2]
赤字の部分は、
  • pbidに、[ID1]を保存している
  • kbp1に、[ID2]を保存している
という状態を表します。
2. ポストバックURLを理解する
ポストバックURLには、連携先が通知を求めているIDの内容が記載されています。
例えば、以下のポストバックURLを共有されたとします。
ポストバックURL
https://連携先ドメイン/?xxx=***&AAA=[ID1]&BBB=[ID2]
赤字の部分は、
  • AAAに[ID1]を通知してほしい
  • BBBに[ID2]を通知してほしい
という意味を表しています。
3. ポストバックURLに変数を追記する
これまでの流れを踏まえ、変数一覧から変数を当てはめていきます。
  • (1)にて、[ID1]はpbidに保存していました。
    つまり、ID1を通知するためには変数一覧の [pbid] を利用します。
  • (1)にて、[ID2]はkbp1に保存していました。
    つまり、ID2を通知するためには変数一覧の [kbp1] を利用します。
最終的に、下記のように変数を追記して完了です。
例：ポストバックURL
前）https://連携先ドメイン/?xxx=***&AAA=[ID1]&BBB=[ID2]
後）https://連携先ドメイン/?xxx=***&AAA=[pbid]&BBB=[kbp1]
▼ 学ぶ：メディア識別パラメータ「設定あり」の例
1. 追加パラメータを理解する
連携先システムは、計測IDをACSのアフィリエイトリンクに追加します。
以下は、メディア識別パラメータとは違う名前（AAA、BBB）でIDが追加された場合の例です。
アフィリエイトリンク
https://ACSドメイン/link.php?i=***&m=***&AAA=[ID1]&BBB=[ID2]
この場合、メディア識別パラメータで以下の設定をする必要があります。
pbid → 「AAA」、kbp1 → 「BBB」
ポストバック連携_メディア識別パラメータ
名前を設定することで、
  • AAAで[ID1]を保存する
  • BBBで[ID2]を保存する
という状態になります。
2. ポストバックURLを理解する
ポストバックURLには、連携先が通知を求めているIDの内容が記載されています。
例えば、以下のポストバックURLを共有されたとします。
ポストバックURL
https://連携先ドメイン/?xxx=***&AAA=[ID1]&BBB=[ID2]
こちらを言語化してみると、
  • AAAに[ID1]を通知してほしい
  • BBBに[ID2]を通知してほしい
という意味になります。
3. ポストバックURLに変数を追記する
これまでの流れを踏まえ、変数一覧から変数を当てはめていきます。
  • (1)にて、[ID1]はAAAに保存していました。
    メディア識別パラメータ設定では、AAAの名前をpbidに設定していました。
    つまり、ID1を通知するためには変数一覧の [pbid] を利用します。
  • (1)にて[ID2]は、BBBに保存していました。
    メディア識別パラメータ設定では、BBBの名前をkbp1に設定していました。
    つまり、ID2を通知するためには変数一覧の [kbp1] を利用します。
最終的に、下記のように変数を追記して完了です。
例：ポストバックURL
前）https://連携先ドメイン/?xxx=***&AAA=[ID1]&BBB=[ID2]
後）https://連携先ドメイン/?xxx=***&AAA=[pbid]&BBB=[kbp1]
▼ よく使われるポストバック変数一覧
変数 展開する内容
[pbid]
[kbp1]
[kbp2]
[kbp3] 		メディア識別パラメータで保存したID
[price] 購入金額
広告主との計測で取得した金額情報です
[args] 広告主との計測で取得した成果ID（注文番号など）
計測でargsを取得していない場合、空白で通知します
[action_log] ACSが自動発行する成果ID
[state] 承認状態のID
ACSの初期設定：未承認→0、 承認→1、 キャンセル→2
▼ その他のポストバック変数一覧
変数 展開する内容
[mid] ACSで管理しているメディアアカウントID
[media_space] ACSで管理している広告枠ID
[ssp_space] ACSで管理しているSSPID
[promotion] ACSで管理している広告ID
[promotion_item] ACSで管理している広告素材ID
[pcp] 特別単価パラメータのID
[plid] アドネットワークパラメータのID
[subject] 成果名（エンコードあり）
[subject_ne] 成果名（エンコードなし）
[cost] 成果報酬額のネット単価
[regist] 成果発生日時（UNIXタイム）
[pt_id] 報酬テーブルID
[pg_list] 「[pg_list]の設定」で設定しているID
[tkp1]
[tkp2]
[tkp3] 		広告主との計測で取得した成果識別ID（エンコードあり）
計測でtkpを取得していない場合、空白で通知します
[tkp1_ne]
[tkp2_ne]
[tkp3_ne] 		広告主との計測で取得した成果識別ID（エンコードなし）
計測でtkpを取得していない場合、空白で通知します

[state]の設定

「承認状態のID」を通知する場合に確認してください。

ポストバック変数一覧の[state]を利用すると設定したIDが展開されます。
連携先システムと承認状態のIDを一致させてください。

※ 初期設定：未承認→0、 承認→1、 キャンセル→2

[pg_list]の設定

「商品テーブルのデータ」を通知する場合に確認してください。
ポストバック変数一覧の[pg_list]を利用すると設定したIDが展開されます。

▼ ポストバック変数一覧（商品テーブル）
変数 展開する内容
[item_id] 商品ID
[item_price] 商品単価
[item_num] 商品数
[item_total] 商品合計金額

リトライ設定

ポストバック通知に失敗した場合の再送機能です。
基本的に「設定しない」で問題ありませんが、必要な場合は設定してください。

目次にもどる

関連記事

アフィリコード・システム

https://system.affilicode.jp/

アフィリエイト広告配信システム

本格的なASP運営から自社アフィリエイト運用
導入実績1,500社以上！多機能アフィリエイトシステム

製品へのお問い合わせはこちら

おすすめ記事

新着記事

  1. 計測用ドメイン（拡張機能）

    計測用ドメイン（拡張機能）

    アフィリコード・システム

もっと見る

よく読まれている記事

  1. アフィリコード・システムのマニュアル

    アフィリコード・システムのマニュアル

    アフィリコード・システム

  2. トラッキングコード表

    トラッキングコード表

    アフィリコード・システム

  3. 広告管理の基本

    広告管理の基本

    アフィリコード・システム

  4. トラッキングタグ計測

    トラッキングタグ計測

    アフィリコード・システム

  5. ポストバック連携（卸し連携）

    ポストバック連携（卸し連携）

    アフィリコード・システム

もっと見る