Android SDK Q&A

Frequently Asked Questions

General 

• How do I enable my app to get Push Notifications?

• 1. To get Push Notifications, enable Google Cloud Messaging for Android (GCM), and then allow Appoxee to send notifications from your app. 
     For step-by-step instructions, see Android Application Setup.
  2. After allowing your app to send and receive Push Notifications, you need a server to handle these notifications.
     To enable the Appoxee sever to handle your notifications, add the Appoxee's code to your app code.
     For step-by-step instructions, see Appoxee Android SDK Integration.

• Are the analytics data refreshed at real-time?

  No: It takes several hours to analyze the data. To view the latest analytics data, you need to wait a few hours. 

• How can I change the Appoxee display?

  Appoxee's Pro account enables advanced features, including the customization of the Appoxee's look and feel.
  To upgrade to Appoxee Pro and customize your Appoxee display, please contact Appoxee Support (support@appoxee.com)

• Appoxee released a new SDK version. Do I need to update my Appoxee SDK integration?

  Yes: We recommend that you always update your app to use the latest Appoxee SDK version. 
  Note that the SDK version number has an "x.y.z" format (for example: "1.0.7"), indicating if the updates are major or minor:
  • For major versions, one of the first two version numbers ("x" or "y") are updated.
  • For minor versions, only the last number ("z") is updated.

Troubleshooting 

Push Notifications 

• When I use Appoxee to send a Rich Message or a Push Notification, the preview shows an iPhone device instead of an Android device.

  This is a known issue, which occurs only in the preview. It will be fixed in upcoming SDK versions.

• According to the message status, the message was sent to 0 users.

  This is a known issue. It will be fixed in upcoming SDK versions.

• I cannot receive Push Notifications.

  Please check the following settings:
  
  1. Go over the XML manifest file (AndroidManifest.xml), and verify that you changed all the required values, as explained in Integration: Adding Appoxee to your Android Application Code.

  2. Log into your Appoxee account, go your app's Application Information page and make sure you entered the correct Google project ID and Google API Key, as explained in Step B: Appoxee Setup of the Android Application Setup.

  3. On the same page, check the values of the app's SDK Key and Secret Key, and then make sure you set the same values in your code's "com.appoxee.Configuration" class (see Integration: Adding Appoxee to your Android Application Code).

  4. If you are using an emulator, please make sure to use a Google API target.

  
  

• How long does it take Appoxee to send the Push Notifications?

  Appoxee starts sending your Push Notifications instantly. 
  However, the Push process itself may take longer, depending on your app's Push Rate setting:
  The Push Rate feature defines the number of Push Notifications sent per-second (p/s). This feature is intended for apps that have a server side, and it is used to prevent overloading the server with too many concurrent app opens (triggered by the Push Notification).
  To set the Push Rate, log into your Appoxee account, go to the Apps tab, choose your app to display its Application Information page, and then select the desired Push Rate value from the list. 
  The default rate is Normal (100 p/s), but you can choose different rates for different purposes. For example: When debugging the app, use a low rate: Debug speed (10 p/s). However, when sending a "Breaking News" Push Notification, set the rate to Fast (250 p/s).
  To estimate how long it should take to send your Push Notification, divide the number of users who enabled Push Notifications by the app's current Push Rate.
  For example: If 1,000,000 users enabled Push Notifications, and your Push Rate is 100 p/s, then the Push process duration is calculated as follows: 1,000,000:100 = 10,000 seconds (close to 3 hours). 

General 

• My list has no registered devices.

  The Registered Devices list shows the number of devices that have the application installed with the Appoxee SDK
  It takes a few seconds for a device to register, and it takes about an hour to update the count of registered devices.
  Please wait an hour and then check the Registered Devices list again.

  If the user downloaded a version of the application that does not include Appoxee, the user's device will not be counted as a registered device.  

Still have questions?

• Please visit our Support site (https://appoxee.atlassian.net) or contact Appoxee Support (support@appoxee.com).