Last modified November 22, 2014 by Gordon Glauser

Integrate Your App

Integrate Swrve into your app, beginning with basic integration and progressing to advanced integration that gives you access to everything Swrve has to offer.
This article is aimed at the lead developer who is responsible for integrating Swrve. You should have received an email from Swrve to prepare you to start the integration process. If this is not the case, or if you have questions before you start, contact Swrve Technical Support at support@swrve.com.

Core Integration

Swrve provides the Integration Settings screen to make it easy to integrate the core functionality of Swrve for each of your app’s platform titles. If the app platform is Apple, Google, Windows or Amazon, follow the instructions below to configure this screen. If the platform of your app is Other, you’re integrating with a platform that is not supported by an SDK and you may need to call Swrve’s REST API directly. In this instance, contact your Customer Success Manager at support@swrve.com for advice on how best to perform your core integration.

Integration Settings

To integrate the core functionality of Swrve into your app, complete the following for each of your platform titles:

Step 1: On the Setup menu, click Integration Settings. The options that are displayed on the Integration Settings screen depend on the app platform.

Step 2: Download the appropriate SDK and follow the basic integration instructions for your platform. For detailed instructions, see the platform-specific Integration Guide.

Step 3: Perform the following actions:

  • Check your integration so far by starting your app and confirming that Swrve is sending events in the Events Logged section. Certain events, such as session start and session end events, are sent automatically and require no additional configuration on your side.
  • Set up a QA device for integration testing. For more information, see How Do I Set up QA Devices? The QA Devices Registered section provides information about the number of QA devices you have set up for your app.

Step 4: Depending on the platform of your app, complete one of the sections below:

Apple

  • In the Push Notifications section, upload and test your Apple APNS (push) Certificate. This is required to enable Swrve’s push notification functionality for iOS. For detailed information about managing and uploading push certificates, see How Do I Manage iOS Push Certificates?
  • In the IAP Validation section, enter your iTunes App Bundle Identifier. This enables validation of IAP receipts against your app; Swrve checks that the bundle ID included in an in-app purchase receipt corresponds to your bundle ID before calculating your revenue KPIs. For information about accessing your bundle ID and enabling receipt validation for Apple, see the iOS Integration Guide.

Google

  • In the Push Notifications section, enter and test your Google Cloud Messaging Server Key (also known as the Android server key). This is required to enable Swrve’s push notification functionality for Google Play. For detailed information about managing and inputting the Android server key, see How Do I Manage the Android Server Key?
  • In the IAP Validation section, enter your Google Play Licensing Public Key for licensing and in-app billing. Swrve uses this public key to verify every purchase before calculating your revenue KPIs. For information about accessing your public key and enabling receipt validation for Google Play, see the Android Integration Guide.

Windows

  • In the Push Notifications section, enter and test your Windows Push Notification Service SID and Client secret key. This is required to enable Swrve’s push notification functionality for Windows devices. For information about accessing your SID and Client secret key, see the Windows Integration Guide.
  • In the IAP Validation section, enter your Windows Store Package Family Name for the app. Swrve uses the Package Family Name to verify every purchase before calculating your revenue KPIs. For more information about accessing your Package Family Name and enabling receipt validation for Windows, see the Windows Integration Guide.

Amazon

  • In the Push Notifications section, enter and test your Amazon Device Messaging Service Client id and Client secret key. This is required to enable Swrve’s push notification functionality for Amazon Fire devices. For information about accessing your Client id and Client secret key, see the Android or Unity Integration Guide.
  • For Amazon SDK integrations, any services directly related to Google Play services, such as in-app purchase validation, are not currently supported.
For information about editing existing integration settings, see How Do I Edit Existing Integration Settings?

Advanced Integration

Once you’re done with the core Swrve integration, start building on the basics to send custom events, access Swrve’s push notification and A/B testing functionality and to perform advanced in-app messaging configuration. It’s up to you just how sophisticated you get—our team will make sure integration for advanced A/B testing, push notifications and segmentation is as simple as possible.

For detailed information about performing advanced integration, see the platform-specific Integration Guide.


Next Step

  • Start using Swrve to build customized relationships with your app users. For more information, see Engage Your Users.