Skip to main content
This guide takes you from an empty project to a working SDK integration.

Prerequisites

  • Access to the PNLight dashboard.
  • Your app bundle ID.
  • Your App Store ID.
  • An app build that can install a native iOS dependency.
1

Create a project

In the dashboard, create a project for your app. Enter the app name, App Store ID, and bundle ID. Choose the attribution source PNLight should prefer first.
2

Complete the dashboard checklist

Use the Getting started checklist in the dashboard sidebar to open the next setup pages. Complete App Store notifications, SDK installation, an in-app event, and at least one product. Remote UI placements and ad networks are optional.
3

Copy the SDK token

Open Integration and copy the project SDK token. The SDK token connects app events to this project.
4

Install the SDK

Add the SDK for your app stack: Swift, React Native, or Flutter.
5

Initialize PNLight

Call the SDK initialization method during app startup before you send attribution or request Remote UI.
6

Send attribution when available

If you use AppsFlyer or another attribution provider, send attribution data through the SDK after the provider returns conversion data.
7

Request Remote UI

On the first app launch, wait 4-5 seconds after AppsFlyer initialization when attribution is required, then request Remote UI with RemoteUiView or getUIConfig. The SDK also waits for attribution internally when attributionRequired is true.
8

Check dashboard data

Open Integration, Analytics, and Remote UI to confirm installs, attribution, app events, and UI requests are arriving.
Use one PNLight project per app and environment that needs separate reporting. Do not reuse a production SDK token in development builds unless you want test events in production analytics.

Minimal SDK initialization

Next steps