Common Error Messages and Solutions
Last updated July 29, 2024
When working with the Adjust SDK and API, you may encounter specific error messages that provide clues to resolve issues. This article will outline some common error messages, their potential causes, and solutions for addressing them.
Common SDK Error Messages and Solutions
- "Invalid App Token" / "Missing App Token":
- Cause: The app token used in the Adjust SDK initialization is incorrect or missing.
- Solution: Double-check the app token in your Adjust dashboard and ensure it is correctly entered in your app's code (e.g., `Adjust.onCreate()` for Android, `Adjust.appDidLaunch()` for iOS).
- "Invalid Event Token" / "Missing Event Token":
- Cause: The event token used in the `trackEvent()` call is invalid or missing.
- Solution: Verify that the event token matches the event name defined in your Adjust dashboard. Ensure you are using the correct event token in your code.
- "Event Tracking Disabled" / "Tracking Disabled":
- Cause: Event tracking might be disabled in your app's configuration, either within the Adjust SDK or by a privacy setting.
- Solution: Ensure event tracking is enabled in your app settings and SDK configuration. Check for any privacy settings that might be blocking tracking.
- "Session Tracking Error" / "Unable to Track Session":
- Cause: Issues with session tracking related to SDK configuration or device behavior.
- Solution: Verify that session tracking is properly enabled in your SDK configuration. Check device logs for any errors related to the session tracking feature.
Common API Error Messages and Solutions
- "Invalid API Credentials" / "Authentication Error" / "Unauthorized":
- Cause: The app token or API secret used for authentication is incorrect or invalid.
- Solution: Ensure that you are using the correct API credentials generated in your Adjust dashboard.
- "API Rate Limit Exceeded" / "Too Many Requests":
- Cause: You have exceeded the allowed number of requests to the Adjust API within a specific timeframe.
- Solution: Examine the Adjust API documentation for rate limit information. Implement mechanisms to pause requests temporarily and retry later.
- "Invalid Request" / "Bad Request" / "400 Status Code":
- Cause: The API request sent is formatted incorrectly, missing required parameters, or using invalid data.
- Solution: Review the API documentation to ensure you are using the correct request parameters, data formats, and methods for your API calls.
- "Internal Server Error" / "500 Status Code":
- Cause: An error occurred on Adjust's servers, temporarily preventing requests from being processed.
- Solution: Try retrying your API request later. If the error persists, contact Adjust support for assistance.
By understanding these common error messages and their common causes, you can troubleshoot SDK and API issues more efficiently and quickly resolve problems, ensuring smooth data tracking and insightful reporting.
Was this article helpful?