실적 발생 시 어떤 회원의 실적인지 실시간으로 데이터를 받을 수 있습니다. 리워드 데이터를 사용하면 회원들에게 가입/구매를 홍보하고, 실적이 발생하면 해당 회원에게 보상해 줄 수 있기 때문에 캐시백 또는 리워드 서비스를 운영하는 어필리에이트에 적합합니다.
-
배너클릭
-
클릭 링크에 u_id를 함께 전송하여 클릭 이동(3. u_id를 click과 연동하는 방법 참조)
-
어필정보와 함께 머천트로 이동
- u_id 및 어필 정보가 담긴 클릭정보와 함께 머천트로 클릭 이동
-
구매
-
구매 실적을 링크프라이스로 전송
-
리워드 전송
-
AC센터에서 리워드 API 승인 후 사용 가능(4. 리워드 승인 신청 참조)
-
링크프라이스로부터 리워드 데이터를 받아 처리할 페이지 작성 및 등록(4. 리워드 승인 신청 참조)
-
머천트에 따라 리워드 전송 시기 및 금액이 실적 정보와 다를수 있습니다.(2. 리워드 주의사항 참조)
-
-
매달 1번 링크프라이스에서 머천트측으로 정산 요청
-
실적 확정 및 취소
-
머천트 정산 방식에 따라 일부 실적 리워드가 전송.(2. 리워드 주의사항 참조)
-
실적 조회 API를 통하여 링크프라이스측으로 실적 조회 요청(6. 실적조회 API 참조)
-
요청한 실적 데이터 정보 제공(6. 실적조회 API 참조)
-
확정 및 취소 데이터 확인 후 리워드 확정(7. 정산실적 처리 참조)
2. 리워드 주의사항
- AC 센터 > 툴박스 > 리워드 API 에서 승인 신청을 합니다. 링크프라이스로부터 승인 후 사용 가능 합니다. (4. 리워드 승인 신청 참조)
- u_id
- 리워드를 받을 회원의 ID입니다.
- 클릭링크에 u_id파라미터를 같이 전송합니다.(3. u_id를 click과 연동하는 방법 참조)
- 길이제한: 50byte
- 반드시 url encoding 되어 있어야 합니다.
- 리워드 실적 받기
- 모든 머천트가 실시간 실적 전송을 지원하지 않습니다.
- 머천트에 따라 하루에 1번씩만 실적을 전송하기도 합니다.
- 머천트에 따라 실시간 실적의 금액은 0으로 전송되고, 익일이나 익익일에 실제 금액이 전송되기도 합니다.
- 하나의 주문은 링크프라이스를 통해 리워드를 받은 이후에, 정산 과정에서
- 주문 하나의 전체 실적이 취소되거나 또는 일부 실적이 취소 될 수 있습니다.
- 실시간 실적 전송시의 같은 주문번호로 새로운 마이너스 실적이 생길 수 있습니다.
- 머천트 정산 방식에 따라 실시간 실전 전송시의 금액과 정산 이후의 금액이 달라질 수 있습니다.
- 머천트 정산 날짜는 머천트에 따라 상이합니다.
- 특히 여행 사이트의 경우에는 실시간 실적은 정산시 일단 전부 취소됩니다. 이후 체크아웃 날짜 기준으로 실제 정산이 되어 , 구매 후 1년 후에 정산이 될 수도 있습니다.
-
u_id는 클릭링크에 u_id파라미터를 추가하여 전송 하실 수 있습니다.
-
예) u_id의 값이 exampleId101 일때
https://click.linkprice.com/click.php?m=tmon&a=A100000131&l=0000&u_id=exampleId101
4. 리워드 승인 신청
-
AC센터 > 툴박스 > 리워드 API
-
리워드 승인 신청
-
실적 발생 시 머천트에서 링크프라이스로 실적을 보내주면, 링크프라이스에서 어필리에이트로 리워드를 전송합니다. 링크프라이스가 전송한 데이터를 받아 처리할 페이지를 개발 되어야 하며, 그 주소를 리워드 승인 후 리워드 API 받을 주소에 저장하셔야 합니다.
- 리워드를 받아 처리하는 페이지의 타임아웃 시간은 최대 10초입니다.
-
AC센터 > 툴박스 > 리워드 API
-
하단 로그정보 조회 클릭
-
상단 필터링 부분을 이용하여 원하는 조건으로 조회
-
전송이 실패한 건에 대해서는 재전송이 가능합니다. (재전송 시 실적이 중복 될수 있습니다.)
귀사에서 발생한 링크프라이스의 실시간/확정/취소 실적을 확인 할 수 있는 API입니다.
-
실적 조회 API를 사용하기 위한 auth_key(인증키)를 발급 받습니다.
-
인증키 발급을 위해서는 링크프라이스로 연락 주십시요.
-
조회
- Request
GET /affiliate/translist.php?a_id=[어필아이디]&auth_key=[인증키]&yyyymmdd=[조회일자] HTTP/1.1 Host: api.linkprice.com
-
파라미터 설명
| 파라미터 | 필수 여부 | 설명 |
|---|---|---|
| auth_key | 필수 | 링크프라이스에 가입된 어필리에이트 아이디 |
| a_id | 필수 | 링크프라이스가 발행한 인증키값 |
| yyyymmdd | 필수 | 조회일자 ex) 20150515 또는 201505 (실적취소 조회 시에만 가능함) |
| cancel_flag | 옵션 | 취소주문 조회 Y: 취소 실적 조회 |
| currency | 옵션 | 화폐 명시 (판매금액 및 커미션이 환율 적용됨) ISO 4217 사용 |
| cmd | 옵션 | 부가 명령어 total: 전체 실적 조회 addon: 조회월 이후에 생성된 추가 실적 조회 |
| merchant_id | 옵션 | 해당 머천트 ID 의 실적만 조회 |
| page | 옵션 | 페이지 번호 (Paging 처리) |
| per_page | 옵션 | 페이지당 몇 건의 정보를 취득할 것인지 지정 (Paging 처리) |
- curl 요청
// 실적조회
curl https://api.linkprice.com/affiliate/translist.php?a_id=yourAffiliateId&auth_key=yourAuthKeyIsHere&yyyymmdd=20190701
// 취소 주문조회
curl http://api.linkprice.com/affiliate/translist.php?a_id=yourAffiliateId&auth_key=yourAuthKeyIsHere&yyyymmdd=20190712&cancel_flag=Y
// 일별 전체실적 건수 조회
curl http://api.linkprice.com/affiliate/translist.php?a_id=yourAffiliateId&auth_key=yourAuthKeyIsHere&yyyymmdd=20190702&cmd=total- 응답
- 형식: JSON
- Response
HTTP1.1 200 OK
Content-Type: application/json; charset=utf-8
{
"result":result,
"list_count": count,
"order_list":items
}
- JSON 데이터 설명
| 키 | 값 |
|---|---|
| result | 응답코드 0: 조회 성공 100: 어필 아이디 없음 200: 조회일자 없음 300: 인증키가 맞지 않음 |
| list_count | 조회 갯수(있을 경우) |
| order_list | 조회 목록(있을 경우) |
- order_list 상세 명세
| 키 | 값 |
|---|---|
| trlog_id | 주문 고유번호(PK) |
| yyyymmdd | 주문 일자 |
| hhmiss | 주문 시간 |
| m_id | 머천트 아이디(AK) |
| o_cd | 주문 번호(AK) |
| p_cd | 상품 코드(AK) |
| p_nm | 상품명 |
| c_cd | 카테고리 코드 |
| it_cnt | 주문 수량 |
| sales | 판매 합계금액 |
| commission | 어필 커미션 |
| user_id | 매체 사용자 정보 (click 주소를 통해 u_id로 전달 된 값) |
| membership_id | 머천트의 주문자 정보 |
| remote_addr | 사용자 PC 주소 |
| status | 주문상태 100 (처리중) 300(처리중) 310(취소완료) / 200(처리중) 210(정산완료) 220(정산완료) |
| trans_comment | 실적 취소 사유 |
7. 정산 실적 처리 방벙
- 매월 6일 어필 정산완료 후 실적 조회 API를 사용하여 확정 / 취소 실적을 확인 할 수 있습니다.
- 저장된 리워드 실적(6, 9번에서 전송된)과 조회된 정산 실적(11번)의 머천트 아이디, 주문 번호, 상품코드가 같은 데이터를 찾은 후 주문 상태에 따라 업데이트 하여 줍니다.
- 머천트 정산 방식에 따라 같은 머천트 아이디, 주문번호, 상품번호의 리워드 실적(6, 9번)과 정산 실적(11번)의 일부 데이터(특히 금액, 커미션) 가 달라질 수 있습니다.
- 드물게 예외 케이스가 발생하여, 리워드 데이터를 Insert, Delete가 필요할 수 도 있습니다.