MicroStrategy ONE

Enabling Push Notifications for Library Mobile for Android

A push notification is a message that pops up on a mobile device. App publishers can send them at any time; users don't have to be in the app or using their devices to receive them. The push notification server for MicroStrategy Library Mobile is the Intelligence Server.

In line with Firebase's decision to deprecate the use of legacy FCM XMPP and HTTP APIs, MicroStrategy supports the new HTTP V1 APIs with the release of MicroStrategy ONE Update 12. These updates ensure that you can seamlessly stay connected and leverage Firebase Cloud Messaging for all your push notification requirements. If you have been using the legacy send APIs for your custom MicroStrategy Android apps, we strongly recommend transitioning to the HTTP v1 API and following the setup guide below.

  • Workstation
  • Developer

To enable push notifications for MicroStrategy Library Mobile for Android, you must:

Configure Intelligence Server Settings

  1. Open MicroStrategy Workstation.

  2. On the main Workstation window, click Environments in the Navigation pane.

  3. Right-click the environment and choose Properties.

    Choose Get Info if you are using a Mac.

  4. Start by creating a new delivery device for the Mobile Client Android. If the left pane, click Subscription Delivery.

  5. Click Delivery Device.

  6. Select Firebase Cloud Messaging Connect as the Delivery Type.

  7. In the Device Editor, give your device a unique custom Name and optionally, a Description.

  8. Under Mobile Application, set the Package Name to a value similar to "com.microstrategy.android.sample". This is the identity name of your app, and you can choose any value you prefer.

  9. Under Firebase Cloud Messaging Service, set the Server URL to a value similar to the one shown below. The path in the URL contains your app's project ID, which can be found in the General project settings tab of the Firebase console.

    Copy 
    https://fcm.googleapis.com/v1/projects/ myproject-b5ae1/messages:send. 

  10. In Authorization Key (Manifest File), upload your manifest file to provide the authorization key for your custom application. This manifest file is a service account JSON file downloaded from your Firebase project. See Migrate from legacy FCM APIs to HTTP v1 on the Google Firebase site for detailed instructions on obtaining the manifest file. Make sure that you grant the service account the Firebase Cloud Messaging API Admin role.

  11. If the Intelligence server cannot communicate directly with Google FCM (Firebase Cloud Messaging), then under Firebase Cloud Messaging Proxy, enable the Use Proxy switch and enter the Server URL for the proxy.

  12. Click OK.

Configure App Settings in MicroStrategy Library Mobile SDK for Android

  1. You need to update google-services.json. Download it from the Firebase console.

  2. Open the file in a text editor.

  3. Under client > client_info, add a new client_id attribute and set its value to be the value of the Application ID.

    Copy 
    "client_id":"android.com.microstrategy.android.samples.app"

  4.  If you want to update google-services.json in the MicroStrategy Library Mobile for Android SDK sample project, add the following line of code to \MicroStrategyMobile\app\build.gradle.

    Copy 
    apply plugin: 'com.google.gms.google-services'

  5. Save your changes.

To enable push notifications for MicroStrategy Library Mobile for Android, you must

Configure Intellgence Server Settings

  1. Open MicroStrategy Developer.
  2. Start by creating a new device for the Mobile Client Android device type.
  3. Expand the MicroStrategy analytics modules and navigate to Administration > Delivery Managers.
  4. Right-click Devices and choose New > Device.
  5. On the Select Device Type dialog, choose Mobile Client Android and click OK.
  6. In the Device Editor, give the device a custom Name and an optional Description.

  7. Under Mobile Application, set the Package Name to a value similar the one shown below. This is the identity name of your app and you can choose any value you prefer.

    Copy 
    com.microstrategy.android.sample

  8. Under Firebase Cloud Messaging Service, set the Server URL to a value similar to the one shown below. The path in the URL contains your app's project ID, which can be found in the General project settings tab of the Firebase console.

    Copy 
    https://fcm.googleapis.com/v1/projects/ myproject-b5ae1/messages:send. 

  9. Download the JSON file of Authentication Key, following the steps in follow the step from Migrate from legacy FCM APIs to HTTP v1 on the Google Firebase site. Copy and paste the content of the JSON file into Authentication Key.

  10. If the Intelligence server cannot communicate directly with Google FCM (Firebase Cloud Messaging), then under Firebase Cloud Messaging Proxy, select Use Proxy and enter the IP Address/Server Name for the proxy.


  11. Click OK.

Configure App Settings in MicroStrategy Library Mobile SDK for Android

  1. You need to update google-services.json. Download it from the Firebase console.

  2. Open the file in a text editor.

  3. Under client > client_info, add a new client_id attribute and set its value to be the value of the Application ID.

    Copy 
    "client_id":"android.com.microstrategy.android.samples.app"

  4. If you want to update google-services.json in the MicroStrategy Library Mobile for Android SDK sample project, add the following line of code to \MicroStrategyMobile\app\build.gradle.

    Copy 
    apply plugin: 'com.google.gms.google-services'

  5. Save your changes.

Get the FCM (Firebase Cloud Messaging) Authentication Key (Optional)

  1. Open the following location and log in with your Google account.

    Copy 
    https://firebase.google.com/docs/cloud-messaging/auth-server

  2. Go to your personal console.

  3. Create a project.
  4. Add a new app and configure it with corresponding package name.
  5. Go to app settings and click the Cloud Messaging tab.
  6. Click Server Key to see the FCM authentication key.