Close Menu

carnival


Carnival is a powerful software development kit (SDK) that enables developers to effortlessly integrate features such as in-app messaging, push notifications, and rich user targeting into their iOS applications. With Carnival, you can significantly enhance user engagement and deliver personalized experiences to your app users.


Key Features

  • In-App Messaging: Reach out to your users directly within the app through interactive messages, prompts, and announcements.
  • Push Notifications: Send push notifications to users’ devices, even when the app is not actively in use, to grab their attention and increase app usage.
  • Smart Targeting: Segment your user base based on a wide range of criteria, such as demographics, behavior, in-app purchases, and more, to deliver customized experiences.
  • A/B Testing: Run A/B tests with different variations of your in-app messages and push notifications to determine the most effective content and strategies.
  • Analytics & Reporting: Gain valuable insights into user behavior, message performance, and engagement metrics through Carnival’s comprehensive analytics and reporting features.


Getting Started


Prerequisites

Before integrating Carnival into your iOS app, make sure you have the following:

  • Xcode installed on your development machine
  • Access to the App Store Connect for your application
  • Minimum deployment target of iOS 10 or later
  • An active Carnival account and API key


Installation

To start using Carnival in your iOS app, follow these steps:

  1. Open your Xcode project.
  2. Navigate to the project’s directory where the .xcodeproj file is located.
  3. Create a new group in the project file structure and name it “Carnival” (or any other desired name).
  4. Right-click on the newly created group and select “Add Files to [your project name]”.
  5. Navigate to the Carnival.framework file in your file system and select it.
  6. Make sure the “Copy items if needed” option is checked and click “Add”.
  7. In Xcode’s project navigator, select your project’s target.
  8. In the target’s settings, navigate to the “General” tab and scroll down to the “Frameworks, Libraries, and Embedded Content” section.
  9. Click the + button to add a new framework.
  10. Select the Carnival.framework file from the list and click “Add”.


Integration


Basic Integration

To start integrating Carnival into your app, follow these steps:

  1. Import the Carnival module in your Swift file:
    import Carnival
  2. Initialize Carnival using your API key:
    Carnival.startEngine(withAPIKey: "YOUR_API_KEY")
  3. Enable push notifications in your app delegate by adding the following code:
    Carnival.register(launchOptions: launchOptions)


Advanced Integration

For more advanced integration options and customization, refer to the official Carnival documentation.


API Reference

For a detailed overview of Carnival’s API, including methods, classes, and protocols, refer to the Carnival API Reference.


Support

If you encounter any issues or have any questions, feel free to reach out to Carnival’s support team at support@carnival.io.


With Carnival, you have the power to revolutionize your iOS app’s engagement and user experience. Take advantage of its comprehensive features, intuitive integration, and advanced targeting capabilities to foster meaningful connections with your users and drive app success.