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.
  • 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, bundle ID and App Store ID.
2

Copy the SDK token

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

Install the SDK

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

Initialize PNLight

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

Send attribution when available

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

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.
7

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

import PNLightSDK

await PNLightSDK.shared.initialize(apiKey: "pnlight_sdk_token")

import { initialize } from "@pnlight/sdk-react-native";

await initialize("pnlight_sdk_token");

import 'package:pnlight_sdk/pnlight_sdk.dart';

await PNLightSDK.initialize('pnlight_sdk_token');

​
Next steps