> ## Documentation Index
> Fetch the complete documentation index at: https://docs.permutive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Verification

> Verify your Permutive iOS SDK integration is working correctly

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:

<CodeGroup>
  ```swift Swift theme={"dark"}
  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
      // ...
  }
  ```

  ```objectivec Objective-C theme={"dark"}
  PermutiveOptions *options = [[PermutiveOptions alloc]
      initWithApiKey:@"<your-api-key>"
      organisationId:@"<your-organisation-id>"
      workspaceId:@"<your-workspace-id>"];

  // Enable all log messages
  options.logModes = PermutiveLogModeAll;

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

## 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]
```

<Warning>
  Schema validation errors mean events are being rejected. Fix the property names or types to match your event schema in the Permutive dashboard.
</Warning>

## Verification Checklist

<Steps>
  <Step title="SDK Initializes">
    Look for `SDK ready` in the console after app launch.
  </Step>

  <Step title="Events Are Sent">
    Navigate through your app and look for `Accepted: X / X` messages.
  </Step>

  <Step title="No Rejections">
    Ensure there are no `event rejection` error messages.
  </Step>

  <Step title="Check Dashboard">
    Log into your Permutive dashboard and verify events appear (may take up to 5 minutes).
  </Step>
</Steps>

## Verification Code Example

Add this verification helper during development:

<CodeGroup>
  ```swift Swift theme={"dark"}
  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()
  }
  ```

  ```objectivec Objective-C theme={"dark"}
  @import Permutive_iOS;

  @interface PermutiveVerification : NSObject
  + (void)verify;
  @end

  @implementation PermutiveVerification

  + (void)verify {
      // Check user ID
      NSString *userId = [[Permutive shared] currentUserId];
      NSLog(@"✅ Permutive User ID: %@", userId);

      // Check cohorts
      NSSet *cohorts = [[Permutive shared] cohorts];
      NSLog(@"✅ Current cohorts: %@", cohorts);

      // Check activations
      NSDictionary *activations = [[Permutive shared] activations];
      NSLog(@"✅ Activations: %@", activations);

      // Track a test event
      NSError *error = nil;
      PermutiveEventProperties *properties = [[PermutiveEventProperties alloc]
          init:@{@"verification_test": @YES}
          error:&error];

      [[Permutive shared] trackWithEvent:@"VerificationTest"
                              properties:properties
                                   error:&error];

      if (error == nil) {
          NSLog(@"✅ Test event sent");
      } else {
          NSLog(@"❌ Failed to send test event: %@", error);
      }
  }

  @end
  ```
</CodeGroup>

## PageTracker Verification

Verify PageTracker is working correctly:

<CodeGroup>
  ```swift Swift theme={"dark"}
  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")
      }
  }
  ```

  ```objectivec Objective-C theme={"dark"}
  @interface TestViewController ()
  @property (nonatomic, strong) NSObject<PermutivePageTrackerProtocol> *pageTracker;
  @end

  @implementation TestViewController

  - (void)viewDidLoad {
      [super viewDidLoad];

      NSError *error = nil;
      PermutiveEventProperties *properties = [[PermutiveEventProperties alloc]
          init:@{@"test_page": @YES}
          error:&error];

      PermutiveContext *context = [[PermutiveContext alloc]
          initWithTitle:@"Verification Test Page"
          url:[NSURL URLWithString:@"https://example.com/test"]
          referrer:nil];

      self.pageTracker = [[Permutive shared]
          createPageTrackerWithProperties:properties
          context:context
          error:&error];

      NSLog(@"✅ PageTracker created");
  }

  - (void)viewDidAppear:(BOOL)animated {
      [super viewDidAppear:animated];
      NSError *error = nil;
      [self.pageTracker resumeAndReturnError:&error];

      if (error == nil) {
          NSLog(@"✅ PageTracker resumed");
      } else {
          NSLog(@"❌ PageTracker resume failed: %@", error);
      }
  }

  - (void)viewDidDisappear:(BOOL)animated {
      [super viewDidDisappear:animated];
      [self.pageTracker pause];
      NSLog(@"✅ PageTracker paused");
  }

  - (void)dealloc {
      [self.pageTracker stop];
      NSLog(@"✅ PageTracker stopped");
  }

  @end
  ```
</CodeGroup>

## Common Verification Issues

<AccordionGroup>
  <Accordion title="No log output">
    **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)
  </Accordion>

  <Accordion title="Events rejected with schema error">
    **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
  </Accordion>

  <Accordion title="Events not appearing in dashboard">
    **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
  </Accordion>

  <Accordion title="Empty cohorts">
    **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
  </Accordion>
</AccordionGroup>

## Disable Logging for Production

<Warning>
  Always disable debug logging before releasing to production to avoid performance overhead and prevent sensitive data from appearing in device logs.
</Warning>

<CodeGroup>
  ```swift Swift theme={"dark"}
  #if DEBUG
  options.logModes = LogMode.all
  #else
  options.logModes = LogMode.none
  #endif
  ```

  ```objectivec Objective-C theme={"dark"}
  #ifdef DEBUG
  options.logModes = PermutiveLogModeAll;
  #else
  options.logModes = PermutiveLogModeNone;
  #endif
  ```
</CodeGroup>

## Next Steps

Once verification passes:

<CardGroup cols={2}>
  <Card title="Page Tracking" icon="file" href="/sdks/mobile/ios/features/page-tracking">
    Implement page tracking throughout your app
  </Card>

  <Card title="Identity Management" icon="user" href="/sdks/mobile/ios/core-concepts/identity-management">
    Set up user identity tracking
  </Card>

  <Card title="Google Ad Manager" icon="google" href="/sdks/mobile/ios/integrations/google-ad-manager">
    Integrate with GAM for ad targeting
  </Card>

  <Card title="Issues" icon="triangle-exclamation" href="/sdks/mobile/ios/troubleshooting/common-errors">
    Troubleshoot common problems
  </Card>
</CardGroup>