Search

행사목록 구성하기 - TS쿼리 가이드

💡
TS쿼리는 트립스토어의 행사목록을 정의하는데 사용되는 쿼리스트링을 지칭합니다. 해당 쿼리스트링의 값들을 활용하여 원하는 조건을 만족하는 행사목록을 구성할 수 있습니다.

TS쿼리 활용 행사목록 설정 방법

•
트립스토어의 행사목록 페이지 주소는 ...tripstore.kr/list? 로 시작되며, list? 뒤에 TS쿼리 파라미터를 입력하여 원하는 조건의 행사목록을 생성할 수 있습니다.
•
TS쿼리는 파라미터=입력값 으로 입력하며, 단일 파라미터에 다수의 입력값을 복수선택 하여 입력 할 때에는 ‘,’를 활용하여 입력값을 구분합니다.
•
하나의 파라미터를 입력 한 후 추가적인 파라미터 입력 시 ‘&’를 활용하여 파라미터를 구분합니다.
•
TS쿼리를 활용하여 생성 한 조건을 만족하는 행사목록의 예시는 다음과 같습니다:
◦
부산에서 출발하여 오사카로 도착하는 4성급 에어텔 상품 (브릿지 페이지 표기)
…tripstore.kr/list?airports=790&kinds=AIRTEL&placeIds=291&accommodationStars=4&title=오사카 에어텔&show_bridge=1

채널 이동 브릿지 TS쿼리

•
자사 채널에서 트립스토어로 이동시 브릿지 페이지를 추가하시고자 한다면 show_bridge=1 TS쿼리를 활용하세요.
show_bridge=1 TS쿼리를 활용하시면 다음과 같은 브릿지 페이지가 3초간 표기된 후 페이지로 접속이 됩니다.

기본 TS쿼리

•
기본 TS쿼리는 목록 구성을 위한 가장 기본이 되는 TS쿼리입니다.
•
해당 값이 없이는 행사목록 구성이 불가능하기 때문에, 기본 TS쿼리가 누락될 경우 자동으로 기본값으로 설정되어 목록이 생성됩니다.
◦
해당 TS쿼리에 특정 값을 설정한 후 목록을 구성하여 링크로 활용할 시 목록활용에 있어 사용성이 제한되므로, 특정 값을 설정 할 분명한 이유가 없다면 기본 TS쿼리 없이 링크를 생성 해 주세요.
(e.g. 2023년 1월 1일로 날짜가 지정 할 시 오늘 날짜에 따라 유동적으로 변경되지 않고, 항상 해당 날짜 목록으로 접근 됩니다)
Search
기본 TS쿼리
TS쿼리
파라미터
입력값
입력예시
설정 유형
누락시 기본값
비고
kinds
PACKAGE, AIRTEL
kinds=PACKAGE
복수선택
PACKAGE, AIRTEL (두 유형을 포함하는 복수 선택 기본값)
패키지 = PACKAGE 에어텔 = AIRTEL
airports
n (공항 id)
airports=971,790
복수선택
인천·김포
설정 가능한 공항 id 인천·김포 = 971,791 (항상 함께 설정되어야 함) 부산 = 790 대구 = 532 무안 = 1530 제주 = 1009

행선지 TS쿼리

•
행선지 TS쿼리는 국가 혹은 여행지, 한 종류의 행선지 유형으로 목록을 생성할 수 있습니다.
◦
다중 국가 입력 및 다중 여행지 입력은 가능하지만, 국가와 여행지를 혼합하여 목록을 생성할 수는 없습니다.
Search
TS쿼리
파라미터
입력값
입력예시
설정 유형
비고
countryIds
n (국가 id)
countryIds=49,53
복수선택
placeIds
n (여행지 id)
placeIds=663,1056,47
복수선택

필터 TS쿼리

•
트립스토어 행사목록에서 사용자가 필터로 제어할 수 있는 다양한 상품의 특성들을 제어하는 TS쿼리 입니다.
•
필터 TS쿼리를 적용하여 목록을 생성할 시 해당 필터가 적용 된 채로 목록에 접근 됩니다.
Search
TS쿼리
파라미터
입력값
입력예시
설정 유형
비고
priceGte
n (n만원)
priceGte=100
단일선택
priceLt
n (n만원)
priceLt=200
단일선택
periods
n/m (n박m일)
periods=3/4,3/5
복수선택
airlineIds
n (항공사 id)
airlineIds=15,36,41
복수선택
departureTimes
hh/hh (hh시/hh시)
departureTimes=06/12,12/18
복수선택
설정 가능한 출발 시간 새벽 출발 = 00/06 아침 출발 = 06/12 오후 출발 = 12/18 저녁 출발 = 18/24
numberOfShoppingActivities
n (n회 이하)
numberOfShoppingActivities=2
단일선택
tourOperators
n (여행사 id)
tourOperators=3,4,31
복수선택
benefits
SPECIAL_PRICING, HALF_PRICE_FOR_CHILD
benefits=SPECIAL_PRICING,HALF_PRICE_FOR_CHILD
복수선택
특가 = SPECIAL_PRICING 아동반값 = HALF_PRICE_FOR_CHILD
accommodationStaredIds
n (숙소 id)
accommodationStaredIds=36,422,752
복수선택
accommodationStars
n (n성급)
accomodationStars=3,4
복수선택
설정 가능 한 성급 3~5 (0.5 단위 없음)
accommodationFacilityIds
n (부대시설 id)
accommodationFacilityIds=1,2,6
복수선택
설정 가능한 부대시설 수영장 = 1 마사지/스파 = 2 사우나/온천 = 3 아동편의시설 = 4 레스토랑/바 = 5 풀사이드 바 = 6 액티비티 = 7 오락시설 = 8
productFeatureTagIds
n (상품특징 id)
productFeatureTagIds=34,62,102
복수선택

기타 TS쿼리

•
이 외의 추가적인 TS쿼리들은 다음과 같습니다.
Search
TS쿼리
파라미터
입력값
입력예시
설정 유형
비고
title
목록 타이틀
title=괌 · 사이판
단일선택
목록의 타이틀로 설정 할 텍스트를 입력
packagePlanCodes
상품코드
packagePlanCodes=ABG201BIDS,ABN201BIC4,ACP201KE15
복수선택
목록에 표기 할 특정 상품의 여행사 상품코드를 입력
keepers
설정 키퍼스 값
keepers=western1
복수선택
채널연동사용불가, 상품코드 묶음으로 한시적으로 사용
destinationIds
n (국가 id)
destinationIds = 122,123
복수선택
입력 한 countryIds와 동일한 destinationIds를 TS쿼리에 입력하여 여행지 필터 활성화