Release Notes

The Ensighten Objective-C library for iOS supports iOS 8 and above.

Attachments are linked at the bottom of this article.

Version 3.4.2

• Added new setFirstPartyDomain setting that enables data sharing using cookies between Ensighten and other web views deployed in your app.
• Added new setTagContainerBaseUrl setting that enables persistence of certain cookies when using third-party technologies.

Download v3.4.2

Version 3.4.1

• Added Javascript Ready callback

When javascript is ready it will be notified via a completion block. It can be observed using:

[Ensighten setJavascriptReadyCompletion:^{
    // Perform any action after javascript is ready
}];

Download v3.4.1

Version 3.4.0

• Added support for tracking app-specific page views, events, and conversions using the Ensighten Tracker and storing the data in the data layer
• Added a new toJSONString opcode that can be used to convert arrays and dictionaries into JSON strings
• Added new encodeUrl and decodeUrl opcodes that can be used to format data before passing it into the javascript layer
• Bug fixes

Download v3.4.0

Version 3.3.2

1. Removed battery monitoring
2. Added an option to disable automatic swizzling at bootstrap.
   
   

Version 3.3.1

1. Renamed DegreesToRadians to NSTN_DegreesToRadians to avoid symbolic conflicts with other libraries.
2. Renamed RadiansToDegrees to NSTN_RadiansToDegrees to avoid symbolic conflicts with other libraries.
3. Removed erroneous logging in cases where the device is connected to Ensighten Mobile via 4 finger press. 

Version 3.3.0

1. Replaced UIWebView with the updated WKWebView.
2. Tagging no longer causes disconnections from the UI.
3. Updated tracing to improve memory usage and time spent tracing.
4. Tracing and "select from list" moved to async threads.
5. Updated screen rendering to use CADisplayLink with a default frame rate of 10 (60/10 = 6fps).
6. Screenshot - rendering code optimized.
7. Rendering moved to async thread.
8. The force-touch app was updated to prevent launches/resuming that could cause a crash from block-closures being added to an NSArray and subsequently released.
9. Updated other areas where closures might be added to NSArray instances.
10. Tested on iPhone 6s (iOS 11.0 beta 2), iPad mini (iOS 9.3.5).
11. Deployment target (lowest supported OS version) upgraded to 8.0.

Version 3.2.7

1. Added two new opcodes for performing complex content swaps
2. Added support for passing NSValue honored struct types (CGSize, CGPoint, CGRect, CGAffineTransform)
3. Updated how arguments are handled when tagging local notifications
4. Compatibility with iOS 10
5. Improved decoding and encoding base64 strings on legacy OS versions
6. Enhanced Mobile platform connections and screen streaming in realtime

Version 3.2.4

1. Improved UI loading efficiency.
2. Improved tracing logic.
3. Increased support for tracking systems.
4. Improved PUSH notifications. 

Version 3.0.1

1. Includes an important patch for the cached queue file.
2. The 3.0.1 library supports the new Mobile platform.

Version 3.0.1 requires a migration to the New Ensighten Mobile Interface otherwise analytics will fail. Contact the Ensighten Success team to schedule a migration into the new platform.

Version 3.0.0

1. Supports the New Mobile Platform and Associated Features
2. Includes Bitcode Support
3. Tracer Updates and b64 Encoding
4. JSON Configuration Files
5. App Versions now use public versions and not build versions
6. Bug Fixes and Tweeks

Version 2.2.2

1. Compatible with Apple iOS 9.
2. iOS library v2.2.2 supports features that will roll out in our new App Management platform in Q4.
3. Support for Heartbeat-style video tracking including chapters and ads.
4. Persistent test-mode support.
5. General Bug Fixes and Performance Improvements.

Version 2.1.1

1. Removed unnecessary fields from query params.

Version 2.1.0

1. MAJOR : Queuing system changes:
Queuing system now queues actual network requests natively. This is a major difference over queuing strings of java script to be executed later. This allows any js to be evaluated and fully executed in its correct context and separates any data gathering or collection from an actual request which is sent out to an analytics service.

• These requests are NSURLRequest objects.
• Requests which have not originated from our web view are filtered out.
• Requests which occur when offline are queued up to maximum (2500) regardless of batch size (queueDepth).
• A value of -1 for queueDepth will not queue any requests.
• A value of 0 for queueDepth is modified to be 1.
• Any other batch size will queue when online to the size of queueDepth and asynchronously dequeue when the queue is considered full.
• A new config for queueExclusions may be added as a single regex string.
• Offline queued items will dequeue upon reconnection.
• Queues will attempt to be purged regardless of batch size on app suspend.

2. MAJOR : Lifecycle Metrics
New "App Lifecycle" metrics were added into the library by default to excute at certain major and distinct points in an app's run. These are :

• App Launch
• Install
• Launch
• Upgrade
• App Suspend (exited but not quit)
• App Resume (started from suspend)
• App Page View
• App Global Events (button clicks, sliders sliding, bar items tapped, switches switched, segmented controls changed, page controls changed, steppers stepped)

New "lifecycle" member added to params object :

"lifecycle": {
   "previousSessionLength": "97",
   "hourOfDay": "15",
   "currentSessionLength": "60",
   "installDate": "2015-04-23 07:12:09 +798000",
   "launchNumber": "45",
   "daysSinceFirstUse": "5",
   "dayOfWeek": "4",
   "lastUseDate": "2015-04-28 03:29:18 +099000",
   "daysSinceLastUse": "1"
},

3. Movie Watcher has been expanded to allow finer grained control of when polling points execute.

• Offset: comma separated set of seconds from start of movie.
• Milestone: comma separated set of percentages for entire movie.
• Interval: every x numbers of seconds.
• Bug with the polling timer which would only allow the first queue point to execute was repaired.

4. Bug fixes and general updates to support new OS versions.

Version 2.0.3

1. Ensighten bundle path fix
2. All swizzles now use "ensighten_" prefix instead of "original_", "afteroriginal_", etc.
3. Fixed class dumps to json
4. Bug fixes

OPTIMIZATION

1. Advanced Optimization Screen Capturing
2. Drag Drop support
3. Scaling of new images to match original size
4. Text changes grow (not shrink) to accommodate larger text sizes
5. Removed check for commas ( , ) in string mods.
6. Removed "frame" values from hash ids.
7. Removed check for socket being connected. Now relying on isDumpModeOn flag.
   end

Version 2.0.2       

Ensighten Library Update: Includes App Optimization (A/B and MVT Testing)

1. New library supports tag management and our new Optimization engine:
   - Ability to modify elements visually for the following properties (default)
   - background color
   - text color
   - tint color
   - text
   - attributed text
   - hidden
   - alpha (opacity)
   - image by
   - url
   - base64 encoded string
   - previously packaged file
   - Explicit enable/disable personalization
   - Screen "dumping" only allowed when enabled and connected to optimization platform
   - Special advanced custom properties
   - Cache last test and last decision
   - Report on successful tests
   - Access to any view's controller from the view
   - Finding a view controller instance by its screen name
   - Easy connection to optimization platform by 4 second, 4-finger long-press on screen
2. Bug fix for dequeuing and saving large numbers of tags simultaneously.
3. Additional library improvements and cleanup
4. Backwards support for iOS 7. 

 -------------------------------------------------------

Download files here: