LogoLogo
Insights
  • Introduction
  • A standard integration
  • FAQ
    • FAQ
      • Integration (FAQ)
      • Detections (FAQ)
      • Data interface (FAQ)
      • Security, Privacy and Terms of Service (FAQ)
      • Journeys and Insights (FAQ)
  • SDK
    • Getting Started
      • Android Quick Start
        • 1. Android Checklist
        • 2. Including the SDK
        • 3. Configuration
          • Sample Notification
        • 4. Initialization
        • 5. Starting Detections
        • 6. SDK Status Updates
        • 7. Permissions
        • 8. What's Next
      • iOS Quick Start
        • 1. iOS Checklist
        • 2. Installation
          • Installation with CocoaPods
          • Installation with Carthage
          • Manual Installation
        • 3. Configuration
          • Using Integration Guide
          • Manual Configuration
        • 4. Usage
        • 5. Tips and Guidelines
        • 6. What's Next
      • React Native Quick Start
        • 1. React Native Checklist
        • 2. Installation
        • 3. Configuration
        • 4. Initialization
        • 5. Usage
        • 6. What's Next
    • Appendix
      • Android
        • Android 10 Update Behavior
        • Android Battery Optimization
        • External SDK Dependencies
        • Manifest Permissions
        • Notification Management
      • iOS
        • App Store Privacy Section
        • App Store Release
        • iOS 13 permission changes
        • M1 Simulator Support
        • Swift Support
      • Control Sending Data
      • Controlled Detections
        • Automatic Detections
        • Automatic Detections with Forced Trips
        • Controlled Trips Only
        • Checking Trip Status
      • Custom User Metadata
      • Detecting Vehicle Crashes
      • Migration Guide
        • Android
        • iOS
      • React Native
      • SDK Initialization
      • User Credentials
      • User Linking
      • Xamarin
    • API Reference
      • Android
        • VehicleCrashDetection
          • VehicleCrashEvent
          • VehicleCrashListener
          • CrashCallback
        • InitState
        • MetaUserLinker
        • MetaUserLinkerAsync
        • MetaUserLinkerCallback
        • OnInitCallback
          • InitIssue
        • OnSdkStatusUpdateHandler
        • OnStartFinishedHandler
        • PoiAddress
        • PoiLocation
        • PointOfInterest
        • PoiPlace
        • ResetCallback
          • ResetFailureReason
        • SdkConfig
          • Builder
        • SdkException
        • SdkStatus
          • LocationSetting
          • Quota Status
          • StartStatus
        • Sentiance
        • SubmitDetectionsCallback
        • StationaryInfo
        • Token
        • TokenResultCallback
        • Trip
          • StartTripCallback
          • StopTripCallback
          • TransportMode
          • TripTimeoutListener
          • TripType
        • TripInfo
        • TripProfile
          • HardEvent
          • TransportSegment
          • VehicleMode
        • TripProfileConfig
          • Builder
        • TripProfileListener
        • UserActivity
        • UserActivityListener
        • UserActivityType
      • iOS
        • MetaUserLinker
        • SENTSDK
          • SENTSDKStatus
          • SENTPublicDefinitions
        • SENTConfig
        • SENTTripProcessingTripProfile
          • SENTTripProcessingTransportSegment
          • SENTTripProcessingHardEvent
          • SENTTripProcessingVehicleMode
        • SENTVehicleCrashEvent
      • React Native
    • Battery Optimization
    • How To
      • Check the Location Permissions
    • Troubleshooting
      • Android
      • iOS
        • Bundle format unrecognized, invalid, or unsuitable
        • Error: Undefined symbols for architecture arm64
    • Changelog
      • Android
      • iOS
  • Important topics
    • Authentication and Authorization
    • User linking
    • PlayStore Location Access Review
    • Privacy Report & Dashboard
    • Vehicle Crash Detection
  • Library
    • Events
    • Moments
    • Segments
    • Glossary
  • Backend
    • GraphQL
    • REST API Reference
      • Error Codes (REST API)
    • Offloads
    • Data Reference
      • Data Reference A-B
      • Data Reference C-G
      • Data Reference H-L
      • Data Reference M-P
      • Data Reference Q-T
      • Data Reference U-Z
  • Data Explorer
    • Data Explorer
      • Global (EU)
      • US
      • Australia
  • Guide
    • Firehose
    • Verifying your integration
    • SDK Standard License
    • Journeys License
    • Journeys Application
    • Journeys Privacy Policy
    • Technical & Organizational Measures
Powered by GitBook
On this page
  • Enable Triggered Trips
  • Meta-User Linking
  • SENTConfig API:
  • baseURL
  • appId
  • secret
  • launchOptions
  • didReceiveSdkStatusUpdate
  • link
  • registerBackgroundTaskIdentifiers
  • isHardEventDetectionEnabled
  • initWithAppId: secret: launchOptions:
  • initWithAppId: secret: link: launchOptions:
  • isValidConfig
  1. SDK
  2. API Reference
  3. iOS

SENTConfig

PreviousSENTPublicDefinitionsNextSENTTripProcessingTripProfile

Last updated 1 year ago

This document refers to deprecated parts of the platform and has been left intact to help customers with legacy integrations. In order to access the latest platform features and documentation, please go to https://docs.sentiance.com.

The SENTConfig class allows you to specify your Sentiance app ID and secret when initializing the Sentiance SDK.

Enable Triggered Trips

Triggered trips enables controlled detections from your app. To run the SDK in triggered trips mode, use the following configuration option:

[config setIsTriggeredTrip: TRUE];

Learn more about triggered trips .

Meta-User Linking

Sentiance assigns to each user a unique ID. You can link your app's user to the Sentiance user using meta-user linking. The linking step involves server-to-server communication, and is triggered by the SDK via a meta-user linking callback. You can implement this callback method as follows:

MetaUserLinker metaUserlink = ^(NSString *installId, 
                                void (^linkSuccess)(void), 
                                void (^linkFailed)(void)) { }

SENTConfig *config = [[SENTConfig alloc] initWithAppId:APPID
                                                secret:SECRET
                                                  link:metaUserlink
                                         launchOptions:launchOptions];

Learn more about meta-users .

SENTConfig API:

baseURL

Set the platform base URL

@property (nonatomic, strong) NSString *baseURL;

appId

App ID created and managed by Sentiance's Developer Dashboard

@property (nonatomic, strong) NSString *appId;

secret

Secret token created along with App ID

@property (nonatomic, strong) NSString *secret;

launchOptions

Key value pair passed from [AppDelegate application:application didFinishLaunchingWithOptions:launchOptions]

@property (nonatomic, strong) NSDictionary *launchOptions;

didReceiveSdkStatusUpdate

@property (nonatomic, copy) void (^didReceiveSdkStatusUpdate)(SENTSDKStatus* issue);

link

@property (nonatomic, copy) MetaUserLinker link;

registerBackgroundTaskIdentifiers

Set to YES to allow the SDK to register its own background task identifiers during initialization. By default, this is set to NO. You should set it to YES only when initializing the SDK within your app delegate’s application:didFinishLaunchingWithOptions:launchOptions: method, as registering tasks outside of this method can cause iOS to terminate your app.

@property (nonatomic, assign) BOOL registerBackgroundTaskIdentifiers;

isHardEventDetectionEnabled

Deprecated

This property was deprecated in v5.12.0, as part of the Trip Profiling feature deprecation.

A boolean value indicating whether hard event detection should be enabled.

@property (nonatomic, assign) BOOL isHardEventDetectionEnabled;

initWithAppId: secret: launchOptions:

SDK configuration initialization method. Returned SENTConfig object is passed to [SENTSDK initWithConfig].

- (id)initWithAppId: (NSString *) appId 
             secret: (NSString *) secret 
      launchOptions: (NSDictionary *) launchOptions;
Parameter

appId

Application key which you get from Sentiance account.

secret

Secret key which you get from Sentiance account.

launchOptions

initWithAppId: secret: link: launchOptions:

SDK config intialization method with linking to customer's user id. It creates a continuous Sentiance profile across application installations and re-installations on different devices, linked together by their own user id.

- (id)initWithAppId: (NSString *) appId 
             secret: (NSString *) secret 
               link: (MetaUserLinker) link 
      launchOptions :(NSDictionary *) launchOptions;
Parameter

appId

Application key which you get from Sentiance account.

secret

Secret key which you get from Sentiance account.

link

launchOptions

isValidConfig

Check if App ID and Secret are valid

- (BOOL)isValidConfig

Callback to receive current status of SDK. Returns

linking handler your own user to a Sentiance user.

A dictionary indicating the reason the app was launched (if any). The contents of this dictionary may be empty in situations where the user launched the app directly. For information about the possible keys in this dictionary and how to handle them, see .

type block which returns linkSuccess or linkFailed depended on how linking gone. Use InstallId to link with backend.

A dictionary indicating the reason the app was launched (if any). The contents of this dictionary may be empty in situations where the user launched the app directly. For information about the possible keys in this dictionary and how to handle them, see .

here
here
SENTSDKStatus
MetaUserLinker
Launch Options Keys
MetaUsersLinker
Launch Options Keys