Skip to main content
After installing and initializing the SDK, verify that events are being sent correctly before releasing to production.

​
Enable Debug Logging

Enable debug logging to see SDK activity in the Xcode console: 
guard let options = Options(
    apiKey: "<your-api-key>",
    organisationId: "<your-organisation-id>",
    workspaceId: "<your-workspace-id>"
) else { return }

// Enable all log messages
options.logModes = LogMode.all

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

​
What to Look For

​
Successful Initialization

When the SDK initializes successfully, you’ll see: 
Permutive: [info] SDK ready

​
Successful Event Tracking

When events are accepted by Permutive servers: 
Permutive: [info] Accepted: 1 / 1
The format is Accepted: X / Y where X is the number of events accepted and Y is the total sent.

​
Schema Validation Errors

If event properties don’t match your schema: 
Permutive: [error] Encountered 1 event rejection!
Permutive: [error] Error 1: A validation check carried out by the server did not succeed.(1007)
Permutive: [error] Error 1: Schema validation failed with reason(s): [#: 1 schema violations found;#: extraneous key [invalid_key] is not permitted]
Schema validation errors mean events are being rejected. Fix the property names or types to match your event schema in the Permutive dashboard.

​
Verification Checklist

1

SDK Initializes

Look for SDK ready in the console after app launch.
2

Events Are Sent

Navigate through your app and look for Accepted: X / X messages.
3

No Rejections

Ensure there are no event rejection error messages.
4

Check Dashboard

Log into your Permutive dashboard and verify events appear (may take up to 5 minutes).

​
Verification Code Example

Add this verification helper during development: 
import Permutive_iOS

class PermutiveVerification {

    static func verify() {
        // Check user ID
        let userId = Permutive.shared.currentUserId
        print("✅ Permutive User ID: \(userId)")

        // Check cohorts
        let cohorts = Permutive.shared.cohorts
        print("✅ Current cohorts: \(cohorts)")

        // Check activations
        let activations = Permutive.shared.activations
        print("✅ Activations: \(activations)")

        // Track a test event
        do {
            let properties = try EventProperties([
                "verification_test": true,
                "timestamp": Date().timeIntervalSince1970
            ])
            try Permutive.shared.track(event: "VerificationTest", properties: properties)
            print("✅ Test event sent")
        } catch {
            print("❌ Failed to send test event: \(error)")
        }
    }
}

// Call after initialization completes
Permutive.shared.start(with: options) { error in
    guard error == nil else { return }
    PermutiveVerification.verify()
}

​
PageTracker Verification

Verify PageTracker is working correctly: 
class TestViewController: UIViewController {
    private var pageTracker: PageTrackerProtocol?

    override func viewDidLoad() {
        super.viewDidLoad()

        let properties = try? EventProperties(["test_page": true])
        let context = Context(
            title: "Verification Test Page",
            url: URL(string: "https://example.com/test"),
            referrer: nil
        )

        pageTracker = try? Permutive.shared.createPageTracker(
            properties: properties,
            context: context
        )
        print("✅ PageTracker created")
    }

    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        do {
            try pageTracker?.resume()
            print("✅ PageTracker resumed - Pageview event should be sent")
        } catch {
            print("❌ PageTracker resume failed: \(error)")
        }
    }

    override func viewDidDisappear(_ animated: Bool) {
        super.viewDidDisappear(animated)
        pageTracker?.pause()
        print("✅ PageTracker paused")
    }

    deinit {
        pageTracker?.stop()
        print("✅ PageTracker stopped - PageViewComplete event should be sent")
    }
}

​
Common Verification Issues

Problem: Console is silent, no Permutive logs appear.Solutions:
  • Confirm logModes = LogMode.all is set before calling start()
  • Check Xcode console filter isn’t hiding messages
  • Verify SDK is actually being initialized (add a breakpoint)
Problem: Events sent but rejected by server.Solutions:
  • Check event name matches schema (alphanumeric and underscores only)
  • Verify property names and types match your Permutive dashboard schema
  • Remove any extra properties not in the schema
Problem: Console shows Accepted but events not in dashboard.Solutions:
  • Wait up to 5 minutes for events to process
  • Verify you’re looking at the correct workspace
  • Check the date range filter in the dashboard
  • Confirm credentials match the dashboard environment
Problem: cohorts returns an empty set.Solutions:
  • Cohorts are evaluated server-side and may take time to populate
  • Ensure you’ve tracked sufficient events to qualify for cohorts
  • Check with your Customer Success Manager that cohorts are configured

​
Disable Logging for Production

Always disable debug logging before releasing to production to avoid performance overhead and prevent sensitive data from appearing in device logs.
#if DEBUG
options.logModes = LogMode.all
#else
options.logModes = LogMode.none
#endif

​
Next Steps

Once verification passes:

Page Tracking

Implement page tracking throughout your app

Identity Management

Set up user identity tracking

Google Ad Manager

Integrate with GAM for ad targeting

Issues

Troubleshoot common problems