Overview
To QA test your integration, A/B tests, in-app messages and push notifications, you must first set up the QA devices you want to make available for testing. Swrve's QA Devices screen enables you to manage QA devices and access device events.
Setting up QA Devices
To set up a new QA device, do the following:
Step 1: Select Settings > QA Devices on the Swrve menu bar to display the QA Devices screen.
Step 2: Click the Add QA Device button to display the Add QA Device dialog box.
Step 3: Depending on number of the app's Daily Active Users (DAU), do the following:
-
If the app has low DAU (less than 700), open the app on your device and click the Yes, I have opened the app button.
-
If the app has greater than 700 DAU, the Add QA Device dialog prompts you to enter the device's IP address to filter devices relevant to your app. You can get the IP address by going to www.whatIsMyIPaddress.com in the device's web browser. Enter the device's IP address and then click the Yes, I have opened the app button.
A list of the devices most recently seen by Swrve is displayed. You can refresh this list by clicking the Refresh List button.
Step 4: If your QA device is displayed in the list of devices seen by Swrve, select the device by performing the actions below. Otherwise, proceed to Step 5 to add the device manually.
-
Click the Select button to the right of your QA device.
-
Enter the nickname that you want to assign to the QA device into the Nickname field.
-
Click the Add QA Device button to add the QA device to the list of devices on the QA Devices screen.
-
Proceed to Step 6.
Step 5: If your QA device is not displayed in the list of devices, add the device manually by performing the actions below:
-
Click the add your device manually link.
-
Enter the nickname that you want to assign to the QA device into the Device nickname field.
-
Enter the user identifier into the User id field. Consult your development team about the user ID to enter. The Finding the User ID section at the bottom of this article provides guidelines on how your development team can ascertain the user ID.
- Click the Add QA Device button to add the QA device to the list of devices on the QA Devices screen.
Step 6: Click the Edit link to the right of your new device and update the following controls as needed:
-
Logging enabled - select this check box if you want the Swrve service to display logging information for in-app messages.
-
Reset device state - select this check box if you want to bypass in-app message delivery limits.
Step 7: Click the Update button.
Additional (non-editable) controls are displayed to inform you whether or not push notification testing is enabled for the QA device in question:
-
If the Apple Push enabled control is displayed, push notification testing is enabled for the iOS device (a session has been started on the device and the device token has been saved in the database). The QA device is automatically available for iOS push notification testing on the Preview & Test screen of the push notification creation wizard.
-
If the Google Push enabled control is displayed, push notification testing is enabled for the Android device (a session has been started on the device and the Sender ID was configured for the device in the SDK). The QA device is automatically available for Android push notification testing on the Preview & Test screen of the push notification creation wizard.
-
If the Apple Push disabled control, Google Push disabled control, WNS Push disabled control or Web Push disabled control is displayed, the test device cannot currently be used to test push notifications.
For information about QA testing in-app messages and A/B tests, see the following articles on the documentation site:
Viewing QA Device Events
Once you have set up a QA device, you can access the QA Device Events screen. This screen enables you to view the following for debugging purposes:
-
All events (in real time) sent from the SDK to Swrve, including:
-
The event name.
-
The time of the event.
-
Raw JSON data for the event.
-
In-app messages triggered and any errors encountered.
-
In-app messages downloaded and any errors encountered.
To access the QA Device Events screen and view device events, click the Logging link to the right of the device for which you want to view events. The QA Device Events screen is displayed for that device.
Troubleshooting QA Devices
This section provides recommendations for troubleshooting issues related to setting up QA devices.
QA Devices Not Available for Push Notification Testing
If your development team has integrated push notifications for your app and you have set up QA devices for push notification testing, but your QA device is still not displayed on the Preview & Test screen of the push notification creation wizard, check the following:
-
Check that your development team are using the correct version of the SDK for push notifications. For iOS, the SDK must be version 2.7 or later. For Android and Unity, the SDK must be version 2.9 or later.
-
For iOS QA devices, check that the Apple Push enabled control is displayed for the device. For Android QA devices, check that the Google Push enabled control is displayed for the device. If either control is displayed as disabled, it is likely that the required configuration has not been performed by your development team.
Finding the User ID
To ascertain the user ID for a specific device, your development team can use the methods outlined below for iOS, Android or Unity, depending on the platform of your app. Alternatively, they can use Wireshark to find the user ID for any platform.
iOS
Step 1: Connect the iOS device to your machine.
Step 2: Open Xcode and navigate to Window > Organizer > Device > Console.
Step 3: Restart the app on your device. An entry is now available which contains information such as the user ID, game ID, API key and other SDK configuration information.
Android
By default, the user ID of your device is the Android ID. Access this ID by using an app from the Google Play store.
Unity
By default, the user ID is the SystemInfo.deviceUniqueIdentifier for your app.
Wireshark
You can use Wireshark to ascertain the user ID for any platform. The device must be on the same network as the device capturing the packets.
Step 1: Start Wireshark.
Step 2: Select Capture > Start.
Step 3: Restart the app on your device. A HTTP request to http://api.swrve.com is now displayed with the user ID.
Comments