Skip to main content
Используйте SDK для Swift, чтобы добавить PNLight в нативное приложение iOS.

Требования

  • iOS 13.0+
  • Swift 5.7+
  • Swift Package Manager

Установка через Swift Package Manager

Репозиторий пакета: pnlight-dev/sdk-swift. Версия SDK для Swift Добавьте пакет в Xcode:
1

Откройте настройки пакетов

В Xcode нажмите File, затем Add Packages….
2

Введите URL репозитория

Введите https://github.com/pnlight-dev/sdk-swift.git.
3

Добавьте пакет

Добавьте пакет в таргет приложения.

Инициализация SDK

Инициализируйте SDK при запуске приложения.
Если вы используете Remote Config, задайте локальные значения по умолчанию при инициализации:

Основные вызовы

logEvent отправляет необязательные события приложения в PNLight. Их можно просматривать в разделе Аналитика → События приложения, на странице События и в хронологии клиентов.

Remote Config

После инициализации получите Remote Config. Читайте значения через типизированные геттеры с резервными значениями, заданными в приложении.
По умолчанию fetchAndActivate кратко ожидает атрибуцию AppsFlyer и использует минимальный интервал запроса 15 минут. Результаты запроса, локальные значения по умолчанию и все поддерживаемые типы значений описаны в разделе Remote Config.

IDFA после ATT

Если PNLight инициализируется до завершения запроса App Tracking Transparency, после получения разрешения вызовите updateIdfa(), чтобы PNLight получил разрешённый IDFA.

Remote UI

Используйте RemoteUiView в SwiftUI, когда хотите, чтобы PNLight отобразил настроенный плейсмент.
Если нужно самостоятельно получить конфигурацию плейсмента, используйте getUIConfig. При первом запуске приложения подождите 4–5 секунд после инициализации AppsFlyer, если требуется атрибуция. SDK также ожидает атрибуцию внутри, если attributionRequired равно true.
Используйте getUIConfigResult, когда приложению нужно отличить отсутствие UI для плейсмента от ошибки загрузки.
Используйте onPurchased, когда документ Remote UI schema v3 или v4 запускает покупку через pnlight.purchase, а приложению нужно обновить права доступа после проверки StoreKit. Рекомендации по плейсментам и действиям приведены в разделе Remote UI.