ForeSee Developer Portal

Everything you need to set up and optimize your ForeSee product. Home of developer documentation, implementation guides, and question/answer forums.


Web SDK Release Notes

Public releases of the Web SDK are outlined here. Unless specified, these notes apply to the CX Measurement, Replay, and Feedback products.

Release 19.7.3

Released October 11, 2018

  • Adjusted frequency of network communication for basic session information (non-PII).
  • Provided opt-out for analytics event tracking.
  • Created option to store ForeSee® Replay data within Session Storage (as an alternative to Window.Name).
  • Created option to allow removal of CPPs from Feedback only implementations (this feature was already supported for implementations which contain a CX Measurement survey).

Release 19.7.2

Released September 17, 2018

  • Bug fixes for a few Replay issues.

Release 19.7.1

Released September 11, 2018

  • Improved quality of Replay capture.
  • Enabled Replay capture across domains (as long as the same ForeSee® SDK is running on both sites).
  • Suppress invitation in Micro-cookie mode if server connection is not available.
  • Created new Feedback event listeners, as described in API Event Hooks.
  • Disabled tracker conversion on IE11 (users must click the link in the tracker window once their session is over to begin the survey).
  • Improved capture of Omniture Beacon used for Adobe Analytics integration.
  • Created option to hide the OK button on the thank you page of a Feedback survey.
  • Improved event capture to include page view data.

Release 19.7.0

Released July 26, 2018

  • New configuration options for Replay masking, including the All Masking mode, which is described in the Replay Masking article.
  • Option to use the new Replay engine which improves capture rate and website performance.
  • Option to use the new Modern template for the CX Measure invitation. Details in Personalize Your Survey Invitation.
  • Accessibility improvements for classic desktop invitation.
  • Updated on-exit SMS flow to be only one message (instead of two).

Release 19.6.8

Released June 1, 2018

  • Fixed issue where users would receive multiple consecutive survey invitations in extremely rare cases with micro-cookie based tracking mode.

Release 19.6.7

Released May 24, 2018

  • Fixed issue where ForeSee - Adobe integration wasn't working in some rare cases with long URLs and certain Adobe Analytics versions.

    Released May 4, 2018
    *Updated device detection library in survey code to use WURFL.

Release 19.6.6

Released April 18, 2018

  • Fixed issue where ForeSee® API wasn't responding in some rare cases.

Release 19.6.5

Released April 17, 2018

  • Increased contrast ratio of star ratings in Feedback survey.
  • Fixed issue where URL CPPs wouldn't update in some rare cases.
  • Updated event tracking for Feedback surveys.

Release 19.6.4

Released March 29, 2018

  • Created a 'lasttab' mode for the Exit Intent invitation in which the invitation will load only if only one tab of the client's site is open.
  • Created an option to center the tracker window.
  • Fixed a bug where the survey definition pinning wasn't working in some rare cases.
  • Fixed a bug where CPPs containing a space weren't correctly ingested when appended to a Feedback weblink.
  • Removed the terms CPP.

Release 19.6.3

Released March 5, 2018

  • Fixed an issue where the Feedback survey in overlay mode wouldn't scroll correctly in rare cases on Web SDK 19.6.2.

Release 19.6.2

Released February 28, 2018

  • Fixed an issue where the Web SDK would conflict with mootools.js in some rare cases.
  • Fixed an issue where the tracker window wouldn't load in some rare cases in micro-cookie mode in Firefox and Chrome.
  • Fixed an issue where Feedback surveys wouldn't load in some rare cases.

Release 19.6.1

Released February 23, 2018

  • Fixed an issue where CX Measure desktop tracker window would unexpectedly close in rare cases.

Release 19.6.0

Released February 1, 2018

  • Enabled an option to activate a CX Measurement invitation on a desktop device if it appears that a user is about to end their session (as determined by mouse movement).
  • Enabled an option to limit the presentation of the CX Measurement mobile invitation (invitation can be configured to only persist through a certain number of pages in a 24-hour period before it automatically closes).
  • Fixed an issue where CPPs weren't ingested for Feedback surveys if the weblink URL was encoded by an email client.
  • Improved accessibility of Feedback surveys by enhancing tabbing/focusing behavior and include additional aria-labels.
  • Ended support for Internet Explorer 10 and Android versions 4.4-4.9.
  • Disabled health check from CX Measurement, Feedback and Replay products.
  • Enabled support for the Survey 2.0 application.
  • Enabled support for UK phone numbers for survey invitations delivered via SMS.
  • Fixed an issue where Feedback surveys could not be submitted in rare cases due to URI size.
  • Fixed an issue where console errors were being logged in rare cases for Feedback surveys using the custom JavaScript deployment option.
  • Updated placement of the Terms and Conditions link on CX Measurement invitations for mobile devices.
  • Fixed minor visual inconsistency in the banner image on Feedback surveys deployed via site badge and weblink.
  • Fixed issue where the 'Privacy Policy' label on a Feedback survey deployed via weblink wasn't updating to the correct language on an expired survey.

Release 19.5.2

Released December 19, 2017

  • Added an API Method to suppress the CX Measurement invitation.
  • Enabled multi-language support for Feedback.
  • Added a default CPP to distinguish if a Feedback survey was completed from a website badge or a weblink.
  • Increased stability of CX Measurement tracker window and micro-cookie mode.
  • Fixed an issue where Feedback badge wouldn't appear for mobile devices unless it was activated for desktop devices as well.

Release 19.5.1

Released October 16, 2017

  • Fixed issue where Feedback survey didn't display properly for a few clients.
  • Fixed issue where Feedback comment text was duplicated in CX Suite.
  • Added new analytics events to better analyze Replay collection.
  • Improved collection rate for OMTR_VID (CPP for Adobe Analytics integration).
  • Added collection for new Adobe Analytics IDs needed for Feedback integration.
  • Fixed issue where desktop tracker window for CX Measurement wasn't closing in some rare cases.
  • Added support for Adobe integration using XML HTTP Request (needed in rare cases).
  • Fixed issue where Feedback badge wouldn't appear if there was no text in the badge.
  • Fixed 404 errors that appeared when manual launch of Feedback survey was wrapped in call to fsReady() command.

Release 19.5.0

Released August 31, 2017
New features:

  • Support for new Feedback features in CX Suite 17.2 release (badge configuration options, exclude URL for survey/topic). Refer to the Help and Training link within CX Suite for details.
  • Added ability to define cookie placement to a specific sub-domain.
  • Added more detail to event data on CX Measurement and Feedback surveys.
  • Improved accessibility of CX Measurement invitation and tracker window.
  • Improved accessibility of Feedback survey.

Bug fixes:

  • Updated default CPPs for site and sitekey to more accurately capture expected values.
  • Fixed a bug where phone numbers entered in a Feedback survey were being masked.
  • Fixed a bug where users would not receive the expected survey in some rare cases when other surveys touchpoints were added or deleted.

Release 19.4.3

Released July 28, 2017

  • Fixed an early-exit issue when pages took a very long time to load.
  • Fixed an early-exit issue when 3rd party analytics not consistently available on entire site.
  • Resolved an issue with replay with text inputs on single page applications.

Release 19.4.2

Released July 17, 2017

  • Fixed a bug where phone numbers entered in a Feedback survey were being masked.

Release 19.4.1

Released July 11, 2017

  • Fixed a bug where phone numbers entered in a Feedback survey were being masked (solved specific case where the phone number is the only input to the question).

Release 19.4.0

Released June 28, 2017

  • Release of micro-cookie option, which allows clients to significantly reduce the size of the ForeSee cookie (micro-cookie is around 50 bytes).
  • Improved capture of Replay movies when both CX Measurement and Feedback are running simultaneously.
  • Changed cookie expiration period to two years from last cookie edit.

Release 19.3.7

Released June 12, 2017

  • Fixed a bug where the tracker window wasn't loading in some rare instances due to conflict with Google Analytics.

Release 19.3.6

Released June 9, 2017

  • Fixed a bug where the tracker window opened in a new tab instead of a new window on Chrome 59.

Release 19.3.5

Released June 6, 2017

  • Fixed a bug where the mobile invitation was non-responsive in some rare cases on Single Page Applications.
  • Updated default wording for mobile survey invitation.
  • Improved capture of Replay movies on Angular based websites.
  • Ability to set a CPP based on the presence of a specific cookie.
  • Enabled use of boolean values for trigger configurations.
  • Fixed an issue where the mobile invite would appear on a desktop site in rare cases.
  • Fixed a bug where certain Feedback questions wouldn't render correctly for certain clients.
  • Fixed a bug where bottom right placement option for the desktop invite placement wasn’t precise on large displays.
  • Fixed a bug where Replay recording wouldn't initialize if the survey invitation page was blacklisted from the recording.

Release 19.3.4

Released May 18, 2017

  • Added aria-hidden tag to ForeSee iframe to identify it as a hidden element.
  • Addressed issue with Replay where it was not recording Single Page Applications properly, or not reinitializing itself after was called.
  • Added a capability to defer the loading of ForeSee JavaScript until after the page has finished loading - boosting page load times.
  • Fixed a bug wherein the "browser" CPP was coming across as "undefined" instead of "Chrome" for survey respondents using Mobile Chrome on iOS 10.
  • Fixed an issue wherein the survey tracker window was blocked by Chrome’s pop-up blocker in some rare instances.
  • Fixed issue where some portions of text were unreadable on the "light" theme of the mobile invitation.

Release 19.3.3

Released on May 5, 2017

New Features

  • Release of ForeSee On-Premises Deployment option, which includes CX Measure, Replay and Feedback. This article has more details.
  • Cookie migration script which reads data from older cookies and rewrites them into the new 4c cookie while removing old ForeSee cookies.
  • Ability to adjust invite qualifier / reminder content based on user’s location (locale).
  • Additional masking configuration options for Replay. Currently supporting blacklisting/whitelisting based on cookie value, Javascript variable and URL.
  • Added auto-resizing of mobile invites on non-responsive sites.
  • Added additional configuration options for CX Measure survey invites on desktop (color, font). Also added the ability to remove ForeSee logo on desktop and mobile invites. More details.
  • New API method (FSR.CPPS.all) to read values for all CPPs that have been set More Details (More details).

Technical notes / bugs

  • Fixed issue where tracker window sometimes would not load on IE11.
  • Adjusted reset time for page value count and other CPPs to 24 hours (previously was 90 days).
  • Support for legacy custom invites (not available in 19.3.0-19.3.2).
  • Fixed issue where command wasn’t working correctly in some cases.
  • Deprecated support for functions in trigger configuration files. The CPP API should be used instead.
  • V3: Fixed issue where mobile invite could not be ignored in some cases.
  • V3: Fixed issue where page views where double counted in some cases.

Release 19.3.2

Released on March 26, 2017

  • Fixed issue on Feedback where client logo wouldn’t appear in some cases.
  • Added new extension point to get the invitation status of a user. This article has more details.
  • Fixed issues where Feedback survey and/or badge weren’t loading properly in rare instances.
  • Fixed variable checking for survey include/exclude.
  • Fixed timing issue with fsReady() and acsReady() making API not available at the right time.
  • Fixed display issues in IE10 for Feedback.

Release 19.3.1

Released on February 11, 2017

  • Improved compatibility with Google Analytics.

Release 19.3.0

Released on February 9, 2017

  • Ability to configure mobile invite colors (see How to Personalize Your Survey Invite for more details).
  • New “light” themed mobile invite template.
  • Fixed issue which would cause other pop-ups to appear over the survey invite or Feedback button in rare instances.
  • Improved collection of Feedback CPPs.
  • Fixed issues with tracker window and survey invite on IE10, IE11, and Safari.
  • Support dropped for IE9.
  • Changes to ForeSee cookie.
    • Cookie name changed from __fspl__ to _4c_ to avoid conflicts with previous versions of code.
    • Cookie now utilizes DEFLATE compression for ~30% reduction in overall size.
  • Fixed issue where selecting privacy link on mobile survey invite would hide the invite.
  • Improved tabbing from web page to invite modal (better for accessibility).

Release 19.2.0

Released on January 16, 2017

  • New mobile invitation look to comply with Google mobile accessibility standards.
  • Ability to set sampling percentage and loyalty factor by locale.
  • Ability to disable some built-in CPPs added.
  • Support for custom invitations added.
  • Tweaks to pinning and locking feature of trigger code.
  • Improved conversion funnel reporting for trigger code.
  • Replay session expiration tweaked. Sessions now expire one hour after the last page load.
  • New API extension to log custom events.

Release 19.1.4

Released on December 2, 2016

  • Automatic prevention of overlapping invitations when showInvite() is called more than once.

Release 19.1.3

Released on November 17, 2016

  • Automatic deletion of legacy ForeSee cookies.

Release 19.1.2

Released on November 10, 2016

  • Feedback badge display issues resolved.
  • Feedback survey display issues resolved.
  • Feedback IE8 blocking implemented.
  • Feedback moving between security origins fixed.
  • Feedback in-page reporting project list display issues fixed.
  • Feedback skip-logic in surveys now supported.
  • Feedback Incognito mode issues addressed.

Release 19.1.1

Released on November 3, 2016

  • Cookie-based CPPs issue resolved.
  • Accessibility improvements with the ForeSee DHTML invitation.
  • Omniture Beacon ID captured automatically now.
  • Repeat-days setting now configurable by survey-definition.
  • Survey definition lock mode working as expected now.

Release 19.1.0

Released on October 20, 2016

  • Replay recorder file size reduced 5%.
  • Cookie name changed from acs.t to _fsspl_.
  • Replay tracking improved in older IE versions (on insecure pages).
  • Environment detection improved. OSX and Windows OS version detected more reliably.
  • Custom loyalty-factors by locale.
  • CPP by function fix.
  • Ability to disable Chrome tracker window alert.
  • Logos now loaded off the Foresee CDN.
  • Service health checked now before presenting invitations or feedback badges.
  • TrustE badges removed.
  • Cookie size reduced a little.

Release 19.0.35

Released on October 12, 2016

  • ARIA accessibility improvements to DHTML invitations.

Release 19.0.32

Released on September 1, 2016

  • Added support for function-based CPPs (allows for GA and Omniture integration).
  • Fixed Regex on URL issues for survey include/exclude.
  • Fixed variable checking for survey include/exclude.
  • Fixed cookie checking for survey include/exclude.
  • Fixed sampling percentage of 0 from being treated as 100.
  • Stopping survey invites from appearing within iframes.

Release 19.0.31

Released on August 17, 2016

  • Adding config to not signal page navigation when iFrame source changes.
  • Adding support for function-based CPPs.

Release 19.0.30

  • Resolved some script errors.

Release 19.0.29

  • Resolved errors caused by masking node targeting.

Release 19.0.28

  • Resolved some script errors caused by recorder instance not being set properly in some cases.
  • Removed required notation on Feedback Thank You page.

Release 19.0.27

  • Resolved numerous mobile display issues on Feedback.
  • Issue where repeatDays was not working and survey was not re-inviting after 90 days (in some cases) is resolved.
  • Invitation ForeSee logo linked to wrong landing page, now links to correct landing page for information about ForeSee.
  • Feedback badges were stacking up on HTML5 navigation events. This is now resolved.
  • Added the ability to turn off iFrame tracking (Replay).
  • Repaired inline-PII whitelisting feature (Replay).

Release 19.0.24

  • Storage frame accessibility update. HTML title attribute is more descriptive.
  • Basic qualifiers are now available and are more visually appealing than previous.

Release 19.0.22

  • Added support for HTML5 "single page applications." HTML5-style navigation events are considered to be page changes now by Trigger code, Replay, and Feedback.
  • Feedback public API namespace renamed from FSFB to FSRFB.

Release 19.0.21

  • Re-added and improved capability from <=18x. Now available as FSR.pageReset(). This feature lets you simulate a page change in cases where there was no browser navigation event.
  • Improved event unbinding and cleanup to be more thorough.
  • Replay: Increased sampling rate of mouse move events by 20% for better recordings.

Release 19.0.20

  • Replay: More reliable capture of DOM events that occur in rapid-fire succession.
  • Resolved an issue with Ajax requests where Replay data was sometimes appended.
  • Resolved several minor JavaScript exceptions that would interrupt triggering on rare occasions.

Release 19.0.13

  • Cross-domain iFrame recording in Replay now possible.
  • Fixed JavaScript errors on mobile and desktop Safari when Private Browsing mode is used.
  • Mobile sessions begin transmitting on first page to reduce gradually increasing memory allocation over the course of a recording.
  • Fixed DOCTYPE detection in Replay, fixing layout issues on some sites.
  • Replay refactored as a singleton to support Feedback integration and recordings that are shared between Feedback and cxMeasure.

Release 19.0.0

  • Changed cookie name from fsr.s to acs.t.
  • Replay DOM capture and masking performance improved 22% by optimizing capture functions.
  • Total file size reduced 17.5% when Replay is included, 36% without.
  • Survey definitions, and language tables now written into the gateway JS file rather than contained in a separate file - speeding download times.
  • Trigger and Replay are only downloaded now if needed on the page.
  • Fixed detection of IE 11 Edge.
  • Added storage feature detection.
  • Sometimes-used features (True Conversion, Invitation, Replay) are now separated from main code base and bootstrapped when required.
  • Replay and Trigger are now loaded in parallel for ~30% download performance boost when both are used.
  • Commonly used utilities between Trigger, Feedback, and Replay separated into unique file.
  • Invitation, tracker window, and test page driven from templates for greater customization ability.
  • A/B Testing of invitation and tracker windows.
  • Three new invitation styles to choose from.
  • Minifaction method changed from Closure Compiler to UglifyJS2 resulting in fewer minification related regressions.
  • Replay transmissions only support CORS transport.
  • GZip compression for Replay is automatic for transmissions over 1kb resulting in smaller payload sizes.
  • DOM events are now properly unbound on page unload and when invitation is removed from UI resulting, fixing memory leaks in older browsers.
  • Fixed onUnload handling of Replay storage resulting in fewer 'broken' sessions.

Release 18.4.13

  • Resolved iOS 10 detection issue.

Release 18.4.11

  • Adding option in Tracker.Config to remove the tracker click to close binding.

Release 18.4.9

  • Adding iframe name, changing iframe title.

Release 18.4.7

  • Fix for Reverse Buttons functionality in survey invitation.

Release 18.4.3

  • Fixed retrieval from storage.

Release 18.3.8

  • Matching doc types to fix rendering issues on web pages.

Release 18.4.0

  • Moving Foresee logo to bottom.
  • Fixed retrieval from storage.
  • Reverting cookie retrieval functionality that was breaking pooling.
  • Overcoming console errors.

Release 18.2.7

  • Adding checks for _4c being defined.
  • Matching doc types to fix rendering issues on web pages.
  • Fixed and DOM storage persistence on unload.
  • Ensuring only one heartbeat per page load by checking for optional auto parameter.

Release 18.2.0

  • Updating device detection endpoint.
  • Fixing offsets for grey area in FSR overlay.
  • Replay performance enhancements for mobile and tablet.

Release 18.1.16

  • Added CPP for users who click on the tracker window.
  • On hybrid mode service check failure, set 'rt' to true to begin transmission.
  • Initialize bug fix: check if self references window. If not, use window instead of self.

Release 18.1.10

  • When JSON.stringify() is passed an object with a toJSON() method, it stringifies the return value of toJSON() instead of the original object.
  • Some users were adding a toJSON prototype to Array, which causes our sent data to be double-escaped.
  • Fix for IE8 'JSON.stringify' of null DOM properties.
  • Updated TRUSTe seal & information.

Release 18.1.8

  • Fixed styling issues on reminder.html.
  • Added Default Multi-Variant CPP and invite event override of type property.
  • Frame controller updated it's status check to return true correctly
  • Frame controller updated it's postMessage check to ensure that the method is available after existence check.

Release 18.1.6

  • Pool.js set pool state to 'out' if postMessage if not available.
  • IE8 Compatibility mode user agent recognition
  • Adding IE# to overlay class name to address cases where IE9 specific CSS is needed on the invite.
  • Changes to support white list inline html blocking and element unblocking.
  • Changing default transport list to (CORS, then SWF) for all browsers except IE 8,9.
  • Build numbers update to 18.1.24, 18.1.24, 1.1.4 and added cloud Replay recording endpoint.

Release 18.1.5

  • Hosted Code: CPPs not being passed to survey.
  • Adding mi-oneplus to mobile ua detection list.
  • Checking for instanceof Node before modifying CSS to overcome weird behavior of site.
  • Adding title attribute to iframe for HTML 508 Compliance.

Release 18.1.4

  • Fix for when opening a new window with some specific configurations.
  • Dropped iOS6 support. Will not record prior to iOS6 now.
  • Edge case when detecting IE7 resolved.
  • Whitelisting form elements on Webkit improved.
  • Added JSON.stringify and parse support for older IE (<8).
  • Added close-window confirmation on tracker window.

Other articles in this section:

  1. Client Code Release Notes (current article)
  2. Frequently Asked Questions
  3. Implementing Client Code
  4. Invitation Behavior
  5. Testing Client Code
  6. SDK Extension Points
  7. Client Code Cookies
  8. Customer Passed Parameters
  9. ForeSee URL API
  10. Replay
  11. Security & Reliability
  12. 508 & WCAG Compliancy