README.md

Appy iOS SDK

SDK for integrating Appy into iOS applications.

Overview

• Track standardized and custom events
• Track revenue events with currency (for ROAS / optimization)
• Retrieve installation ID and attribution parameters

Pure Swift, no third-party dependencies. iOS-only.

Install

Swift Package Manager. In Xcode: File → Add Package Dependencies… and point to this repo, or add it to your Package.swift:

dependencies: [
    .package(url: "https://github.com/Apparence-io/Appy-ios-plugin.git", branch: "main"),
],
targets: [
    .target(name: "MyApp", dependencies: [
        .product(name: "AppBoard", package: "Appy-ios-plugin"),
    ]),
]

Deployment target: iOS 13.0+.

Use

You need your app's credentials from the appy dashboard

Configure once at launch with the credentials, then track once you have a stable user id (e.g. your RevenueCat appUserId):

import AppBoard

// 1. At launch — App init / didFinishLaunchingWithOptions:
Appy(
    appId: "b7f2c1d0-…",                 // appy app id (UUID)
    ingestSecret: MyAppSecrets.ingestSecret
)

// 2. Once the user is known:
Appy.setEmail(user.email)            // optional — before track
Appy.track(appUserId: user.id)