iOS

This SDK offers several options to developers and/or companies.

What you can do

• Replay session recordings in our web player
• Capture all of the user interactions and find ones you can about in the Events manager
• Set your own custom analytics event and do complex funnels/queries in the dashboard
• Collect referrer value and source of installation per visitor

Reporting issues

Please report all issues to Smartlook iOS SDK issues at GitHub.

You can also contact our developers directly on our Discord server.

Installation

Install via CocoaPods or download Smartlook iOS SDK.

You need to provide your SDK Key which can be found in Smartlook Dashboard.

Cocoapods installation

1. Add pod 'Smartlook' to your project’s Podfile.
2. Run pod install
3. Import Smartlook SDK in your app’s App Delegate class:
   • Objective C: #import <Smartlook/Smartlook.h>
   • Swift: import Smartlook
4. Initialize the SDK by calling your App Delegate’s application:didFinishLaunchingWithOptions: or application(_:didFinishLaunchingWithOptions:) method.

• Objective C: [Smartlook startWithKey:@"your-smartlook-key"];
• Swift: Smartlook.start(withKey: "your-smartlook-key");

Manual installation

1. Download Smartlook iOS SDK v0.1.11 directly.
2. Unzip the file and add Smartlook.framework to your Xcode project.
3. Import Smartlook SDK in your app’s App Delegate class:
   • Objective C: #import <Smartlook/Smartlook.h>
   • Swift: import Smartlook
4. Initialize the SDK by calling your App Delegate’s application:didFinishLaunchingWithOptions: or application(_:didFinishLaunchingWithOptions:) method.

• Objective C: [Smartlook startWithKey:@"your-smartlook-key"];
• Swift: Smartlook.start(withKey: "your-smartlook-key");

API Reference

Applications can interact with the SDK using public SDK methods.

You need to provide your SDK Key which can be found in Smartlook Dashboard.

Initialize Smartlook

Use: + (void)startWithKey:(nonnull NSString*)key;

This method initializes the SDK. It should be called in App Delegate’s methods:

• Objective C: application:didFinishLaunchingWithOptions:
• Swift: application(_:didFinishLaunchingWithOptions:)

Mark and unmark sensitive views

You can mark sensitive views to be hidden from recordings. Text input fields (UITextView, UITextField) and Web views (UIWebView, WKWebView) are hidden by default. SafariServices and AuthenticationServices web views shows as an empty screen.

To flag or unflag an UIView instance as sensitive, use its BOOL slSensitive property. To set custom overlay color of a sensitive view, use its UIColor slOverlay property.

Both slSensitive and slOverlay are also accessible in Xcode Interface Builder.

Alternatively, these legacy methods can be also used when working with sensitive views: + (void)markViewAsSensitive:(nonnull UIView*)view overlayColor:(nullable UIColor*)overlayColor; + (void)unmarkViewAsSensitive:(nonnull UIView*)view;

Record custom events

Use: + (void)recordCustomEventWithEventName:(nonnull NSString*)eventName propertiesDictionary:(nullable NSDictionary<NSString*, NSString*>*)propertiesDictionary;

You can add custom timestamped events. Those events will be shown in your Dashboard. Smartlook is recording some events automatically (button presses, screens opening). Properties in the dictionary must be strings and values must be strings as well. Other values (like arrays, nested dictionaries) will be stringified.

[Smartlook recordCustomEventWithEventName:@"user-bought-subscription" propertiesDictionary:@{ @"tier" : @"basic" } ]

Smartlook.recordCustomEvent(withEventName: "user-bought-subscription", propertiesDictionary: ["tier" : "basic"]);

Add user identifier

Use: + (void)setUserIdentifier:(nullable NSString*)userIdentifier;

You can specify your app’s user identifier. You can then look up those identifiers in the Dashboard to find specific user’s recordings.

[Smartlook  setUserIdentifier:@"some-user-identifier"];

Smartlook.setUserIdentifier("some-user-identifier");

Add other user properties

Use: + (void)setUserPropertiesDictionary:(nullable NSDictionary<NSString*, NSString*>*)userPropertiesDictionary;

You can set additional user information, such as name, email and other custom properties. You’ll see those properties in the Dashboard in Visitor details. You can use any NSString as a key and any NSString as a value in the dictionary.

Keys “name” and “email” will be highlighted in Visitor information.

[
  Smartlook setUserPropertiesDictionary:@{ 
    @"name" : @"some-name", 
    @"email" : @"some-email", 
    @"some-other-property" : @"some-other-value"
  }
]

Smartlook.setUserPropertiesDictionary([
  "name" : "some-name", 
  "email" : "some-email",
  "some-other-property" : "some-other-value"
]);