Troubleshooting SDK & API Issues
Last updated July 29, 2024
While implementing the Adjust SDK and API generally runs smoothly, you might encounter challenges along the way. This article will guide you through common troubleshooting steps for both SDK integration and API usage, helping you identify and resolve potential issues.
Troubleshooting SDK Issues
- Verify SDK Integration:
- Correct SDK Version: Ensure you are using the latest compatible Adjust SDK version for your platform.
- Proper Initialization: Make sure the Adjust SDK is properly initialized in your application's lifecycle methods (e.g., `onCreate()` for Android, `application:didFinishLaunchingWithOptions:` for iOS).
- Correct App Token: Double-check that the app token used is accurate, matching the one provided in your Adjust dashboard.
- Check Device Compatibility:
- Supported Platforms: Ensure the target device is supported by the Adjust SDK version you are using.
- Operating System Versions: Verify that the device's operating system (iOS or Android) meets the minimum requirements for the SDK.
- Review Event Tracking:
- Event Names: Ensure the event names you are tracking match the ones defined in your Adjust dashboard.
- Event Parameters: Verify that you are passing valid event parameters and that they align with your event definitions in Adjust.
- Examine Logs:
- Debug Logs: Enable debug logs within the Adjust SDK to view detailed information about SDK calls, errors, and events.
- Device Logs: Examine the device's system logs for any errors related to Adjust.
Troubleshooting API Issues
- Verify API Credentials:
- Accuracy: Double-check the app token and API secret you are using for authentication.
- Access Permissions: Ensure the API credentials have the necessary access permissions to perform the requested actions.
- Check HTTP Status Codes:
- Success (200): A successful API call.
- Errors ( 4xx or 5xx): Identify errors related to requests, authentication, or server issues.
- Review API Documentation:
- Correct Endpoints: Ensure you are using the correct API endpoints for your intended actions (e.g., `/track`, `/events`).
- Valid Parameters: Verify that you are using the correct parameters and data formats for each API request.
- Handle Rate Limits:
- API Rate Limiting: Be aware of Adjust's rate limiting policies to prevent exceeding request limits.
- Pause Requests: Implement mechanisms to pause API calls if exceeding rate limits and retry later.
- Examine Error Messages: The Adjust API will provide error messages with specific details about why a request failed. Use these to diagnose and resolve issues.
Seeking Additional Help
- Adjust Documentation: Consult the comprehensive Adjust documentation for detailed information, code examples, and troubleshooting guidelines.
- Adjust Support: If you continue to face difficulties, reach out to Adjust's dedicated support team for assistance.
By understanding common troubleshooting techniques and effectively utilizing Adjust's resources, you can address SDK and API issues efficiently, ensuring reliable tracking and data collection for your mobile app.
Was this article helpful?