システム連携：仕入れ案件
システム連携：仕入れ案件
ソケット連携によって、外部システム（連携先ASP）から広告を仕入れる繋ぎ込みについて解説します。
システム連携型トラッキングは、広告URLに付与されたURLパラメータの値を照合して成果を計測します。
計測の流れ
- ユーザーが広告をクリック
- アフィリコード・システムにリダイレクト。cid値とp値を発行し広告URLに付与
- 連携先システムにリダイレクト。cid値とp値を預かる
- 広告主ページでCV。連携先システムで成果計上
- アフィリコード・システムにキックバック通知。3. で預かったcid値とp値を返却
- アフィリコード・システムで成果発生
アフィリコード・システムの成果認証には、cidとpが必須です。
設定手順
事前に連携先システムに必要な情報を確認し、アフィリコード・システムで設定を行います。
- 連携先システム：仕入れ先から広告URLを入手
- アフィリコード・システム：入手した広告URL情報を元に広告を登録
- アフィリコード・システム：広告素材の登録（連携用パラメータの付与）
- アフィリコード・システム：成果通知用のキックバック受付URLを発行
- 連携先システム：キックバック受付URLの通知
1. 仕入れ先から広告URLを入手
仕入れ広告の広告URL（アフィリエイトリンク）を連携先システムで発行してもらいます。
- 広告URL
https://連携先システム発行の広告URL- 連携先システムがアフィリコード・システム以外の場合は、先方のパラメータ名を確認してください。
2. 広告の登録：連携用パラメータの付与
連携先システムが発行した広告URLを元に、アフィリコード・システムに連携先の「広告」と「広告素材」を登録します。
広告を新規登録します。
連携用の広告は、成果重複チェック「設定しない」、成果認証パスワード「未設定」にします。
3. 広告素材の登録：連携用パラメータの付与
次に、広告素材を登録します。
広告遷移種別は「システム経由方式」を選択します。
システム経由方式にすることで、連携先に渡すパラメータが付与できます。
広告遷移URLの設定
入手した広告URLに続き、連携先指定のパラメータ名に[cid]と[p]を付与します。
アフィリコード・システム同士の連携の場合は「pbid」「kbp1」パラメータを使用します。
※連携先（卸し側）は、広告URLパラメータの変換は不要です。
- アフィリコード・システム以外の連携
https://連携先システムが発行した広告URL¶m1=[cid]¶m2=[p]
※パラメータ名（ param1 / param2 ）は連携先指定のパラメータ名を設定してください。- アフィリコード・システム同士の連携
https://連携先システムが発行した広告URL&pbid=[cid]&kbp1=[p]
「cid」「p」の付与形式は、[cid]を値で置換する、「[p]」を値で置換するに設定します
この設定により、広告クリック時にアフィリコード・システムが発行した成果認証用IDと広告IDを連携先システムに預かってもらうことができます。
- 広告遷移先でのパラメータ付与イメージ
https://連携先システム発行の広告URL?param1=[cid]¶m2=[p]
↓（リダイレクト）
https://example.com?param1={cid値}¶m2={p値}
| パラメータ値 | 説明 |
|---|---|
| cid | アフィリコード・システムのセッションID 値の出力文字数：27桁 |
| p | アフィリコード・システムの広告ID 値の出力文字数：12桁 |
| mid | アフィリコード・システムのメディアID 値の出力文字数：12桁 |
4. キックバック受付URLを取得
次に、コンバージョン発生時にアフィリコード・システムで成果通知を受け取れるよう「キックバック受付URL」を生成します。
※広告遷移の際に付与したパラメータを返却してもらいます。
キックバック受付URLを広告詳細から取得
該当の広告、トラッキングタグ | システム連携型 タブより、キックバック受付URLを取得します。必要なパラメ―タにチェックを入れ、「変換」で付与します。
「成果認証パラメータ（cid、p）」は、付与必須です。
- キックバック受付URLのフォーマット
- 定額用
https://システム設置先URL/track.php?cid={cid値}&p={p値}&args={成果識別子} - 定率用
https://システム設置先URL/track.php?cid={cid値}&p={p値}&args={成果識別子}&price={price値}
以降は、連携に必要な場合、適宜設定します。
成果ステータスの連携を行う場合
成果ステータスの連携を行う場合は、「成果ステータス（did、state）」が必須になるため、パラメータにチェックを入れて生成します。
※連携先ASP側で成果ステータス（未承認：0 承認：1 キャンセル：2）の値を通知可能な場合に限ります。
- 成果ステータス連携時の通知フォーマット
- 定額用の例
https://アフィリコード・システム設置先URL/track.php?cid={cid値}&p={p値}&args={args値}&did={did値}&state={state値}
※パラメータ名の変更が必要な場合は、トラッキングパラメータ変換を利用してください。
cap：特殊パラメータ
「cap」パラメータは、連携先ASPで「受け取り・返却」パラメータが1つしか扱えない場合に使用します。
パラメータ付与形式は、 [cid]を値で置換する、「[p]」を値で置換する に設定します。
- 広告URLフォーマット
https://連携先システム発行の広告URL?abc=[cid]_[p]
※パラメータ名（abc）は連携先の仕様によって指定の名前に変更- 連携先ASPに共有するキックバック受付URLの設定
https://システム設置先URL/track.php?cap=abc
受け取り可能なパラメータ一覧
| パラメータ | 種類 | 必須 | 説明 |
|---|---|---|---|
| p | 広告ID | 〇 | 広告ごとに生成されるID 成果発生に必須 |
| cid | 成果認証用ID | 〇 | 成果認証用ID自動付与設定 成果発生に必須 |
| plid | 成果認証用ID | △ | Google広告連携時の成果認証用ID自動付与設定 Google広告連携時は必須 |
| args | 成果識別子 | - | ASP間での成果照合に使用。注文番号などのユニークな値 受け取り可能文字数：255桁 |
| did | 成果識別子 | △ | 成果ステータス連携時必須。承認状態切替時のキーとなる値 受け取り可能文字数：255桁 |
| state | 成果識別子 | △ | 成果ステータス連携時必須 承認状態を表す値（未承認：0 承認：1 キャンセル：2） 受け取り可能文字数：1桁 |
| price | 購入金額 | △ | 成果報酬の売上金額。定率案件の場合は必須 受け取り可能文字数：10桁 |
| pt | 報酬テーブルID | - | 報酬テーブルごとに設定されているID 渡されたIDから設定した値に単価を変更 最大設定文字数：30桁 |
| pg | 商品テーブルID | - | 商品テーブルごとに設定されているID 渡されたIDから設定した値に単価を変更 最大設定文字数：30桁 |
| tkp1 tkp2 tkp3 |
識別パラメータ （成果確認用） |
- | 成果に紐づけ可能な任意パラメータ 受け取り可能文字数：255桁 |
| t | 成果認証パスワード | - | 広告の成果保証設定で設定されている認証パスワード 通知形式：半角英数字 |
| mid | メディアID | - | メディアID自動付与設定。該当メディアに成果を発生させる場合。 cidがなくても利用可能。継続成果報酬を使いたい場合に利用。 出力文字数：12桁 |
| cap | 特殊パラメータ | - | 「受け取り・返却」パラメータが1つしか扱えない場合に利用 |
5. キックバック受付URLの通知
連携先にキックバックURLを伝え、成果テストを実施します。問題なければ一連の設定は完了です。
