Appearance
Frequently Asked Questions
General Questions
What is the minimum iOS version required?
The Upshot iOS SDK requires iOS 12.0 or later.
How do I get my app credentials?
App credentials can be obtained from the Upshot dashboard after registering your application.
Does the SDK support Swift and Objective-C?
Yes, the SDK fully supports both Swift and Objective-C.
Installation
Why am I getting CocoaPods dependency conflicts?
Make sure you're using the latest version of the SDK and check for any conflicting dependency versions in your Podfile.
Can I install the SDK manually?
Yes, you can manually install the SDK by downloading and adding the framework to your project.
How do I update the SDK?
For CocoaPods: Update your Podfile with the desired version and run pod update. For manual installation: Replace the framework with the new version.
Event Tracking
Are events cached offline?
Yes, events are cached offline and synced when connectivity is restored.
How many custom events can I track?
There is no hard limit on custom events, but we recommend focusing on meaningful events for better analytics.
How long are events stored offline?
Events are stored offline for up to 72 hours by default.
Push Notifications
Why aren't push notifications working in development?
Check that you:
- Have proper push certificates
- Requested notification permissions
- Properly handled device token registration
Can I customize notification sounds?
Yes, you can use custom sounds by adding sound files to your app bundle.
How do I handle deep links from notifications?
Implement the appropriate delegate methods to handle notification responses and deep links.
User Management
How do I identify users across devices?
Use a consistent user ID across devices when calling setUserId.
Can I merge anonymous and identified user data?
Yes, user data is automatically merged when an anonymous user is identified.
How do I clear user data?
Use the appropriate GDPR methods to handle user data deletion.
Activities
How many concurrent activities can be displayed?
Activities are queued and displayed according to your configuration settings.
Can I customize activity UI?
Yes, activities support custom styling and layouts.
How do I test activities?
Use the Upshot dashboard to create and test activities in development.
Rewards & Streaks
Do points expire?
Point expiration is configurable in the rewards system settings.
How are streaks maintained across time zones?
Streaks use the configured timezone settings for consistency.
Can users recover broken streaks?
Yes, with proper configuration of grace periods and streak freezes.
Performance
Does the SDK impact app performance?
The SDK is designed to have minimal impact on app performance.
How much data does the SDK use?
Data usage is optimized and configurable through batch settings.
Does the SDK run in the background?
Background operation is configurable and optimized for battery life.
Troubleshooting
How do I debug SDK issues?
Enable debug logging in the SDK configuration for detailed logs.
Where can I find SDK logs?
Logs are available in the console when debug mode is enabled.
How do I report SDK bugs?
Contact Upshot support with logs and reproduction steps.