Storism 용어집
설치·표시 용어
Storism을 사이트에 표시하기 위한 코드, 표시를 허용하는 도메인, 공개 전 미리보기, 실제 표시 조건을 정리했습니다.
이 페이지의 용어
흐름
표시까지의 기본 단계
Studio에서 컬렉션을 만들고, 허용 도메인을 설정한 뒤, 생성된 임베드 코드를 사이트에 추가합니다. 미리보기로 확인한 후 공개하면 표시 조건도 확인하기 쉽습니다.
- 코드 가져오기
- 도메인 허용
- 사이트에 설치
- 표시 확인
용어
임베드 코드
사이트에 Storism 위젯을 표시하기 위해 붙여 넣는 코드입니다.
- Studio의 컬렉션 상세 화면에 있는 ‘임베드 코드’ 탭에서 생성됩니다.
- 현재 공식 코드는 두 줄로 구성된 임베드 코드입니다.
- 사이트에서 iframe을 직접 작성하는 방식이 아닙니다. script가 iframe을 자동으로 만듭니다.
collection 속성의 값은 내부 ID가 아니라 Studio가 생성한 공개용 컬렉션 ID입니다. lang 속성은 위젯의 버튼·안내 문구 언어를 정합니다. 복사한 코드의 언어는 이후 Studio 언어를 바꿔도 유지되며, lang이 없으면 일본어가 사용됩니다.
용어
허용 도메인
위젯 데이터 로딩을 허용할 부모 페이지의 오리진을 등록하는 설정입니다.
- 설정 화면에는 https://example.com처럼 https://로 시작하는 오리진을 등록합니다.
- 포트는 1~65535 범위에서 지정할 수 있습니다. 포트가 다른 URL은 별도 오리진이므로 각각 등록해야 합니다.
- 경로, 쿼리, 해시, 끝의 슬래시, 와일드카드는 등록할 수 없습니다. 예를 들어 https://example.com/shop이나 https://*.example.com은 등록할 수 없습니다.
- 서브도메인도 https://shop.example.com처럼 별도로 등록해야 합니다.
등록되지 않은 오리진에서는 iframe이 만들어져도 위젯 데이터를 불러오지 않습니다. Studio 미리보기와 localhost는 검증을 위한 예외입니다.
용어
미리보기
사이트에 설치하기 전에 공개 상태인 컬렉션이 위젯에서 어떻게 보이는지 Studio에서 확인하는 기능입니다.
- 미리보기도 표시할 데이터를 실제 컬렉션에서 불러옵니다. 단, 비공개 콘텐츠와 예약 공개 시각 이전의 콘텐츠는 표시되지 않습니다.
- preview=true인 동안에는 표시·열람·클릭 등의 위젯 분석 이벤트를 보내지 않습니다.
- 전체 화면의 모습도 확인할 수 있지만, Studio 안의 미리보기용 iframe에서 재현합니다.
Studio 미리보기는 설치할 사이트의 허용 도메인 설정까지 확인하는 기능은 아닙니다. 실제 사이트에 표시하려면 임베드 코드 설치와 설치할 도메인 등록이 필요합니다.
용어
표시 조건
사이트의 위젯에 표시되는지를 결정하는 조건입니다.
- 임베드 코드의 collection으로 지정한 컬렉션이 공개 상태일 때만 위젯 데이터를 불러옵니다.
- 공개된 스토리 중 공개 상태이고 예약 공개 일시가 지난 미디어가 하나 이상 있는 스토리만 표시됩니다.
- 표시 가능한 미디어가 없어지면 해당 스토리는 스토리 목록에도 표시되지 않습니다.
- 비공개 상품은 상품 카드에서 제외됩니다. 상품이 비공개여도 미디어 자체는 표시 대상으로 유지됩니다.
표시되지 않으면 임베드 코드의 collection 값, 컬렉션 공개 상태, 허용 도메인, 표시 가능한 스토리·미디어 순서로 확인합니다.
용어
표시 설정
위젯의 모습과 미디어 재생 시간을 조정하는 설정입니다.
- 이미지 표시 시간, 동영상 최대 재생 시간, 전체 동영상 버튼의 표시 여부와 표시 시점을 설정할 수 있습니다.
- Pro 플랜에서는 스토리 원형 테두리 색, 목록 배경색, 스토리 이름의 글자색을 조정할 수 있습니다.
- Free/Lite에서는 PC 화면에 Storism 로고가 표시되고, Pro에서는 자동으로 숨겨집니다.
표시 시간과 전체 동영상 버튼은 모든 플랜에서 설정할 수 있습니다. Storism 표시 여부를 전환하는 개별 설정은 없습니다.