Respecting data privacy f69123

Data collection / Apple / Users / Respecting data privacy

Foreword

So that you can respect user privacy and be in accordance with the regulations in different countries, the tracker makes two features available:

• Disabling user tracking
• Hashing user IDs
• Gestion de la sauvegarde des hits hors ligne (si l’option est activée)

Disabling user tracking (opt-out)

If your application offers a screen allowing the user to enable or disable statistical tracking, you can save this information via the static optOut property of the ATInternet class.

Hits will nonetheless be sent. Only the idclient variable enabling use tracking will contain the value �opt-out�

To change this behavior, you can use the configuration key sendHitWhenOptOut available since version 2.13.0 of the Tracker. By passing the value to false (true by default), you will prevent the hits from being sent when the user is in �opt-out� mode.

• Swift
• Objective-C

let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
tracker.setSendHitWhenOptOutEnabled(false, sync: true, completionHandler: nil)
// Tracker is now preventing hit from being sent when the user is in opt-out mode

Tracker* tracker = [ATInternet sharedInstance].defaultTracker;
[tracker.ecommerce setSendHitWhenOptOutEnabled:NO sync:YES completionHandler:nil];
// Tracker is now preventing hit from being sent when the user is in opt-out mode

Examples

1. Disabling user tracking

   • Swift
   • Objective-C

@IBAction func disableTracking(sender: UIButton) {
    // deprecated : Tracker.doNotTrack = true
    ATInternet.optOut = true
}

- (IBAction)disableTracking:(UIButton *)sender {
    // deprecated : Tracker.doNotTrack = YES;
    Tracker.optOut = YES;
}

2. Recovering user tracking status

   • Swift
   • Objective-C

override func viewDidLoad() {
    super.viewDidLoad()
    // deprecated : Tracker.doNotTrack
    let optOut = ATInternet.optOut
}

- (void)viewDidLoad {
    [super viewDidLoad];
    // deprecated : Tracker.doNotTrack
    BOOL optOut = ATInternet.optOut;
}

Hashing user ID

The SDK allows for the automatic addition of user ID in your hits (uuid, idfv, idfa). You may also add your own user ID via the tracker�s setParam method.

To ensure visitor anonymity, all while keeping their identification in your analyses, it is possible to hash the unique ID (SHA-256). To do this, use the tracker�s setHashUserIdEnabledmethod as follows:

• Swift
• Objective-C

import UIKit
import Tracker

class ViewController: UIViewController {
    let tracker: Tracker = ATInternet.sharedInstance.defaultTracker
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        tracker.setHashUserIdEnabled(true, completionHandler: { isSet in
            print("User ID will now be hashed")
        }
    }
}

#import "ViewController.h"
#import "SmartTracker/SmartTracker-Swift.h"

@interface ViewController ()
@property (nonatomic, strong) Tracker *tracker;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    [self.tracker setHashUserIdEnabled:YES completionHandler:^(BOOL isSet) {
        NSLog(@"hashing enabled")
    }];
}

@end

Offline hit customization

Offline hits are saved in the application documentDirectory directory. However Apple allows this directory to be synchronized with iCloud. To disable any backup, you can use the flag preventICloudSync of the ATInternet class.

You can also configure where the offline hit are saved with the static property databaseDirectory of the ATInternet class.

If the path is incorrect, the database won’t be initialized and the offline hits will be lost

1. Deactivation of the iCloud backup

   • Swift
   • Objective-C

    // Before any Tracker usage
    ATInternet.preventICloudSync = true

    // Before any Tracker usage
    ATInternet.preventICloudSync = YES;

2. Database path customization

   • Swift
   • Objective-C

    // Before any Tracker usage
    ATInternet.databaseDirectory = FileManager.default.urls(for: .cachesDirectory, in: .userDomainMask).last!

    // Before any Tracker usage
    ATInternet.databaseDirectory = ATInternet.databaseDirectory = [[NSURL alloc] initWithString:[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) objectAtIndex:0]];