Troubleshooting Tracking Issues
Last updated July 29, 2024
Ensuring accurate and reliable tracking of app installs and user events is crucial for effective mobile app marketing. This article will guide you through troubleshooting steps to diagnose and fix common tracking issues that you might encounter while using Adjust.
Diagnosing Tracking Problems
- Verify SDK Integration:
- Correct SDK Version: Double-check that you are using the latest compatible Adjust SDK version for your platform.
- Proper Initialization: Ensure the Adjust SDK is properly initialized in your application's lifecycle methods (e.g., `onCreate()` for Android, `application:didFinishLaunchingWithOptions:` for iOS).
- App Token: Verify that you are using the correct app token assigned to your app in the Adjust dashboard.
- Review Event Tracking:
- Event Names: Confirm that the event names you are tracking in your app match the event names defined in your Adjust dashboard.
- Event Parameters: Ensure that you are passing the correct event parameters and using the appropriate data types for each parameter.
- Check Device Compatibility:
- Supported Platforms: Ensure the devices you are testing on are supported by the Adjust SDK version you are using.
- Operating Systems: Verify that the devices' operating systems (iOS or Android) meet the minimum requirements for the SDK.
- Examine Logs:
- Adjust SDK Logs: Enable debug logs within the Adjust SDK to identify any errors related to tracking, initialization, or event reporting.
- Device Logs: Review the device's system logs for errors related to Adjust or tracking.
- Review Network Connectivity:
- Internet Connection: Ensure that the device has a stable internet connection and that there are no network firewalls or proxies blocking access to Adjust servers.
Troubleshooting Attribution Issues
- Check Attribution Model:
- Correct Model: Verify that the attribution model selected in your Adjust dashboard aligns with your expected results.
- Campaign Configuration: Ensure that your campaigns are configured correctly with the desired attribution model.
- Review Marketing Campaigns:
- Campaign Links: Double-check that the campaign links you are using are accurate and that they point to the appropriate destinations.
- Campaign Tracking: Ensure that campaign tracking is enabled and configured correctly within the Adjust dashboard.
- Analyze Traffic Sources:
- Organic vs. Attributed: Evaluate the proportion of installs coming from organic traffic versus attributed installs to identify any discrepancies.
- Campaign Performance: Examine the performance of individual campaigns to identify any potential issues with attribution for specific channels.
Additional Tips
- Test on Different Devices: Test your app on multiple devices and operating system versions to ensure consistent tracking across various environments.
- Review Adjust Documentation: Consult the comprehensive Adjust documentation for detailed troubleshooting guides, best practices, and known issues.
- Contact Adjust Support: If you continue to experience tracking issues, reach out to Adjust's support team for assistance.
Was this article helpful?