외부 스크립트 사용 가이드
Last updated
Was this helpful?
Last updated
Was this helpful?
쇼핑몰에 스크립트를 적용하는 방법은 2가지가 있습니다.
1. 쇼핑몰 관리자 설정 기능 활용하기 - 관리자 경로 : 쇼핑몰 관리자>기본설정>기본정책>외부서비스 설정 2. 외부 스크립트 API 활용하기 -
스크립트 작동 시 쇼핑몰 화면단에서 필요한 정보가 있다면 SDK를 사용하시면 됩니다. 단, SDK를 사용하여 쇼핑몰 회원의 정보를 제3자에게 제공하거나 개인정보처리업무를 위탁하는 경우, 개인정보보호법에 따라 정보 주체가 알기 쉬운 형태로 해당 내용을 공개해야 하며, 필요한 조치를 취하지 않아 발생하는 불이익에 대해서는 당사가 책임지지 않습니다.
셀러어드민에 판매앱 등록 시 [셀러어드민>앱 등록/수정] 화면 내 '수집 데이터 정보' 항목에 쇼핑몰 회원 개인정보 수집 항목을 반드시 기재해 주시기 바랍니다. 고도몰에서 제공하는 SDK 스펙과 사용예시는 를 참고해 주시기 바랍니다.
스크립트 안에서는 치환코드 사용이 불가하여 필요한 정보는 반드시 SDK를 사용해 주셔야 합니다.
쇼핑몰 플랫폼(PC 또는 모바일)을 지정하여 플랫폼에 따라 다른 스크립트를 등록하거나, 특정 플랫폼에만 스크립트 등록이 가능하며, 페이지를 지정하여 특정 페이지에만 등록도 가능합니다. 고도몰에서는 아래의 위치에 스크립트를 등록할 수 있도록 지원하고 있습니다.
상단 공통
scriptHeader
-
하단 공통
scriptFooter
-
메인 페이지
scriptPage
INDEX
상품 리스트 페이지
GOODS_LIST
인기 상품 리스트 페이지
GOODS_POPULATE
상품 상세 페이지
GOODS_VIEW
상품 검색 결과 페이지
GOODS_SEARCH
장바구니 페이지
ORDER_CART
주문하기 페이지
ORDER
주문완료 페이지
ORDER_END
주문 목록 페이지
MYPAGE_ORDER_LIST
주문 상세 페이지
MYPAGE_ORDER_VIEW
로그인 페이지
MEMBER_LOGIN
회원가입 페이지
MEMBER_JOIN
회원가입 완료 페이지
MEMBER_JOIN_OK
마이페이지
MYPAGE_INDEX
API 활용 시에는 API 호출 시점을 지정할 수 있기 때문에 스크립트를 등록할 시점을 지정하여 등록할 수 있습니다. 예를 들어 앱이 쇼핑몰에 설치된 후 토큰이 발급되자마자 스크립트를 등록할 수도 있고, 앱에 대한 사용료가 결제된 시점에 스크립트를 등록할 수도 있습니다.
쇼핑몰에 접속하면 쇼핑몰 플랫폼 및 페이지에 등록된 스크립트가 실행됩니다. 쇼핑몰 관리자에서 등록한 스크립트는 쇼핑몰 관리자에서 설정한 사용 설정에 따라 동작되며, 외부 스크립트 등록 API로 등록한 스크립트는 API 호출 시 사용한 systemkey가 발급된 앱의 설치여부와 만료일에 따라 동작됩니다.
등록된 스크립트를 조회하는 것은 스크립트 실행여부와는 관계가 없어서, 실행되지 않는 스크립트도 조회할 수 있습니다. 쇼핑몰 관리자에서는 쇼핑몰 관리자에서 등록한 스크립트만 조회할 수 있으며, API로 등록한 스크립트는 호출 시 사용한 systemkey로만 조회 가능합니다. 즉, A라는 systemkey로 등록한 스크립트는 B라는 systemkey로는 조회 불가하며, 쇼핑몰 관리자에서 조회할 수도 없습니다.
API로 등록한 스크립트는 API 호출 시 사용한 systemkey가 발급된 앱이 쇼핑몰에서 삭제되면 등록된 스크립트도 자동으로 삭제됩니다.
쇼핑몰 관리자에서는 쇼핑몰 관리자에서 등록한 스크립트만 삭제할 수 있으며, API로 등록한 스크립트는 호출 시 사용한 systemkey로만 삭제 가능합니다. 즉, A라는 systemkey로 등록한 스크립트는 B라는 systemkey로는 삭제 불가하며, 쇼핑몰 관리자에서 삭제할 수도 없습니다. 또한 쇼핑몰 플랫폼(PC 또는 모바일)이나 페이지를 지정하여서 삭제할 수도 없습니다.
API를 활용하여 스크립트 삭제 시에는 scriptNo 기준으로 삭제해야 하기 때문에, 스크립트가 등록된 후 반환된 scriptNo를 기억해 두어야 합니다. scriptNo를 잊었다면 스크립트 조회 API를 통해 scriptNo를 조회할 수 있습니다.