Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 70 Next »

Last Updated: Thursday, April 30, 2020

You can integrate your iOS or Android app with the Vibes Mobile Engagement Platform to send push messages to the Vibes SDK.

Key Integration Steps

  • Implement basic device and push registration to simple push notifications using the Vibes SDK
  • Enable association of push to device API or SDK call.  This will make a user "known" and allow for platform targeting and segmentation. 
  • Add advanced push options:  rich push, notification sounds, deep linking, etc (Optional)
  • Add app inbox support (Optional)

Note:  Platform accounts are available via the platform for development and UAT testing. 

Topics in this Section

The root page @parent could not be found in space Platform Developer Documentation.

Technical Integration Overview

  1. Request an app_id from Vibes. The app_id uniquely identifies the application and will be needed to configure the SDK. The app_id will be the same for the Android and iOS apps.
    • Developers will need a test app_id for development release, and a production app_id for the production release. Vibes uses production to test the integration to insure no environmental difference. Different IDs will allow the apps and their data to be used and tracked separately.  
  2. Retrieve the SDK from the Android and iOS repositories. 
  3. Add the SDK to your apps. Examples of how to add the SDK to your app can be referenced in our Android and iOS example apps in the Github repository

  4. To enable push notifications in the background for your iOS application, do the following:

    1. Click your project, for example, the ios-sdk-example-app.

    2. Click the Capabilities tab.

    3. Turn Background Modes On, then click the Remote notifications check box.

  5. Set up push notification keys for your app on Apple and Google developer portals so that the app will be able to receive push notifications. 
    • Apple will provide an APNS certificate and private key, typically in the form of a .p12 file.
    • Google will provide a server key.
  6. Transfer those Apple and Google push notification keys and bundle IDs to Vibes. Those keys will allow the Vibes Platform to send messages to the app.
  7. Configure a server-to-server call to Associate Person to Device. For security reasons, Vibes does not allow the app to directly associate with a user account from within the app, so a server-to-server call is required to pair apps with accounts.

    Note: For apps using the Vibes Push Notifications SDK, communication between the app and the Vibes Platform is secured using an app-specific API key combined with Transport Layer Security (TLS). However, these measures can be circumvented on a device within one's control. In server-to-server communication, keys can be protected from unauthorized access, and intercepting payloads in transit is difficult.
  8. Complete SDK testing using the test app.
  9. Perform a smoke test to send notifications from the Vibes Platform to the production app.
  10. Release the apps from the Google Play and App Store.
  • No labels