Mobile App Testing in Development Mode

Introduction

This document guides developers and testers on how to test the mobile app in development mode before it is live on the App Store or Google Play Store. It covers key functionalities such as universal links, device tracking, and redirection behavior.

Key Features & Testing Steps

1. Optional App Store Links During Campaign Setup

   • Users can skip providing App Store / Google Play Store links during campaign setup if the app is not yet live

   • These links can be added later once the app is published

   Testing Steps:

   1. Create a campaign without entering store links.

   2. Verify the campaign is saved successfully.

   3. Later, update the campaign with valid store links and confirm they are stored correctly.

2. Enabling App Download Tracking (Required for Universal Link)

   • Before using the universal link, the Track iPhone & Android App Downloads toggle must be enabled in the settings

   • Once enabled, the universal link becomes active and starts capturing device data

   Testing Steps:

   1. Go to campaign settings and enable the toggle for Track iPhone & Android App Downloads

   2. Verify that the universal link is now functional

   
3. Universal Link Testing & Device Data Capture

   • Clicking the universal link from any device will log:

     • IP Address

     • Device Type (iPhone, Android, etc)

     • Screen Size

     • OS Type & Version

   • This data is stored in the database and visible in the web dashboard

   Testing Steps:

   1. Click the universal link from a test device (mobile/tablet)

   2. Verify that the device details are recorded in the database

   3. Check the web dashboard to confirm the captured data is displayed correctly

4. Automatic Redirection to Local APK/SDK App

   • If the app is already installed, the link will redirect directly to it

   • If not installed, after manual installation (via APK/SDK), the app will:

     • Match the stored device details

     • Register the user based on provided details (name, etc)

   Testing Steps:

   1. Click the link on a device without the app installed

      1. Ensure no crashes occur

   2. Manually install the app (APK/SDK)

   3. Open the app and verify:

      1. It recognizes the previously stored device data

      2. User registration works (name, email, etc., if required)

5. Testing with Live Store Links (Post-App Launch)

   • Once the app is live, users must update the store links in the campaign settings

   • After updating, test the live flow to ensure:

     • The correct store page opens when the link is clicked

     • The app install and registration process works as expected

   Testing Steps:

   1. Update the campaign with valid App Store / Google Play Store links

   2. Click the link and confirm it redirects to the correct store page

   3. Install the live app and verify the registration flow

Expected Outcomes

✅ Campaign setup allows empty store links initially

✅ Universal link captures device data only after enabling Track iPhone & Android App Downloads

✅ Redirection to local APK/SDK works (if installed) or prompts installation

✅ Live store links function correctly after app launch.

Troubleshooting

Issue	Possible Fix
Device details not captured	Ensure the tracking toggle is enabled
Universal link not working	Check if the link is correctly generated
App not redirecting after install	Verify deep linking is configured (by the website team)
Live store links not redirecting	Confirm URL formatting is correct

Conclusion

This documentation ensures smooth testing of the app in development mode before going live. Developers should:

✔ Test on multiple devices (iOS & Android)

✔ Validate database logs after each test

✔ Confirm live store links post-launch

Next Steps:

• Perform cross-device testing

• Validate backend logs for accuracy

• Coordinate with the web team for deep link setup (if issues arise)