Last modified November 29, 2018 by Shelly Wolfe

Add your app

Get started with Swrve by adding your app titles to your Swrve dashboard. Follow the steps outlined below to set up a new app or platform title.

There are four main steps to set up a new app or platform title in Swrve:

  1. Add a new app title or platform.
  2. Define the title properties.
  3. Define the in-app currency names.
  4. Specify the lead developer who is responsible for integrating Swrve for this particular platform title.

Adding a new app title

To add a new app title or platform, on the Apps Overview screen select one of the following options:

Add new app or platform

  • To add a platform title for an app that has not yet been set up in Swrve, select Create App.
  • To add a new platform title to an existing app, select Add platform below the app.

Defining title properties

After you create your app, use the options on the Add Platform Title screen to define the title properties:

Add Platform Title

Step 1: Select the Platform for your title. For a cross-platform integration (that is, one that combines your platforms into one Swrve dashboard), select Other.

Step 2: Below the Platform section, complete the following details for your app:

  • Title – enter the title of your app.
  • Type – select the platform type:
    • Sandbox – the platform title is the sandbox version. We recommend using a sandbox for initial testing of your Swrve app integration.
    • Production – the platform title is the production version.
  • Label – enter a label for your platform title. This helps to distinguish apps that share the same title.
  • Integration Type – select the type of integration to inform Swrve how the SDK was integrated. For cross-platform integrations, select Multiple.

Step 3: In the Icon section, upload or drag an icon image for your app.

Step 4: Optionally, in the App Store Links section, configure any app store links that you want to use to enable cross-promotional in-app messages. To add app store links for the relevant app platform(s):

  • Enter the URL for the app store.
  • Select Test to test the URL.

Step 5: In the Target Devices list, select the device(s) your app will support. The options are Smartphones, TabletsSmartphones & Tablets, Desktop, Televisions or All.

Step 6: In the Orientation list, select the type of device orientation your app will support. The options are LandscapePortrait or Landscape & Portrait.

Step 7: In the Launch Date box, enter the launch date of your app.

Step 8: In the Expected DAU list, select the estimated maximum amount of daily active users (DAU).

Step 9: In the Initial App Role list, select the user role you want to assign to all Company Admins for the app. If you only want the role to apply to yourself, clear the Apply to all Company Admins? check box.

Step 10: Select Create to save your settings and display the App Currencies and Lead Developer sections.

Defining app currencies

Define any in-app currencies that customers use to purchase virtual items in your app. To add an app currency:

Step 1: In the App Currencies section, select Add Currency.

Step 2: In the Name box, enter the exact name of the currency.

Step 3: In the Description box, enter a description of the currency.

Step 4: Select Add Currency to save your changes.

When setting up currencies in Swrve, it is important to enter the currency name EXACTLY as it is set up in your app, including capitalization. If the currency name doesn’t match exactly, for example, in Swrve the currency is entered as ‘money’ but in the app it is set up as ‘Money’, this can result in the event being rejected and the purchase not being included in report and dashboard analytics.

Specifying the lead developer

In the Lead Developer section, select the user that you want to specify as the lead developer and then select Assign. If the developer that you want to nominate is not already set up as a user in Swrve, perform the following actions:

Step 1: Select Create User.

Step 2: In the Name box, enter the developer’s name.

Step 3: In the Email box, enter the developer’s email address.

Step 5: Select Create User to save the developer’s details. You are redirected to the Roles Assignment screen.

Step 4: On the Assign Roles By User tab, select the role you want to assign to the user for this app and then select Save Roles. If needed, update the app role for any other users that need to access the app. For more information about assigning and managing user roles, see Managing Swrve user roles and permissions

Swrve sends an email to your nominated lead developer that provides them with the information they need to get started with your integration process. When they have completed the required integration, you’ll be ready to start using Swrve.

For information about editing existing platform titles, see How do I edit existing platform titles?

Next steps