Mobile App Testing in Development Mode
1. 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.
2. Key Features & Testing Steps
2.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:
Create a campaign without entering store links.
Verify the campaign is saved successfully.
Later, update the campaign with valid store links and confirm they are stored correctly.
2.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:
Go to campaign settings and enable the toggle for Track iPhone & Android App Downloads.
Verify that the universal link is now functional.
2.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:
Click the universal link from a test device (mobile/tablet).
Verify that the device details are recorded in the database.
Check the web dashboard to confirm the captured data is displayed correctly.
2.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:
Click the link on a device without the app installed.
Ensure no crashes occur.
Manually install the app (APK/SDK).
Open the app and verify:
It recognizes the previously stored device data.
User registration works (name, email, etc., if required).
2.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:
Update the campaign with valid App Store / Google Play Store links.
Click the link and confirm it redirects to the correct store page.
Install the live app and verify the registration flow.
3. 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.
4. Troubleshooting
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.
5. 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).
Last updated