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

システム連携：仕入れ連携

広告主側のシステム（ASP等）から広告を仕入れる場合の 仕入れ連携 について解説します。

ご利用中のシステムドメインを反映した「連携仕様書」をダウンロードいただけます。ぜひご活用ください。
Ver.3.18リリースノート | ナビメニューの変更

仕入れ連携​

クライアントサイドに連携先があるパターンの計測です。
連携先から広告を仕入れ、自社で管理するアフィリエイターが広告を掲載します。

連携先システムで発生した成果をアフィリコード・システムに通知してもらいます。

システム連携の計測の仕組みは、システム連携の概要 を確認してください。

ログ管理_仕入れ連携

連携先への事前確認​

システム連携を行う前に連携先の担当者に以下をご確認ください。

  1. まず、システム連携が可能か確認してください。
  2. 連携仕様書を受け取ってください（推奨）。
  3. 入稿URLの確認と広告流入時の受け渡しパラメータ情報（値の数とパラメータ）を確認します。
  4. 連携先で成果発生後、アフィリコード・システムにポストバックしてもらうURLを共有

連携先のパラメータ情報を確認​

アフィリコード・システムの成果連携の必要な値は、cid（クリックID）とP値（広告ID）です。

  • 連携先に受取可能なパラメータ数とパラメータ名を確認します。

連携設定の流れ​

  1. 連携先から入稿URLを入手
  2. 入手した入稿URL情報を元に広告・広告素材を付与
    • 連携用パラメータの付与
  3. 連携先で成果が発生後、成果通知用のポストバック受信URLを発行
  4. 仕入れ広告のアフィリエイトリンクを取得して、成果テスト

広告の登録​

連携先システムが発行した入稿URLを元に、アフィリコード・システムに「広告」と「広告素材」を登録します。
※広告主アカウントが未登録の場合は、先に登録してください。

広告設定のポイント
  • IP・UA による重複チェック：
    サーバー間通信で成果連携を行うため、重複チェックのIP・UAチェックにはチェックを入れないでください。
  • 掲載制御設定：
    連携先システムの設定に依存しますので、設定を行う場合は、連携先に事前にご確認ください

広告素材の登録​

次に、広告素材を登録します。リダイレクトによるパラメータの受け渡しが可能なシステム経由 方式で登録します。
詳細：システム経由方式のパラメータ付与 については、広告素材 | システム経由 で詳しく解説しています。

  • 素材種別：メディアに掲載する素材を選択
  • 遷移方法：システム経由

アフィリコード・システム同士の連携​

仕入れ先がアフィリコード・システムを利用している場合は、発行された入稿URLに続き、?pbid=[cid]&kbp1=[p] を付与します。
本設定により、成果計測に必須のcid値とp値 を連携先に預かってもらえます。

  • 広告遷移URL：発行された入稿URLに ?pbid=[cid]&kbp1=[p] を付与
  • クリックID（cid）付与設定：手動記述（カスタムパラメータ＝[cid]）
  • 広告ID（p）付与設定：手動記述（カスタムパラメータ＝[p]）

広告遷移URL：https://連携先システム発行の入稿URL?pbid=[cid]&kbp1=[p]

アフィリコード・システム以外の連携​

仕入れ先がアフィリコード・システム以外の場合は、入稿URLに続き、連携先指定のパラメータ名に[cid]と[p]を付与します。
本設定により、連携先のパラメータに成果計測に必須のcid値とp値を付与 できます。

  • 広告遷移URL：発行された入稿URLに指定のパラメータを付与
  • クリックID（cid）付与設定：手動記述（カスタムパラメータ＝[cid]）
  • 広告ID（p）付与設定：手動記述（カスタムパラメータ＝[p]）

広告遷移URL：https://連携先システム発行の入稿URL?param1=[cid]&param2=[p]
※param1～2 は、連携先指定のパラメータ名に変更してください。

ポストバック受信URLを取得​

連携先に共有する、ポストバック受信URLを取得します。
連携先で成果が計測されたら、成果通知を行ってもらうURLになります。

ヒント

事前に連携仕様書を共有している場合は、この作業は不要になる場合があります。

登録した仕入れ広告詳細 | 計測設定 - システム連携

広告詳細のシステム連携タブに切り替えます。通知が必要なパラメータにチェックを入れ「変換する」で取得します。
※デフォルトで 成果識別ID（args） にチェックが入っています。

連携設定_ポストバック受信URLの取得

クリックID、広告IDの受取パラメータ​

cid, p：広告流入時に連携先（通知元）システムの受取パラメータが2つの場合に利用します。

例：https://example.com/track.php?cid=クリックID&p=広告ID

cap：クリックIDと広告IDを結合したパラメータです。連携先システムの仕様で「付与できるIDが1つのみ」の場合に利用します。

例：https://example.com/track.php?cap=クリックID_広告ID

成果情報の受取パラメータ​

連携先から成果情報を受け取るパラメータの主なものは以下になります。必要に応じて追加してください。
詳細：トラッキングパラメータ

  • 成果識別ID（args）：注文番号や申込番号など、成果照合用の値を取得
  • 購入金額（price）：成果報酬単価を**定率（％）**で設定している場合は必須。priceに通知された金額を元に報酬単価を算出
  • 成果の承認状態（did, state）：didで受け取った「成果に紐づくユニークな値」をキーとし、 stateに通知された「承認状態を表す値」を元に成果ステータスを切り替え
  • 報酬テーブル：特定の条件下で報酬単価を切り分ける「報酬テーブル」設定時に利用（連携が可能な場合）
  • 商品テーブル：ECショップなど商品単位で報酬単価を切り分ける「商品テーブル」設定時に利用（連携が可能な場合）

成果テストのポイント​

連携先でポストバックの設定が完了したら、成果テストを実施します。

  1. 必ず 仕入れ広告のテスト用アフィリエイトリンク から行います。

  2. テスト用アフィリエイトリンクをクリックしたら、チェックログ でクリックID（cid値）の発行が確認できます。

    • チェックログが確認できない場合は、アフィリエイトリンクからテストしたか確認します

  3. 広告主のサイトまで遷移し、トラッキングログ で成果発生を確認します。

    • トラッキングログがない場合：連携先システムから成果通知が送信されてない可能性があります。連携先にポストバックの状況を確認します

  4. 連携先双方で成果が上がれば、テスト完了です。