애드온
애드온은 내가 공유한 링크를 통해 예스24 주문이 발생하면 수익을 받을 수 있는 부가 서비스입니다. 상품 API 응답에 나만의 수익 연결 링크가 함께 제공됩니다.
애드온이란?
블로그·SNS·앱 등에서 예스24 상품을 소개할 때, 일반 상품 링크 대신 나에게 연결된 애드온 링크를 사용하면 그 링크를 통해 구매가 이루어졌을 때 나에게 수익이 귀속됩니다.
애드온을 신청하면 상품 API(/v1/goods) 응답의 addOnLink 필드에 이 애드온 클릭 URL이 자동으로 채워집니다. 별도의 링크 생성 작업 없이 API 응답을 그대로 활용할 수 있습니다.
서평·큐레이션 콘텐츠를 운영하는 블로거·크리에이터, 도서 추천 서비스나 앱을 만드는 개발자 등 예스24 상품을 외부에 소개하고 수익으로 연결하고 싶은 경우에 활용할 수 있습니다.
동작 원리
애드온 신청 회원의 API Key로 상품 API를 호출하면, 응답의 addOnLink에 애드온 클릭 URL이 반환됩니다. 사용자가 이 링크를 클릭하면 애드온 시스템을 거쳐 예스24 상품 페이지로 이동하고, 구매 시 수익이 이용 회원에게 연결됩니다.
신청 절차
애드온은 API Key 페이지의 부가서비스 영역에서 이용약관에 동의하면 신청됩니다. Key가 이미 발급되어 있어야 합니다.
-
1
API Key 발급
애드온은 발급된 API Key에 연결되는 서비스입니다. Key가 없다면 먼저 API Key 신청에서 발급받으세요.
-
2
부가서비스 · 애드온에서 신청하기
API Key 페이지의 부가서비스 · 애드온 카드에서 신청하기 버튼을 누릅니다.
-
3
애드온 이용약관 동의
신청 모달에서 애드온 이용약관(필수) 내용을 확인하고 동의 체크 후 동의하고 계속하기를 누릅니다. 동의해야 신청이 완료됩니다.
-
4
즉시 활성화
동의 즉시 애드온이 활성화되며, 이후 상품 API 응답의
addOnLink에 애드온 클릭 URL이 반환됩니다.
애드온은 이용약관에 동의하면 즉시 활성화되며, 신청 후에는 해제할 수 없습니다. 약관 내용을 충분히 확인한 뒤 동의해 주세요.
신청 후 사용법
상품 API 응답에는 link와 addOnLink 두 가지 URL이 포함됩니다. 용도에 맞게 사용하세요.
| 필드 | 내용 | 사용 시점 |
|---|---|---|
link |
항상 반환되는 예스24 원본 상품 상세 URL | 일반 상품 이동 (수익 연결 없음) |
addOnLink |
애드온 클릭 URLhttps://apis.yes24.com/a/{userKey}/goods/{상품번호} |
애드온 수익 연결이 필요한 화면 |
addOnLink가 공란으로 반환되면 애드온 미신청 상태이므로, 이때는 link를 사용해 주세요.
애드온에 대한 정책·수익 조건 등 자세한 내용은 예스24 애드온 안내 페이지를 참고해 주세요.