Skip to main content

Introduction

@journey/loyalty is a lightweight, client-side script for allowing guests to join the Journey loyalty program directly from your website and access their official Journey Loyalty account for the purposes of making “members only” reservations on your website. Data shows that the Journey Loyalty SDK increase conversion rate on your direct booking engine, while the “Members Only Rates” Closed User Group rates empower your team to increase your public BAR rate (and those of OTA partner’s that require narrow rate partity). The Journey SDK Script also handles some basic analytics to help you gauge performance of the loyalty program and impact on your brand, based in part on the open-source analytics.js library. This script lets you track sessions on the client-side and measure performance of your direct booking engine for various segments (e.g. members vs. non-members, etc.).
Ensure you reach out to your Alliance Partner Guide to request your data-brand-id to ensure your Loyalty integration is configured properly on your website.

Installation guides

You can install the @journey/loyalty via various methods depending on your website setup, but manual installation on your website is suggested for most use cases to avoid guest issues.

Manual Installation

With @journey/loyalty, you can enable your visitors/guests to join the Journey loyalty program directly from your website and access their Journey account for the purposes of making “members only” reservations on your website. Data shows that the Journey Loyalty SDK increase conversion rate on your direct booking engine, while the “Members Only” Closed User Group rates empower your team to increase your public BAR rate (and those of OTA partner’s that require narrow rate partity). Add the following script to your website the same way you would add Google Analytics script or any other JavaScript code – by adding the @journey/loyalty script in the <head> section of your HTML file on your website.
<script
 src="https://start.journey.com/client-sdk/latest/loyalty.js"
 data-brand-id="abcdefghijk12345">
</script>

Custom Tracking Domain (CNAME)

Configuring a CNAME helps enhance tracking and analytics for the @journey/loyalty program. The latest browser enhancements block third-party tracking and certain analytics by default and this setup helps avoid being blocked inadvertently.

What is a Custom Tracking Domain?

With Journey, you can use a Custom Tracking Domain so Journey Loyalty code, cookies and pixels are loaded from your website’s domain (e.g. journey.mysite.com) instead of start.journey.com. To do this, you, or the person in charge of your domain and DNS records will need to add a few specific DNS records for your domain.
  1. Decide upont the desired CNAME subdomain e.g. journey.mysite.com where the journey part is the “subdomain”. We suggest journey but you could make this any word you desire…you just need to register it within the HXP or with your Alliance Partner Guide.
  2. Create 2 New Records in your DNS:
    1. a CNAME record
      1. Record Type: CNAME
      2. Host: journey
      3. Value: start.journey.com
    2. a TXT record
      1. Record Type: TXT
      2. Name: cf-custom-hostname.CNAME.MYSITE.com
      3. Value: TO BE PROVIDED BY YOUR GUIDE
In the above, replace CNAME with the HOST you sleected in Step 1 (e.g. journey) and replace MYSITE.com with your domain.
The outcome of the above, is that the script tag that you place across your site will now be customized to be hosted on your domain such as
<script 
src="https://CNAME.MYSITE.com/client-sdk/latest/loyalty.js" 
data-brand-id="abcdefghijk12345"> 
</script>

Features

The @journey/loyalty script comes with the following features:
  • Loyalty Member Creation
  • Existing Member Login
  • Member Only Rate Access
  • Journey Discovery Remarketing
  • Booking Engine Cross-Domain tracking*

Verify the Installation

Read the loyalty-analytics installation guide for more information.
You can verify the installation with the following tests:
  1. Open the browser and navigate to your website.
  2. You should see the Journey Widget loaded in the right corner of the website.
  3. Open it to ensure your branding matches the setup.
  4. Sign-in or Sign-up with your Journey Member information (not your Alliance Partner details)
  5. Verify the OTP code
  6. Check that the “Members Only” Rate code is present and applied
  7. Click the book now button and ensure the booking widget loads.