ポイントバック対応用資料

http://www.ad-link.jp/
アドリンク アフィリエイトプログラム
ポイントバック対応用資料
目次
１．概要
４．自動ポイントバック
２．設定方法
└広告の選択
└自動ポイントバック概要
└データ送信のタイミング
└バナーコードの変更
└送信データ内容
３．成果のCSVダウンロード
└データ受け取り時の処理
└ダウンロード場所
└データ受け取りPHPサンプル
└ダウンロードしたCSVファイルの値
５．注意事項
最終更新日：2008/2/12
株式会社　ファランクス　〒161-0033 東京都新宿区下落合4-21-19 目白LKビル2F(総合受付)/6F
TEL：03-5996-0900　FAX：03-5996-1400　E-MAIL：[email protected]
Copyright(c) 2005 Phalanx Inc. All rights reserved
アドリンク アフィリエイトプログラム -ポイントバック対応資料-
http://www.ad-link.jp/
１．概要
■ポイントバックシステムとは・・・
パートナーサイト側が自サイト内でアクションを起こしたユーザーに対して、オリジナルインセンティブ（ポイント・キャッシュ・懸賞・プレゼント）を返すもの
です。アフィリエイトサービスの中でも非常に有効な手法となっております。
このシステムによりパートナーサイト様は、自サイト経由でユーザーに対してのオリジナルインセンティブを設定し、アクションを起こしたエンドユーザー
の情報をAd-Link管理画面からCSV形式でダウンロードすることで、ユーザーに対してオリジナルインセンティブを返す事ができます。
また、アクションの情報をPOST情報として送信し、 リアルタイムにポイントバック処理を行うことができるサービスも行っております。
これにより、ログインしてCSVファイルをダウンロードしなくても、自動でポイントバック処理をさせることができるようになります。
ユーザー【user1】
クリック
インセンティブ
【１００ポイント】
ポイントサイト
広告
会員ID【user1】
マーチャント
訪問
クリック時に
会員ID【user1】　を送信
成果発生
会員ID【user1】
を送信
ユーザー【user1】
アドリンク
ポイントサイト
会員IDを元にどの会
員かを確認。
インセンティブ
【１００ポイント】
を返す
user1＝○○さん
だと判断できる
会員ID【user1】
を送信
・会員ID
-P1-
株式会社　ファランクス　〒161-0033 東京都新宿区下落合4-21-19 目白LKビル2F(総合受付)/6F
TEL：03-5996-0900　FAX：03-5996-1400　E-MAIL：[email protected]
Copyright(c) 2005 Phalanx Inc. All rights reserved
アドリンク アフィリエイトプログラム -ポイントバック対応資料-
http://www.ad-link.jp/
２．設定方法
■バナー掲載までの手順
［１］マーチャント（広告）の選択
［２］コードを取得して会員ＩＤが引き継がれるように編集
［３］バナーの掲載
［１］マーチャント（広告）の選択
まずはマーチャント（広告）の選択をします。マーチャントによってはポイントバックシステムを利用しての掲載をＮＧとしているマーチャントも
おりますので、あらかじめOKかどうかの確認が必要となります。ＮＧマーチャントでポイント対応をしても、対象となりません。
アドリンクへログイン後の【広告検索・管理】ページにて広告の検索が可能となっており、ポイントバックＯＫのマーチャントを指定しての検索
ができます。
バナーコード発行部分
ポイントバックＯＫ
を指定しての検索
部分
ポイントバックＯＫのアイコン
-P2株式会社　ファランクス　〒161-0033 東京都新宿区下落合4-21-19 目白LKビル2F(総合受付)/6F
TEL：03-5996-0900　FAX：03-5996-1400　E-MAIL：[email protected]
Copyright(c) 2005 Phalanx Inc. All rights reserved
アドリンク アフィリエイトプログラム -ポイントバック対応資料-
http://www.ad-link.jp/
２．設定方法
［２］コードを取得してユーザーＩＤが引き継がれるように編集
ポイントバックシステムに対応させるために、発行されたバナーコードへ貴サイト側の会員IDをGET情報として書き出していただく形になります。（詳細
は下部）なお対応バナーはテキストバナー、画像バナー、mailバナー、商品リンクバナーになります。
※iframe、Flash、Flexバナーはポイントバックに対応しておりませんので、ご注意ください。
バナーコードの変更例
【変更前】
<a target='_blank' href='http://click.ad-link.jp/cv.php/0000000000/m4444444444444'>
<img src='http://click.ad-link.jp/img.php/7777777777' border='0'></a>
【変更後】
<a target='_blank' href='http://click.ad-link.jp/cv.php/0000000000/m4444444444444
?point_uid=会員ID'><img src='http://click.ad-link.jp/img.php/7777777777' border='0'></a>
会員ID・・・注文をする会員のID
※上記の会員IDとなっている部分は貴サイト側のプログラム処理によって書き出していただく必要があります。（半角英数）
※会員IDの引継ぎは必須です。
★自動ポイントバック対応の場合★
自動ポイントバック対応の場合は、広告IDの引継ぎも行う必要があります。下記の形式のどちらかで行って下さい。
【形式１】
上記の赤文字部分を　?point_uid=会員ID&point_pid=広告ID　の形式で引継ぐ。
【形式２】
上記の赤文字部分を　?point_uid=会員ID_広告ID　の様に【_（アンダースコア）】形式で引継ぐ。
※この場合、御社側でポイントデータを受け取る際に、会員IDと広告IDの区分け処理が必要です。
-P3株式会社　ファランクス　〒161-0033 東京都新宿区下落合4-21-19 目白LKビル2F(総合受付)/6F
TEL：03-5996-0900　FAX：03-5996-1400　E-MAIL：[email protected]
Copyright(c) 2005 Phalanx Inc. All rights reserved
アドリンク アフィリエイトプログラム -ポイントバック対応資料-
http://www.ad-link.jp/
３．成果のCSVダウンロード
■ダウンロード場所
アドリンクログインページの「報酬の集計」ページで会員IDを含んだ成果情報をCSVファイル形式でダウンロードすることができます。
表示させたい期間を指定して「注文一覧」レポートを表示していただくと、CSVダウンロードのボタンがあります。
「承認待ち」「確定」「否認」、それぞれ成果の状態をチェックボックスで指定して、「CSV形式でダウンロードする」ボタンをクリックしてください。ダウン
ロードが開始されます。確定データのみ取得する場合は、「承認待ち」「否認」のチェックを外して下さい。
ログイン
報酬の集計ページへ
レポートで『注文一覧』を検索・表示
CSVをダウンロード
日付指定部分
レポート選択部分
ダウンロード部分
-P4株式会社　ファランクス　〒161-0033 東京都新宿区下落合4-21-19 目白LKビル2F(総合受付)/6F
TEL：03-5996-0900　FAX：03-5996-1400　E-MAIL：[email protected]
Copyright(c) 2005 Phalanx Inc. All rights reserved
アドリンク アフィリエイトプログラム -ポイントバック対応資料-
http://www.ad-link.jp/
３．成果のCSVダウンロード
■ダウンロードしたCSVの値
ダウンロードしたCSVファイルのそれぞれの値は次のようになっています。
・会員ID
どのエンドユーザーか判別するための貴サイト側の会員ID
・広告ＩＤ
貴サイト側で設定した広告識別ＩＤ
・購入金額
エンドユーザーの発生成果の購入金額
・プロモーション名
成果発生したアドリンク側のプロモーションの名前
・プラン名
成果発生したアドリンク側のプランの名前
・成果発生日
成果が発生した日です。　時間まで含まれています。
・成果承認期限
・審査ステータス
成果確定の承認期限です。　審査状態「承認待ち」の成果のみ表示
成果の審査状態の数字です。
・成果承認日
0・・・「審査待ち」、1・・・「承認」、それ以外の2桁の数字は「否認」です。
成果確定が行われた日にちです。　審査状態「確定」、「否認」のみ表示
否認のそれぞれの状態は以下の通りです。
10
否認【該当なし】　13 否認【無効登録】
・成果金額
11
否認【内容不備・不良】　15 否認【二重登録】
パートナー様への成果金額　この場合パートナー様は貴サイトにあたり
12
否認【キャンセル】　99 否認【その他】
ます。
・審査状態
審査ステータスに対する審査状態を文字で表示しています。
-P5株式会社　ファランクス　〒161-0033 東京都新宿区下落合4-21-19 目白LKビル2F(総合受付)/6F
TEL：03-5996-0900　FAX：03-5996-1400　E-MAIL：[email protected]
Copyright(c) 2005 Phalanx Inc. All rights reserved
アドリンク アフィリエイトプログラム -ポイントバック対応資料-
http://www.ad-link.jp/
４．自動ポイントバック
■概要
【ポイントサイト経由での成果発生時】【マーチャント側での成果確定が行われた時】に、貴サイトが指定したURLにPOST情報を含めたリクエスト情報を
送信させることができます。これを利用することによりポイントのリアルタイム更新を行うことができます。
URL指定がされていれば、【成果が発生したとき】【審査が確定されたとき】に送信が行われ、審査待ち・承認・否認に関係なくデータ送信を行います。
またポイント反映処理の漏れが無いように、データの送信・受け取りに問題が発生した場合にデータを再送信する機能がございます。
【通常】
成果発生
CSVでデータをダウンロード
貴サイトでインセンティブの付与
指定したURLへデータを自動送信
貴サイトでインセンティブの付与
（設定すれば自動付与も可能となります）
【自動】
成果発生
データ送信に
失敗した場合
指定したURLへ10分ごとに
データを自動送信
-P6株式会社　ファランクス　〒161-0033 東京都新宿区下落合4-21-19 目白LKビル2F(総合受付)/6F
TEL：03-5996-0900　FAX：03-5996-1400　E-MAIL：[email protected]
Copyright(c) 2005 Phalanx Inc. All rights reserved
アドリンク アフィリエイトプログラム -ポイントバック対応資料-
http://www.ad-link.jp/
４．自動ポイントバック
■データ送信のタイミング
【データ送信１】
全承認
成果が即承認の場合
成果発生
【データ送信２】
承認
【データ送信１】
成果が即承認でない場合
【データ送信２】
否認
■送信データ内容
データ送信を行ったときに一緒に送られてくるPOST情報の名前とその内容は次のようになります。
・session_id
成果ごとのセッションIDで、大文字英数字で構成された半角１６文字です。
・point_uid
バナーコードに付加していただいた会員IDです。
・point_pid
バナーコードに付加していただいた広告IDです。
※P.3の形式１を用いた場合のみです。
・date
「審査待ち」なら成果発生日、「承認」「否認」なら審査確定日です。
形式は　YYMMDDHHMMSSで、時は24時間表示です。
・date2
成果発生日です。形式は　YYMMDDHHMMSSで、時は24時間表示です。
・price
定率の場合、エンドユーザーの購入合計金額が数字で入ってきます。
定額プランの場合はこの数字は0です。
・status
成果の審査状態の数字です。
0・・・「審査待ち」、1・・・「承認」、それ以外の2桁の数字は「否認」です。
否認のそれぞれの状態は以下の通りです。
10
否認【該当なし】　13 否認【無効登録】
11
否認【内容不備・不良】　15 否認【二重登録】
12
否認【キャンセル】　99 否認【その他】
・amounts
成果報酬金額が数字で入ってきます。
・point
エンドユーザーへのポイント数です。
（2007/11/16使用不可　データは「空l」です）
-P7株式会社　ファランクス　〒161-0033 東京都新宿区下落合4-21-19 目白LKビル2F(総合受付)/6F
TEL：03-5996-0900　FAX：03-5996-1400　E-MAIL：[email protected]
Copyright(c) 2005 Phalanx Inc. All rights reserved
アドリンク アフィリエイトプログラム -ポイントバック対応資料-
http://www.ad-link.jp/
４．自動ポイントバック
■データ受け取り時の処理
自動送信処理の場合、データ受け取りの漏れが無いようにポイント反映の処理が完了したら、問題なく処理が完了した証拠として、半角で
「yes」の文字を返していただくようになっています。
アドリンクからのリクエスト送信により、「yes」の文字が取得できた場合は再送信はされません。
もし取得できなかった場合は、「審査待ち」状態なら成果発生から1日以内、「承認」「否認」状態なら審査確定から１日以内は、１０分に１回
データを送り続けます。
もし１日以内に反映処理が完了できなかった場合は、アドリンクログインページ内にてCSVをダウンロードして、反映処理を行っていただく
必要があります。
成果発生
貴サイトの指定したURLへ
データを自動送信
貴サイトのデータを受け取るページで
『yes』と表示された
完了
貴サイトのデータを受け取るページで
『yes』と表示されない
１０分ごとにデータを再送信する処理をしています
-P8株式会社　ファランクス　〒161-0033 東京都新宿区下落合4-21-19 目白LKビル2F(総合受付)/6F
TEL：03-5996-0900　FAX：03-5996-1400　E-MAIL：[email protected]
Copyright(c) 2005 Phalanx Inc. All rights reserved
アドリンク アフィリエイトプログラム -ポイントバック対応資料-
http://www.ad-link.jp/
４．自動ポイントバック
■データ受け取りPHPサンプル
データ送信先のファイルで書いていただく処理をPHPで書いた一例です。
<?php
// POST情報の受け取り
$session_id = $_POST['session_id']; ※
$point_uid = $_POST['point_uid'];
$point_pid = $_POST['point_pid'];
$date
= $_POST['date'];
$date2
= $_POST['date2'];
$price
= $_POST['price'];
$status
= $_POST['status'];
$amounts = $_POST['amounts'];
$point
= $_POST['point'];
/******************************************************************************
受け取ったPOST情報の記録、更新処理をし、
処理のbool値を $r で受け取る。
※データベースへのデータ挿入処理の際、重複排除として、
session_idに対して一意性（ユニーク）の設定をお願いいたします。
******************************************************************************/
// 反映処理が成功した場合
if($r) {
print "yes";
}
// 反映処理が失敗した場合
else {
print "no";
}
?>
※P.3の形式１を用いた場合はこの処理をして下さい。その他の場合は処理を行う必要はありません。
-P9株式会社　ファランクス　〒161-0033 東京都新宿区下落合4-21-19 目白LKビル2F(総合受付)/6F
TEL：03-5996-0900　FAX：03-5996-1400　E-MAIL：[email protected]
Copyright(c) 2005 Phalanx Inc. All rights reserved
アドリンク アフィリエイトプログラム -ポイントバック対応資料-
http://www.ad-link.jp/
５．注意事項
■クッキーについて
ユーザーがクッキーを保存しない設定にしている場合は正常に成果のカウントが出来なくなります。
事前にユーザーの方へクッキーを保存する設定にして頂くようにお知らせ下さい。
■インセンティブについて
インセンティブの決定や付与・発送業務などは全てパートナーサイト様に行って頂く事となります。
また、インセンティブの内容については下記の通りとなります。
○現金、商品券
○上記に変換できる独自のポイント
×法律に違反するような行為・情報などの提供
×その他『景品表示法』などを遵守できないもの
■クリックのインセンティブについて
クリック報酬にインセンティブを付ける事はNGとなっておりますので、あらかじめご注意下さい。
■ポイントバック対応可否について
クライアント様によってはプロモーション途中でポイントバックOK　⇒　NGとなる場合もございます。
その際はメールマガジン等でお知らせ致しますので、対応を行って下さい。
■契約をお断りする場合
アドリンク規約の違反や法律・法規違反、その他弊社が違反行為と判断した場合は、即座にアドリンクとの契約を解除させて頂く事となります。
くれぐれも違反行為をされないようお願い致します。
-P10株式会社　ファランクス　〒161-0033 東京都新宿区下落合4-21-19 目白LKビル2F(総合受付)/6F
TEL：03-5996-0900　FAX：03-5996-1400　E-MAIL：[email protected]
Copyright(c) 2005 Phalanx Inc. All rights reserved