This page contains Help content for SDK providers using Google Play SDK Console.
If you're an app developer looking for Google Play Console Help content, use the search bar or return to the homepage.
You can view crash and application not responding (ANR) error reports in SDK Console to help prioritize and fix stability issues in your SDK. You can also add notes to crashes and ANRs to help app developers understand what caused them and what they can do to prevent them.
Crash and ANR reports in SDK Console
When an app crashes or is not responding on an Android-powered device whose user has opted in to automatically share their usage and diagnostics data, Google Play receives a crash or ANR report. We then share this report with app developers to help them debug and fix issues. If that app uses your SDK and we identify that your SDK may have been involved, you can view a crash or ANR report in SDK Console. Crashes and ANRs are grouped into clusters to help you identify when multiple issues may share the same root cause. To help preserve user and app developers anonymity, crashes and ANRs are only reported when the number of times that they occur exceeds the set threshold.
For more information about how Android users opt-in to share data, you can check Account Help Center.
View an overview of crashes and ANRsTo see an overview of crashes and ANRs over time on the Crashes and ANRs page, do the following:
- Open SDK Console and select SDKs on the left menu.
- Click on the SDK that you want to view crash or ANR information for.
- On the left menu, select Crashes and ANRs.
- Use the filter on the top right of the page to choose the time period you want to view the data from. You can choose Last 7 days, Last 14 days, Last 28 days, or Last 56 days. The chart will filter the data displayed based on your selection.
- You can also filter the results by SDK version, Android version, device model and number of affected apps. By default, the report is filtered to only show issues that affect 5 or more apps.
- All newly reported issues are classified as "Open" by default. You can update an issue’s classification (for example, to "Fixed") from a specific Crash details or ANR details page or the main Crashes and ANRs page, and then filter the issues by classification on that page.
- Note: For any classified issues, we encourage you to add an issue note. Issue notes allow you to relay important details and context around how to resolve the crash or ANR, which is displayed in Google Play Console to apps affected by the issue. To learn more about issue notes, see View issue details.
The chart shown on the Crashes and ANRs page shows the number of occurrences, the number of affected users, and the number of affected apps by day.
All reported issues are listed under "Issues" below the chart. For each issue, you can see the number of affected users and apps, the number of occurrences, and the date the issue last occurred. The list of issues is sorted by the highest to lowest number of occurrences.
To view issue details for a specific crash or ANR, do the following:
- Open SDK Console and select SDKs on the left menu.
- Click on the SDK that you want to view crash or ANR information for.
- On the left menu, select Crashes and ANRs.
- Scroll down to the "Issues" table.
- Click the right arrow (
) next to the issue listing you want to view.
- As with the Crashes and ANRs page, use the filter on the top right of the page to choose the time period you want to view data from. You can choose Last 7 days, Last 14 days, Last 28 days, or Last 56 days; the chart will filter the data displayed based on your selection.
- If you previously added a note for this issue for developers, you can view the note by clicking Show more next to "Note for app developers." You can also click Edit note if you want to change it. Learn more about issue notes below.
The Crash details or ANR details page shows the same information as on the Crashes and ANR page, specific to a single crash or ANR cluster, including the number of affected users and apps, the number of occurrences, and the last occurrence date. Similar to the chart on the Crashes and ANRs page, the chart on the Crash details or ANR details page displays this data visually, by day.
Below the chart, you can view more granular issue information sorted by SDK version (so you can identify which versions of your SDK are impacted), Android version, and device model.
To see the full list of SDK versions, Android versions, or devices, click Show all below the charts. Below these breakdowns, you’ll find the stack trace itself. To copy the stack trace to your clipboard, click the copy symbol () next to the stack trace.
To help protect developer information, app frames are shown as <private>. Each <private> frame represents one or more adjacent frames that have been redacted because they come from the app that has crashed or is not responding, a code library your SDK does not depend on, or a library your SDK is dependent on but is unknown to the system.
There can often be several variations of the stack trace for the same issue. Use the navigation bar at the top right of the "Stack trace" section to navigate between them. This can be the result of changes in line numbers across different SDK versions or differences between devices and OS versions. If there is only one stack trace, it may be because other variations are hidden for privacy reasons.
Note: If your SDK is obfuscated you should upload your deobfuscation files in order to get deobfuscated stack traces and allow SDK Console to group identical crashes or ANRs across different SDK versions.
You can add notes to any crashes or ANRs listed on the Crashes and ANRs page in SDK Console in order to help app developers understand what caused the issue or how it can be prevented.
By clearly communicating through these notes, you can help app developers understand the nature of a crash or ANR. This includes clarifying if the issue is with the SDK, an integration problem, or an external factor. This can help you build stronger developer relations, reduce confusion, potentially decrease direct support inquiries, and empower app developers to take appropriate actions—such as updating the SDK, correcting their integration, or understanding known limitations.
We recommend you include as much information as possible, for example, the cause of the crash or ANR, how to resolve it, or how it can be prevented. You can also add links to the SDK's documentation, issue trackers, or other guidance. The message will be shown to all app developers affected by this issue so it should not address an individual developer or include salutations.
When you add a note, it's displayed in Google Play Console on the Crashes and ANRs page of each app the crash or ANR affects.
Note: Developer Notes can’t be deleted but are editable, so you'll be able to adjust the information you provide.
To add a note to a crash or an ANR, do the following:
- Open SDK Console and select SDKs on the left menu.
- Click on the SDK that you want to view crash or ANR information for.
- On the left menu, select Crashes and ANRs.
- Scroll down to the Issues table.
- Click the right arrow (
) next to the issue listing if you want to add a note to.
- On the top right of the Crash details or ANR details page, click Add note for app developers. This opens a screen in which you can choose a crash status and add or edit your note, as shown in the screenshot below.
- Next to Crash status or ANR status, choose a category.
- Enter your note in the text box.
- Write a clear, concise, and actionable note (see examples below). You can use up to 500 characters.
- Note: You can add links to the SDK’s documentation, issue trackers, or any other external destination where you provide crash-related guidance to developers.
- Recommended: Have someone on your team review the content of the note before you proceed.
- When you're finished, click Add note. After you add a note, it can't be deleted. You can, however, edit them by going back to the Crash details page for the crash or ANR details page for the ANR, and clicking Edit note.
- Once submitted, the note will be in a Pending state. It may take a few days for the new note to go live and for developers to start seeing it in Play Console.
What happens after a note is updated in the SDK Console
- Once the developer note is submitted through the SDK Console interface, it enters a review queue.
- The note will be reviewed by the Play Developer Team.
- After the review and approval by the Play Developer Team, the developer note will be published.
- Upon publication, the note becomes visible within the Google Play Console to the app developers whose applications are affected by that specific crash or ANR cluster and are using your SDK.
Developer note categories and example notes
Below are the categories and example notes to guide your communication:
|
Crash Category |
Description |
Overall Status |
Example Notes |
|---|---|---|---|
|
Fixed in Newer Version |
A fix for this crash is included in a newer version of your SDK. |
Fixed |
Please update to com.mysdk.android.foo:foo-android:6.9.5 or higher. You can find the release notes for the fix at [LINK]. |
|
Caused by Wrong Integration |
Caused by the incorrect use of an SDK API, method, or parameter by the app. |
Won’t fix |
This crash is caused by incorrect integration of the mysdk SDK's [feature]. Specifically, it appears that the method is not being called when the associated activity or fragment is destroyed, leading to a memory leak and subsequent crash. Recommendation: Please review your implementation to ensure [feature] is called in the onPause() or onDestroy() lifecycle methods of your activity or fragment to properly de-register the listener. For detailed guidance on integrating the mysdk, please refer to our documentation: [link] |
|
Known Issue (Won't Fix) |
A crash that is happening (e.g., on an unsupported device/OS) or a known SDK issue the SDK provider doesn't intend to fix. |
Won’t fix |
This crash has been identified as occurring primarily on devices running Android versions below X.Y, which are no longer actively supported by our SDK. Status: While we acknowledge the issue, we will not be providing a specific fix for these older OS versions. Our development efforts are focused on supporting Android X.Y and above. We recommend targeting newer Android versions for optimal SDK performance and stability. |
|
Not Caused by SDK |
You believe your SDK code is not responsible for this crash; the issue lies within the client application or caused by a different SDK. |
Won’t fix |
This crash is likely due to an issue within your application. Please review your code and consider debugging with the help of relevant tools. |
|
Other |
Caused by any other issue not listed here. Use sparingly. |
com.mysdk.android.gms:mysdk:18.6.0 and higher include opt-in APIs that may help prevent this ANR. See details here [link] |
Update overall status
Update the SDK Console error cluster "status" and add "developer notes" to reflect the status information for app developers.
- Navigate to the Crash details page.
- Locate the Marked as dropdown menu. Click on it to reveal status options.
- Select the most appropriate overall status based on the following criteria:
|
Status |
Description / When to Use |
|---|---|
|
Open |
Investigation is ongoing, or no definitive resolution/determination has been made yet. This is typically the default status for new issues. |
|
Fixed |
The root cause has been addressed. For example, the problem was in your SDK code, and a fix is released in a specific SDK version (e.g., 17.0.1). |
|
Won't fix |
The SDK team will not be addressing this issue directly. This status covers several scenarios:
|
App developers can share issues which involve your SDK in order to help you debug your crashes or ANRs. Shared crashes or ANRs are displayed in SDK Console (Crashes and ANRs > Developer reported issues). Reported issues include the app name, a full stack trace of the crash or ANR, and additional crash or ANR information. If the Developer reported issues is not visible, this means that app developers have not shared any crashes or ANRs yet. We recommend encouraging app developers to share the issues they experience using View crashes and application not responding errors article.
The screenshot below shows an example of a developer reported issue:
If you have guidance to share with app developers about the reported crash or ANR, you can add an issue note (see Use issue notes to help app developers).
We will notify you by email when an app developer shares a crash or ANR involving your SDK. If you're not interested in receiving emails, you can opt out (go to Inbox > Manage email preferences).