Implementation Guide

To power your Enterprise System

The Smart Trip Tool can be used to allow your staff to visit your various plant locations, or to allow your clients to plan a trip to see prospects, clients and other venues.

If for example, they want to take a client out for dinner and stay nearby the restaurant, they could enter the name of the restaurant.  Or, if a bunch of colleagues were going to Top Golf for a team building night, they can enter the name Top Golf and it will find the hotels nearby.  Or of course, they can enter any company/organization name or an address.

To power your events

The Smart Trip tool can be added to your event system to allow anyone traveling to an event to find a hotel nearby.

To be installed on your customers' websites as a VISIT US page

You will benefit from any of your clients that elect to add TripProximity’s smart trip tool to their website as a VISIT US page.

To raise money for any cause that you or your clients care about

Our Smart Giving anywhere tool can be used by you or any of your clients to raise money for 501c3.  Instead of our normal 10% donation annually to your charity of choice, with the use of the Smart Giving tool, on a quarterly basis, we will donate 25% of our gross revenues from bookings made using the tool.

Each individual widget can be a separate campaign for a different charity.  This product is being released 1APR18 to our client base and as an enterprise client, it will be available to you as soon as it is available.  We will keep you posted.

The Event Widget

The Event widget is one of our Smart Trip tools.  It allows you to embed trip planning in any event in your system or on your site or blog.

It is distinct from the Venue widget in that it has a specific date range for the event and a location where the event is held.

Click the Event widget link above to see the FullContact Connect widget for your user conference.  The same widget is used in its DYNAMIC form for the Dossier product.

The next section includes your snippet.  Then you will find the instructions for our Dynamic tool, which shows you how to substitute your data for our variables in real time, so that you only have to install the widget snippet once.  Once it is installed, if you wish to make changes, you can edit the base elements of the widget in the Portal and you do not have to reinstall the snippet. See the defaults in the last section.

Your code snippet (paste in as Text or in a Raw HTML container) for Dossier

<script type=”text/javascript” data-id=”widget” data-token=”P4a1Eg346HW6Fc7Dh8KTjb81V7PwGp7541Npr9MzR8C4f3lZn56d198kA56tIi3x” src=”https://widget.tripproximity.com/js/widget.min.js”></script><div id=”widget”></div>

Your code snippet (paste in as Text or in a Raw HTML container) for your FullContact Connect Conference

<script type=”text/javascript” data-id=”widget” data-token=”2lKauOJDstzvcuzzQ9FQmPA0j55YPg695poGiMYB2cC5Na7dF8Zxhs0s562TWHK7″ src=”https://widget.tripproximity.com/js/widget.min.js” async onload=”tripWidget()”></script><div id=”widget”></div>

Your Variable Settings can be modified in your TripProximity Portal

  • The tool type is set to EVENT
  • The header text is set to “Plan my trip to “
  • Pass the Event Name as a variable
  • The POI name will be appended to the header text
  • We have stored a default image that you can override at display time
  • Pass the Tracking number at display time from your customer information
  • Pass the location information in the address field at display time
  • We default to the US and USD for currency
  • The booking brand will default to the hotels nearby
  • The color scheme uses #b42d27 as the button color and #bababa as the header color
  • The widget is set to display the MAP in front.  If you would like a HOTEL widget as the default, we can change it or we can provide a separate widget for that purpose, which could be called based on a business rule
  • We have enabled the Air and Driving tabs
  • The user can enter the departure and arrival airports at transaction time
  •  The event dates should be passed to us at transaction time

Dynamic Tool - Customizing with variables from your system

Add to the widget snippet the dynamic variable elements that you wish to pass at display time, preceded by the following two lines, shown in green. Follow the variables with the closing code segment, shown in green.

We’ve included the recommended variables for FullContact (shown encased in %VARIABLENAME% signs, which you will strip out in your actual entry):

<script type=”text/javascript”>
tripWidget({
eventStart: ‘YYYY/MM/DD’,
eventEnd: ‘YYYY/MM/DD’,
headerText: ‘Plan your trip to ‘,
appendPOI: ‘Y’,
poiName: ‘%EVENTNAME%’,
address: ‘%STREET%, %CITY%,%STATE%,%POSTCODE%’,
mapTab: ‘1’,
trackingCode: ‘%CUSTOMERTRACKINGINFO%’,
imageUrl: ‘%IMAGEURL%’,
imageLink: ‘%IMAGELINK%’,
})
</script>
The conditional MapTab flag is new.
1.  If there is no address in the contact record, set to 0.  The system will display the hotel page which will allow them to look up the company name or start typing an address and it will complete.
2.  If you have a full address or just city/state, set to 1,  it will default to the map.  If there is no %STREET%, the hotel widget will default to the text in the portal for address, which is instructional on looking up the exact address.
Once you have the code installed, contact us with the test link and we will help to test on multiple platforms and on multiple browsers.

The Venue Widget for your Contact Management System

The Venue widget is one of our Smart Trip tools.  It allows you to embed trip planning on any page in your system or on your site or blog where there is a contact with an address.  A venue can be a physical place, like a company or a museum, or it can be a location like a park or a beach.  As long as we can pinpoint a latitude/longitude, we can “trip enable” the contact record.

It is distinct from the Event widget in that the dates of travel are relative to the date that the tool is displayed, e.g. travel 7 days from today for 1 night.

Click the HDQ widget above to see the widget for the FullContact corporate website for people traveling to see your HDQ staff.  The same widget is used in its DYNAMIC view for your contacts system.

The next section includes your snippet.  Then you will find the instructions for our Dynamic tool, which shows you how to substitute your data for our variables in real time, so that you only have to install the widget snippet once.  Once it is installed, if you wish to make changes, you can edit the base elements of the widget in the Portal and you do not have to reinstall the snippet. See the defaults in the last section.

Your code snippet (paste in as Text or in a Raw HTML container)

<script type=”text/javascript” data-id=”widget” data-token=”8in35HeZY96BBDJEjfa4nc87o4gToRcmJAQ8Kx6Tp2Y7h9qElRh3S88b99Bo59uO” src=”https://widget.tripproximity.com/js/widget.min.js”></script><div id=”widget”></div>

Dynamic Tool - Customizing with variables from your system

Add to the widget snippet the dynamic variable elements that you wish to pass at display time, preceded by the following two lines (your snippet). Follow the variables with the closing code segment.

We’ve included the recommended variables for FullContact (shown encased in %VARIABLENAME% signs, which you will strip out in your actual entry):

<script type=”text/javascript”>
tripWidget({
daysFromToday: ‘7’,
numberOfDays: ‘1’,
headerText: ‘Plan your trip to ‘,
appendPOI: ‘Y’,
poiName: ‘%CONTACTNAME%’,
address: ‘%STREET%, %CITY%,%STATE%,%POSTCODE%’,
mapTab: ‘1’,
trackingCode: ‘%CUSTOMERTRACKINGINFO%’,
imageUrl: ‘%IMAGEURL%’,
imageLink: ‘%IMAGELINK%’,
})
</script>
The conditional MapTab flag is new.
1.  If there is no address in the contact record, set to 0.  The system will display the hotel page which will allow them to look up the company name or start typing an address and it will complete.
2.  If you have a full address or just city/state, set to 1,  it will default to the map.  If there is no %STREET%, the hotel widget will default to the text in the portal for address, which is instructional on looking up the exact address.
Once you have the code installed, contact us with the test link and we will help to test on multiple platforms and on multiple browsers.

Your Variable Settings can be modified in your TripProximity Portal

  • The tool type is set to VENUE
  • The header text is set to “Plan my trip to “
  • Pass the Company or Venue Name as a variable
  • The POI name will be appended to the header text
  • We have stored a default image that you can override at display time
  • Pass the Tracking number at display time from your customer information
  • Pass the location information in the address field at display time
  • We default to the US and USD for currency
  • The booking brand will default to the hotels nearby
  • The color scheme uses #8cba50 as the button color and #3e5058 as the header color
  • The widget is set to display the MAP in front.  If you would like a HOTEL widget as the default, we can change it or we can provide a separate widget for that purpose, which could be called based on a business rule
  • We have enabled the Air and Driving tabs
  • The user can enter the departure and arrival airports at transaction time
  • The travel dates will default to 7 days from the day that the widget is displayed
  • The default trip length is 1 night
  • These can both be overriden by the traveler

The Anywhere Widget for your Clients

The Anywhere widget is one of our Smart Trip tools.  It allows you to embed trip planning to any location for any reason for your customers.  Each user (whether free or paid as a part of a team) can have their own Smart Trip Anywhere widget.

This will be a DYNAMIC widget in that you will pass the customer name into the header of the widget.

The next section includes your snippet.  Then you will find the instructions for our Dynamic tool, which shows you how to substitute your data for our variables in real time, so that you only have to install the widget snippet once.  Once it is installed, if you wish to make changes, you can edit the base elements of the widget in the Portal and you do not have to reinstall the snippet. See the defaults in the last section.

Your code snippet (paste in as Text or in a Raw HTML container)

<script type=”text/javascript” data-id=”widget” data-token=”19Iz0Q71x3RO57sH2e20SOCiyWYh5B3B77C8rP7prO41JLwPT7AX1nKTXR3wzTw6″ src=”https://widget.tripproximity.com/js/widget.min.js”></script><div id=”widget”></div>

Dynamic Tool - Customizing with variables from your system

Add to the widget snippet the dynamic variable elements that you wish to pass at display time, preceded by the following two lines (your snippet). Follow the variables with the closing code segment.

We’ve included the recommended variables for FullContact (shown encased in %VARIABLENAME% signs, which you will strip out in your actual entry):

<script type=”text/javascript”>
tripWidget({
daysFromToday: ‘7’,
numberOfDays: ‘1’,
headerText: ‘Plan your trip to ‘,
appendPOI: ‘Y’,
poiName: ‘%CONTACTNAME%’,
trackingCode: ‘%CUSTOMERTRACKINGINFO%’,
imageUrl: ‘%IMAGEURL%’,
imageLink: ‘%IMAGELINK%’,
})
</script>
Once you have the code installed, contact us with the test link and we will help to test on multiple platforms and on multiple browsers.

Your Variable Settings can be modified in your TripProximity Portal

  • The tool type is set to VENUE
  • The header text is set to “Smart Trip Planning for   “
  • Pass the User Name as a variable
  • The POI name will be appended to the header text
  • We have stored a default image that you can override at display time
  • Pass the Tracking number at display time from your customer information to track back to your Client
  • We default to the US and USD for currency
  • The booking brand will default to the hotels nearby
  • The color scheme uses #8cba50 as the button color and #3e5058 as the header color
  • The widget is set to display the HOTEL tab in front.
  • We have enabled the Air and Driving tabs
  • The user can enter the departure and arrival airports at transaction time
  • The travel dates will default to 7 days from the day that the widget is displayed
  • The default trip length is 1 night
  • These can both be overriden by the traveler

What brands can I choose from for the booking system that the traveler sees?

Depending on how you implement the widget, you may have a different need for targeted messaging in the booking system.  For example, for a calendaring implementation, you may want to use TheHotelsNearby Companies.  Or for a contact management system, just TheHotelsNearby.  Or if you are designating all of the upside from using the widget to your favorite charity, you can use TravelingToGive.   The next selection shows you all of the possibilities.

The Brand Options

The default refid is 5135 and the default brand is The Hotels Nearby.
To change the brand to one of our niche brands, you must use the combination of the refid and reflickid2 below.
These can be overridden at transaction time by using the refid and refclickid2 variables
refid= Brand refclickid2=
5135 The Hotels Nearby
6832 The Hotels Nearby Amusement Parks hotelbyattractions
6832 The Hotels Nearby Assisted Living hotelsbyamusementparks
6832 The Hotels Nearby Attractions hotelsbyassistedliving.com
6832 The Hotels Nearby Bloggers hotelsbybloggers
6832 The Hotels Nearby Companies hotelsbycompanies
6832 The Hotels Nearby Convention Centers hotelsbyconventioncenters
6832 The Hotels Nearby Cruise Ports hotelsbycruiseports
6832 The Hotels Nearby Doctors hotelsbydoctors
6832 The Hotels Nearby Embassies hotelsbyembassies
6856 The Hotels Nearby Events hotelsbyevents
6832 The Hotels Nearby Festivals hotelsbyfestivals
6832 The Hotels Nearby Funeral Homes hotelsbyfuneralhomes
6988 The Hotels Nearby Golf Courses hotelsbygolfcourses
6832 The Hotels Nearby Hospice hotelsbyhospice
6855 The Hotels Nearby Hospitals hotelsbyhospitals
6832 The Hotels Nearby Military Bases hotelsbymilitarybases
6832 The Hotels Nearby Museums hotelsbymuseums
6832 The Hotels Nearby Nursing Homes hotelsbynursinghomes
6832 The Hotels Nearby Places hotelsbyplaces
6832 The Hotels Nearby Prisons hotelsbyprisons
6832 The Hotels Nearby Racetracks hotelsbyracetracks
6832 The Hotels Nearby Spas hotelsbyspas
6832 The Hotels Nearby Theatres hotelsbytheatres
6832 The Hotels Nearby Trainstations hotelsbytrainstations
6857 The Hotels Nearby Universities hotelsbyuniversities
6832 The Hotels Nearby Wineries hotelsbywineries
6832 The Hotels Nearby Zoos hotelsbyzoos
7028 TravelingtoGIVE

Private Label Branding

Can we use our own brand?  Absolutely!

For a one time fee of $1500 you can provide your own header artwork to us for the booking back end.

External System Interaction

The TripProximity widget interacts with the following systems:

  • Google Places for lookup of the venues and addresses in the address field
  • Google Maps for lookup of the latitude/longitude of any address

Once the input from the widget is received, we pass a search string to our booking system.  It contains:

  • Brand to be displayed in the booking system
  • Travel parameters
  • Tracking information to provide reporting back to you for each client

CSS

The widget has its own style sheet that governs the display of the widget within a container.

 

Rules for Display

The widget can be populated with event and venue information, as well as contact information.  Ideally, the widget needs the full address to do a lookup of the hotels nearby.

If you only have a city/state, we recommend that you use the conditional map field to display the map with city/state, but to prompt the user to use the Google Places functionality to look up the name of the organization, venue or street address of the place that they are going.

The date fields for events can be coupled with a business rule.  For instance if you have an event that begins before noon, you may want to set the date of arrival to 1 day before the event begins.  If the event ends after 3pm, you may want to set the date of departure to 1 day after the event.

Just a reminder, even if there is no address or a partial address (city/state), our new widget with the GooglePlaces lookup can find the precise address of the venue or company that they are visiting (even a Starbucks or TopGolf! or finding a hotel near someone’s house that works from home).

Press Release Draft

We will assist your marketing team in writing a press release about your implementation.

Email Announcement to your Customer Base

We will help our enterprise craft an announcement of the new capability to your customer base.

Recommended Help Text

We will help our enterprise clients write your HELP text for your client systems.

For any other details regarding widget customization, please access the Support Center.