Skip to content

SiftScience/sift-ios

Repository files navigation

Sift iOS SDK

Integration guide

Here is how to integrate with Sift iOS SDK into your Objective-C iOS app project (for Swift projects the steps are pretty similar).

Installing the library

You may get the SDK into your iOS project through CocoaPods, Carthage and Swift Package Manager

Through CocoaPods:

  • Add this to your Podfile: pod 'Sift' (this uses the latest version).

  • Run pod install.

Through Carthage:

  • Add this to your Cartfile: github "SiftScience/sift-ios" (this uses the latest version).

  • Run carthage update.

Through Swift Package Manager:

  • Inside the root project folder, ​create Swift package with type executable: swift package init --type executable . This will create initial files and folders including hidden​ ​.gitignore​ ​and .build/​.

  • Add dependencies in Package.swift: ​open Package.swift.

      // swift-tools-version:5.1
      // The swift-tools-version declares the minimum version of Swift required to build this package.
      import​ ​PackageDescription
      
      let package = Package(
          name: "exampleApp",
          dependencies: [
              // Dependencies declare other packages that this package depends on.
              ​// .package(url: /* package url */, from: "1.0.0"),
              .​package​(​url​: "https://github.com/SiftScience/sift-ios.git"​, ​from​: "2.2.1"​)
          ],
          ​targets​: [
              ​// Targets are the basic building blocks of a package. A target can define a module or a test suite.
              ​// Targets can depend on other targets in this package, and on products in packages which this package depends on.
              ​.target(
                  name: "exampleApp",
                  dependencies: ["sift-ios"]), // Don’t forget to add sift-ios in target dependencies.
              .testTarget(
                  name: "exampleAppTests",
                  dependencies: ["exampleApp"]),
          ] 
      )
    
  • Save Package.swift file, Xcode will build the package.swift or else ​swift package generate-xcodeproj (Xcode project is generated and excluded from git by default). You can also use your xcconfig file: ​swift package generate-xcodeproj --xcconfig-overrides Config.xcconfig

Update for Xcode 11

  • For Xcode 11 no need to do the above steps, you can directly open the File > Swift Packages > Add Package Dependency
  • Paste the repository's URL https://github.com/SiftScience/sift-ios.git​ into the field above then click "next".
  • Xcode will walk you through the rest of the steps. You can import sift_ios.

Recommended steps:

  • Add this to your application's Info.plist file:

    <key>LSApplicationQueriesSchemes</key>
    <array>
      <string>cydia</string>
    </array>
    

    We detect jailbroken devices with various signals and one of them is whether Cydia is installed. Since iOS 9, you have to whitelist URL schemes you would like to check, and this just adds Cydia to the list.

Initializing the library

The SDK works in the background and so you have to initialize it when your app starts. It usually makes most sense to initialize the SDK in application:didFinishLaunchingWithOptions:.

Here is what you would do within AppDelegate.m:

  • Add #import "Sift/Sift.h".

  • Add the application:didFinishLaunchingWithOptions: instance method if it doesn't exist, and insert this code snippet (replacing the placeholder strings with your Sift account credentials):

    Sift *sift = [Sift sharedInstance];
    [sift setAccountId:@"YOUR_ACCOUNT_ID"];
    [sift setBeaconKey:@"YOUR_JAVASCRIPT_SNIPPET_KEY"];
    
  • (Recommended) If your app uses motion sensors (accelerometer, gyro, or magnetometer), and you want to send motion data to Sift, add this line:

    [sift setAllowUsingMotionSensors:YES];
    

    This will enable the SDK to occasionally collect motion data in the background.

  • If your app uses user location data but you do not want send it to Sift, add this line:

    [sift setDisallowCollectingLocationData:YES];
    

Tracking users

Sift needs the user ID to track the user using this app. Once the user ID is available (for example, after user has logged in), please set the user ID:

[[Sift sharedInstance] setUserId:@"USER_ID"];

If a user logs out, unset the user ID by invoking:

[[Sift sharedInstance] unsetUserId];

License

The Sift iOS SDK is distributed under the MIT license. See the file LICENSE for details.

The Sift iOS SDK includes Charcoal Design's GZIP library, distributed under the permissive zlib license. See the files Sift/Vendor/NSData+GZIP.h and Sift/Vendor/NSData+GZIP.m for details.