URL Parameters for Booking Widget (Subdomain)

URL Parameters for Booking Widget (Subdomain)

Info
Purpose: 
This section explains how to create a booking widget URL with parameters for properties using a subdomain.
⏱ Estimated time: ~10 mins
Idea
"URL parameters" refer to variables (strings) appended to the end of a URL.
By placing links with specific URL parameters on a website, various booking widget screens can be launched.
For non-subdomain setups, refer to this manual.

1. What {code} mean in the parameter

  1. Enter the tripla bot code assigned to each property in {code}.
  2. Use the value inside data-triplabot-code="" found in:
    1. Setting page: Property Management Screen. 
    2. Action: 'Admin Setting' → 'tripla Setup'
Idea
▼Example:
・tripla Code: <script async src="https://tripla.jp/sdk/javascript/tripla.min.js" data-triplabot-code="839032cd-b443-42ff-87e9-9ab1b04e7190"></script>
・{code}: 839032cd-b443-42ff-87e9-9ab1b04e7190
WarningMember Program Login (Subdomain Only)

Use the following URL format when logging in to the member program with a subdomain:
https://<subdomain URL>/sign-in?code={code}

▼Example:
https://booking.tripla-ryokan.com/sign-in?code=0193853c-9dc4-79bf-85ed-59286b03018f

This parameter cannot be used with URLs that do not use a subdomain.
Not supported example:
https://www.tripla-ryokan.com/sign-in?code=0193853c-9dc4-79bf-85ed-59286b03018f

2. Specifying Numbers, Strings, and Dates

Numbers, strings, and dates used in parameters are shown in the table below.
Modify each value as needed before use.

 Number
 #
 Text xxx
 Date yyyy/mm/dd
 tripla bot code code

3. Booking Widget

Purpose
Parameter
1. Launch / Open/booking/result?code={code}
2. Reservation Confirmation/Cancellation page
/search?code={code}

4. Room

PurposeParameter
1. Show search results including unavailable rooms/booking/result?code={code}&is_including_occupied=true
2. Display only available room/booking/result?code={code}&is_including_occupied=false
3. Display Room type/booking/result?code={code}&type=rooms
4. Display multiple room type/booking/result?code={code}&room_type_codes=xxx,xxx,xxx
Info*Enter the room code after "="
Warning
When multiple room type filters are specified, only the availability data for the first room type is reflected in the availability calendar.

5. Plan

Purpose
Parameter
1. Display plan result/booking/result?code={code}&type=plan
2. Display multiple plan
/booking/result?code={code}&hotel_plan_codes=xxx,xxx,xxx
3. Displaying secret-mode plans/booking/result?code={code}&hotel_plan_code=xxx&mode=secret
4. Display Day Use Plan/booking/result?code={code}&is_day_use=true
5. Display Voucher/booking/result?code={code}=voucher
Info
*Enter plan code after "="

6. Membership

PurposeParameter
1. Display Membership sign-up page/sign-up?code={code}
2. Display Membership log in/sign-in?code={code}
3. Reset Password/forgot-password?code={code}

7. Parameter for organization login

PurposeParameter
1. Corporate log in/organization-sign-in?code={code}
2. Corporate login (URL Referrer Only)/organization-sign-in?code={code}&organization_id=id
IdeaFor details about organization_id, see here.

8. Promotion

PurposeParameter
Display plans with a coupon code applied
*Enter the coupon code after the "=" sign
/booking/result?code={code}&coupon_code=xxx

9. Property List-When Brand Setting ON

PurposeParameter
View Property list
facilities?code={code}
Idea
  1. The property list can be displayed only when Brand Settings are configured.
    1. Brand Settings: Admin Settings → tripla Setup → Brand Settings
  2. Properties to be shown on the property list page must be selected in advance:
    1. Setting page: Brand Management Screen
    2. Action: 'Setting' → 'Booking Engine' → 'Property Display Settings' → [Active] Suggestion for no stock → check the property, and save.

10. Conditional Booking Widget Launch

10.1 Date

PurposeParameter
1. Specify check-in/out dates/booking/result?code={code}&checkin=yyyy/mm/dd&checkout=yyyy/mm/dd
2. Date not Specify
/booking/result?code={code}&search_type=undated

*For consecutive nights: add {&nights=〇}
▼Example: 2 nights
/booking/result?code={code}&search_type=undated&nights=2

10.2 Number of Guests

Purpose
Parameter
1. Adult Only
/booking/result?code={code}&adults=#
2. Adults + Kids
/booking/result?code={code}&adults=2&kids_tiers=[{"code":"A","children":#},{"code":"B","children":#},{"code":"B2","children":#},{"code":"C","children":#},{"code":"D","children":#}]
3. Specify the number of bed-sharing kids

*Only the number of bed-sharing kids is supported.
This option is not available when kid categories (e.g., Under 12 years old or 6 years old) are used.
/booking/result?code={code}&rooms=[{"adults":#, "children": #},{"adults":#, "children": #}]
Warning
  1. The parameters vary depending on the property’s kids settings.
  2. code.A to code.D represent the IDs for kids categories.

10.3 Sort Order

PurposeParameter
1. Recommended order/booking/result?code={code}&order=recommended
2. Display Price: Low to High/booking/result?code={code}&order=price_low_to_high
3. Display Price:  High to Low/booking/result?code={code}&order=price_high_to_low

10.4 Filter 

Purpose
Parameter
Display multiple filter/booking/result?code={code}&filter=xxx,xxx
Idea
  1. Enter the filter ID after the "="
  2. Filter IDs can be found under: Brand Management Screen
    1. Action: 'Settings' → 'Booking Engine' → 'Search Filters'

11. Language

PurposeParameter
Display language
/booking/result?code={code}&locale=en

en: English
ja: Japanese
ko: Korean
zh_Hans: Simplified Chinese
zh_Hant: Traditional Chinese
id: Indonesian
th: Thai
ar: Arabic

    • Related Articles

    • URL Parameters for Booking Widget

      Purpose: This section is to explain how to create URL to launch various booking widget screens, by placing links with specific URL parameters on the property homepage. ⏱ Estimated time: ~10 mins "URL parameters" refer to variables (strings) appended ...

    • Subdomain Setup for Booking Widget(BW)

      Purpose: This section is to explain basic information and key considerations regarding the use of subdomains for the booking widget. 1. What is Subdomain? A subdomain is used to divide a single domain into multiple parts for different purposes. ...

    • Widget Settings (Search Bar)

      Purpose: This section explains how to install the booking widget and search bar on the website. ⏱ Estimated time: ~10mins In addition to the search bar provided by tripla, the booking widget can also be launched from a custom-designed search bar or ...

    • Google Analytics Settings for Subdomain

      For users utilizing the subdomain feature, we provide guidance on measuring traffic sources using Google Analytics cross-domain tracking. The GA (Universal Analytics) described on this page was discontinued as of June 30, 2023. Please check the ...

    • Subdomain Setup (With SSL Server Certificate File)

      Purpose: This section is to explain Subdomain setup for properties that already have an SSL server certificate file. ⏱ Estimated time: ~15mins Depending on the DNS update frequency and TTL (priority) settings of the property’s DNS provider, it may ...