Quick Start

import UIKit
import Permutive_iOS

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        initializePermutive()
        return true
    }

    private func initializePermutive() {
        guard let options = Options(
            apiKey: "<your-api-key>",
            organisationId: "<your-organisation-id>",
            workspaceId: "<your-workspace-id>"
        ) else {
            print("Failed to create Permutive options")
            return
        }

        Permutive.shared.start(with: options) { error in
            if let error = error {
                print("Permutive initialization failed: \(error.localizedDescription)")
                return
            }
            print("Permutive SDK ready")
        }
    }
}

#import "AppDelegate.h"
@import Permutive_iOS;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [self initializePermutive];
    return YES;
}

- (void)initializePermutive {
    PermutiveOptions *options = [[PermutiveOptions alloc]
        initWithApiKey:@"<your-api-key>"
        organisationId:@"<your-organisation-id>"
        workspaceId:@"<your-workspace-id>"];

    if (options == nil) {
        NSLog(@"Failed to create Permutive options");
        return;
    }

    [[Permutive shared] startWith:options
                          context:nil
                       completion:^(NSError *error) {
        if (error != nil) {
            NSLog(@"Permutive initialization failed: %@", error.localizedDescription);
            return;
        }
        NSLog(@"Permutive SDK ready");
    }];
}

@end

import UIKit
import Permutive_iOS

class ArticleViewController: UIViewController {
    private var pageTracker: PageTrackerProtocol?

    override func viewDidLoad() {
        super.viewDidLoad()

        // Create event properties
        let properties = try? EventProperties([
            "category": "news",
            "author": "Jane Smith"
        ])

        // Create page context
        let context = Context(
            title: "Breaking News: Tech Advances",
            url: URL(string: "https://example.com/articles/tech-advances"),
            referrer: nil
        )

        // Create the page tracker
        pageTracker = try? Permutive.shared.createPageTracker(
            properties: properties,
            context: context
        )
    }

    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        try? pageTracker?.resume()  // Starts tracking, fires Pageview event
    }

    override func viewDidDisappear(_ animated: Bool) {
        super.viewDidDisappear(animated)
        pageTracker?.pause()  // Pauses engagement timer
    }

    deinit {
        pageTracker?.stop()  // Stops tracking, fires PageViewComplete event
    }
}

#import "ArticleViewController.h"
@import Permutive_iOS;

@interface ArticleViewController ()
@property (nonatomic, strong) NSObject<PermutivePageTrackerProtocol> *pageTracker;
@end

@implementation ArticleViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    // Create event properties
    NSError *error = nil;
    PermutiveEventProperties *properties = [[PermutiveEventProperties alloc]
        init:@{@"category": @"news", @"author": @"Jane Smith"}
        error:&error];

    // Create page context
    PermutiveContext *context = [[PermutiveContext alloc]
        initWithTitle:@"Breaking News: Tech Advances"
        url:[NSURL URLWithString:@"https://example.com/articles/tech-advances"]
        referrer:nil];

    // Create the page tracker
    self.pageTracker = [[Permutive shared]
        createPageTrackerWithProperties:properties
        context:context
        error:&error];
}

- (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    [self.pageTracker resumeAndReturnError:nil];  // Starts tracking
}

- (void)viewDidDisappear:(BOOL)animated {
    [super viewDidDisappear:animated];
    [self.pageTracker pause];  // Pauses engagement timer
}

- (void)dealloc {
    [self.pageTracker stop];  // Stops tracking
}

@end

guard let options = Options(
    apiKey: "<your-api-key>",
    organisationId: "<your-organisation-id>",
    workspaceId: "<your-workspace-id>"
) else { return }

// Enable all logging
options.logModes = LogMode.all

Permutive.shared.start(with: options) { error in
    // ...
}

PermutiveOptions *options = [[PermutiveOptions alloc]
    initWithApiKey:@"<your-api-key>"
    organisationId:@"<your-organisation-id>"
    workspaceId:@"<your-workspace-id>"];

options.logModes = PermutiveLogModeAll;

[[Permutive shared] startWith:options context:nil completion:^(NSError *error) {
    // ...
}];