shoplive.show (샵라이브 제공 페이지)

이 페이지에서는 Shoplive에서 제공하는 shoplive.show 도메인 기반의 플레이어 페이지를 고객사의 웹사이트 / 모바일 어플리케이션(Web view)에 연동하기 위한 가이드를 제공합니다.

Shoplive에서는 아래와 같은 방식으로 웹 페이지에 연동할 수 있는 플레이어를 제공하고 있습니다.

JavaScript SDK를 통한 설치와 Shoplive Plugin을 통한 설치는 고객사에서 서비스하는 랜딩 페이지가 있어야만 플레이어를 설치할 수 있는데 반해, shoplive.show에서 제공하는 플레이어는 고객사에 별도의 랜딩 페이지가 없이 간단한 URL 호출만으로 플레이어를 실행할 수 있습니다.

shoplive.show에서 제공하는 플레이어 호출을 위한 URL과 parameter는 아래 내용을 참고하시기 바랍니다.

Player URL

https://www.shoplive.show/v1/player.html

URL parameter

Parameter설명비고
ak고객사의 access key 정보
ck플레이어에서 재생할 campaign key 정보필수
tk일반 인증 또는 JWT 토큰 형태의 인증 정보 (게스트 사용자의 경우 tk parameter를 전달하지 않아도 됩니다.)
backButton1(표시) | 0(표시하지 않음)
shareButton1(표시) | 0(표시하지 않음)

인증 정보 설정(tk parameter)

일반 인증 일반 인증 안내

  • JSON 객체로 userId, userName 등의 정보를 설정한 후 tk parameter로 Player를 호출할 때 반드시 url encode하여 전달하여야 합니다.
  • JSON 객체의 예: {userId: "userID", userName: "userName"}
  • tk 파라미터에서 사용할 url encode된 JSON 객체의 예:
    %7B%22userId%22%3A%20%22userID%22%2C%20%22userName%22%3A%22userName%22%7D
  • url encode가 두 번 되지 않도록 주의하세요!

JWT 인증 (JWT 인증 안내)

  • 고객사 서버에서 secret key로 암호화하여 JWT를 생성한 후 생성된 토큰을 tk parameter로 전달합니다.

예제

Guest 사용자를 위한 Player를 호출하는 예 (tk parameter를 전달하지 않음)

일반 인증 정보를 포함하여 Player를 호출하는 예

JWT 토큰을 포함하여 Player를 호출하는 예