*Configure Framework

Set up Device Token (Log in)/ Remove Device Token (Log out)

if ([self userIsAuthenticated]) {
    [RPEntry instance].virtualDeviceToken = [self getDeviceToken];
} else {
    /// empty device token is not allowed
    /// Use removeVirtualDeviceToken method for log out from the host app.
    [[RPEntry instance] removeVirtualDeviceToken];
}

You can't set empty or nil token

Use removeVirtualDeviceToken method when the user logs out from the host app.

Enable and disable Tracking (Optional)

If you want to disable or enable tracking, you can use property disableTracking of RPEntry class

Objective-C

[RPEntry instance].disableTracking = NO;  //enable tracking
[RPEntry instance].disableTracking = YES; //disable tracking

Swift

RPEntry.instance().disableTracking = NO;  //enable tracking
RPEntry.instance().disableTracking = YES; //disable tracking

Enable and disable SDK (Optional)

Disable tracking doesn't disable SDK and it continues to send heartbeats (👉 Dataset). If you want to completely disable SDK, you should remove the Device Token

You can't set an empty or nil token

Objective-C

[RPEntry instance].disableTracking = YES;           //disable tracking
[[RPEntry instance] removeVirtualDeviceToken];      //remove token. 

Swift

RPEntry.instance().disableTracking = YES;           //disable tracking
RPEntry.instance().removeVirtualDeviceToken();      //remove token. 

Enable Bluetooth OBD/ELM Functionality

Bluetooth OBD/ELM functionality enables the host app to work with Bluetooth OBD devices to get in-vehicle data (👉Dataset). To enable this, please use the method below:

Objective-C

[RPEntry enableELM:true]; 

Swift

RPEntry.enableELM(true)

Enable high-frequency data collection (Accurate and persistent dataset)

We strongly recommend keeping it enabled by default

Objective-C

[RPEntry enableHF:true];

Swift

RPEntry.enableHF(true)

Enable Advertisement identifier

To enable Ads identifier, should provide Advertisement identifier to SDK. Please add these lines near the code from the previous section. Make sure, you added import section

#import <AdSupport/AdSupport.h>

Objective-C

if ([ASIdentifierManager sharedManager].isAdvertisingTrackingEnabled) {
    [RPEntry instance].advertisingIdentificator = [ASIdentifierManager sharedManager].advertisingIdentifier;
}

Swift

if (ASIdentifierManager.shared().isAdvertisingTrackingEnabled) {
    RPEntry.instance().advertisingIdentifier = ASIdentifierManager.shared().advertisingIdentifier
}