iOS product analytics installation

Install via CocoaPods

Required

Add PostHog to your Podfile:

Podfile
pod "PostHog", "~> 3.0"

Or install via Swift Package Manager:

Package.swift
dependencies: [
  .package(url: "https://github.com/PostHog/posthog-ios.git", from: "3.0.0")
]

Configure PostHog

Required

Initialize PostHog in your AppDelegate:

AppDelegate.swift
import Foundation
import PostHog
import UIKit

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_: UIApplication, didFinishLaunchingWithOptions _: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
        let POSTHOG_API_KEY = "<ph_project_api_key>"
        let POSTHOG_HOST = "https://us.i.posthog.com"

        let config = PostHogConfig(apiKey: POSTHOG_API_KEY, host: POSTHOG_HOST)
        PostHogSDK.shared.setup(config)

        return true
    }
}

Send events

Optional

Once installed, PostHog will automatically start capturing events. You can also manually send events to test your integration:

Swift
PostHogSDK.shared.capture("button_clicked", properties: ["button_name": "signup"])

By default, for backwards compatibility reasons, events are sent with person profile processing enabled. This means a person profile will be created for each user who triggers an event.

If you want to disable person profile processing for certain events, send the event with the following property:

Swift
"$process_person_profile": false

Next steps

Recommended

Resource	Description
Capturing events	Learn how to capture custom events beyond autocapture
Identifying users	Associate events with specific users
Creating insights	Build trends, funnels, and retention charts
Group analytics	Track events at the company or account level