LogoLogo
NHN커머스 메인고도몰 운영 도움말
  • 고도몰 튜닝 가이드
    • Intro
    • 이해하기
      • 용어
      • 구조
        • 튜닝 진행 방법
        • 튜닝 가능 범위
        • 고도몰 아키텍쳐(Architecture)
        • 코딩 규칙
        • 네이밍 규칙
    • 준비하기
      • 심화 구조 이해
        • Routing 소개
        • Controller 소개
        • HTTP 소개
        • Database 소개
        • Security 소개
        • Exception 소개
        • Language 소개
      • 오픈 API 사용가이드
        • 인증키 발급 방법 안내
        • 공급사 이용 방법 안내
    • 튜닝하기
      • 소스 코드 튜닝
        • 기본 튜닝 방법
        • 컨트롤러 튜닝 방법
        • 템플릿 튜닝 방법
        • 튜닝 시 유의사항
      • 데이터베이스 튜닝
        • 튜닝 방법
        • 튜닝 시 유의사항
        • 고도몰 테이블 명세서
        • PhpMyAdmin 이용
      • 디버깅 방법
      • 패치 확인 및 대응 방법
    • 튜닝 따라하기
      • 관리자 GNB 색상 변경하기
      • 즐겨찾기 메뉴 바로가기 만들기
      • 관리자 메뉴 추가하기
      • 관리자 메뉴 수정하기
      • 관리자 페이지 추가하기
      • 관리자 페이지 수정하기
      • 사용자 페이지 추가하기
      • 사용자 페이지 수정하기
    • 잘못된 튜닝사례
      • 상속 미준수
      • 메소드 관련
      • 그 외
  • 기타 개발 가이드
    • 로그 사용 가이드
    • [PMA] 내보내기(export) 이용 안내
    • 외부 스크립트 사용 가이드
    • SDK 사용 가이드
    • [DB] 사용 가이드
  • 튜닝가이드 영상 보기
Powered by GitBook
LogoLogo

NHN COMMERCE

  • 공지사항
  • 회사소개

Partners

  • 서비스 제휴문의
  • 셀러어드민
  • 디자인 파트너

Developers

  • 스토어

©NHN COMMERCE Corp. All rights reserved.

On this page
  • 외부 스크립트 등록/조회/삭제 가이드
  • 1. 스크립트 등록
  • 2. 스크립트 실행
  • 3. 스크립트 조회
  • 4. 스크립트 삭제

Was this helpful?

  1. 기타 개발 가이드

외부 스크립트 사용 가이드

Previous[PMA] 내보내기(export) 이용 안내NextSDK 사용 가이드

Last updated 21 days ago

Was this helpful?

외부 스크립트 등록/조회/삭제 가이드

쇼핑몰에 스크립트를 적용하는 방법은 2가지가 있습니다.

1. 쇼핑몰 관리자 설정 기능 활용하기 - 관리자 경로 : 쇼핑몰 관리자>기본설정>기본정책>외부서비스 설정 2. 외부 스크립트 API 활용하기 -

스크립트 작동 시 쇼핑몰 화면단에서 필요한 정보가 있다면 SDK를 사용하시면 됩니다. 단, SDK를 사용하여 쇼핑몰 회원의 정보를 제3자에게 제공하거나 개인정보처리업무를 위탁하는 경우, 개인정보보호법에 따라 정보 주체가 알기 쉬운 형태로 해당 내용을 공개해야 하며, 필요한 조치를 취하지 않아 발생하는 불이익에 대해서는 당사가 책임지지 않습니다.

셀러어드민에 판매앱 등록 시 [셀러어드민>앱 등록/수정] 화면 내 '수집 데이터 정보' 항목에 쇼핑몰 회원 개인정보 수집 항목을 반드시 기재해 주시기 바랍니다. 고도몰에서 제공하는 SDK 스펙과 사용예시는 를 참고해 주시기 바랍니다.

스크립트 안에서는 치환코드 사용이 불가하여 필요한 정보는 반드시 SDK를 사용해 주셔야 합니다.

1. 스크립트 등록

쇼핑몰 플랫폼(PC 또는 모바일)을 지정하여 플랫폼에 따라 다른 스크립트를 등록하거나, 특정 플랫폼에만 스크립트 등록이 가능하며, 페이지를 지정하여 특정 페이지에만 등록도 가능합니다. 고도몰에서는 아래의 위치에 스크립트를 등록할 수 있도록 지원하고 있습니다.

스크립트 등록 위치
구분
location

상단 공통

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 호출 시점을 지정할 수 있기 때문에 스크립트를 등록할 시점을 지정하여 등록할 수 있습니다. 예를 들어 앱이 쇼핑몰에 설치된 후 토큰이 발급되자마자 스크립트를 등록할 수도 있고, 앱에 대한 사용료가 결제된 시점에 스크립트를 등록할 수도 있습니다.

2. 스크립트 실행

쇼핑몰에 접속하면 쇼핑몰 플랫폼 및 페이지에 등록된 스크립트가 실행됩니다. 쇼핑몰 관리자에서 등록한 스크립트는 쇼핑몰 관리자에서 설정한 사용 설정에 따라 동작되며, 외부 스크립트 등록 API로 등록한 스크립트는 API 호출 시 사용한 systemkey가 발급된 앱의 설치여부와 만료일에 따라 동작됩니다.

3. 스크립트 조회

등록된 스크립트를 조회하는 것은 스크립트 실행여부와는 관계가 없어서, 실행되지 않는 스크립트도 조회할 수 있습니다. 쇼핑몰 관리자에서는 쇼핑몰 관리자에서 등록한 스크립트만 조회할 수 있으며, API로 등록한 스크립트는 호출 시 사용한 systemkey로만 조회 가능합니다. 즉, A라는 systemkey로 등록한 스크립트는 B라는 systemkey로는 조회 불가하며, 쇼핑몰 관리자에서 조회할 수도 없습니다.

4. 스크립트 삭제

API로 등록한 스크립트는 API 호출 시 사용한 systemkey가 발급된 앱이 쇼핑몰에서 삭제되면 등록된 스크립트도 자동으로 삭제됩니다.

쇼핑몰 관리자에서는 쇼핑몰 관리자에서 등록한 스크립트만 삭제할 수 있으며, API로 등록한 스크립트는 호출 시 사용한 systemkey로만 삭제 가능합니다. 즉, A라는 systemkey로 등록한 스크립트는 B라는 systemkey로는 삭제 불가하며, 쇼핑몰 관리자에서 삭제할 수도 없습니다. 또한 쇼핑몰 플랫폼(PC 또는 모바일)이나 페이지를 지정하여서 삭제할 수도 없습니다.

API를 활용하여 스크립트 삭제 시에는 scriptNo 기준으로 삭제해야 하기 때문에, 스크립트가 등록된 후 반환된 scriptNo를 기억해 두어야 합니다. scriptNo를 잊었다면 스크립트 조회 API를 통해 scriptNo를 조회할 수 있습니다.

외부 스크립트 API 문서 바로가기
SDK 사용 가이드