You can use the data source diagnostics tool to find and fix issues with your data connections, ensuring your data connections are in a healthy state. You can access the data source diagnostics tool from the Data manager page in Google Ads.
Open the diagnostics tool
From the Data manager page:
- In your Google Ads account, open Data manager.
- Connections with issues have a “Needs attention” or “Urgent” status indicator. Hover over a status indicator to see a card with details and recommended actions.
- Click on a recommended action to complete it, or click on View all issues to see all diagnostic details for the connection.
From other pages, such as Conversions or Audience manager:
- Open the settings for one of your connections.
- In the connection settings, go to the Connection quality subsection of the Manage your connection card.
- View the connection quality status, then click to find and fix detected connection issues.
Connection quality statuses
The diagnostics tool shows the following connection quality statuses to highlight detected issues, their severity, and how to fix them. When you fix an issue, the status updates to show the improved connection quality.
Excellent
No issues detected.
Excellent means that no issues have been detected with the connection. You won’t experience any issues for this data quality status as your connection is considered fully optimized. However, be sure to continue to check the connection quality status as the status might change when new issues are detected.
Good
No issues detected, and recommendations are available to help enhance performance.
Good means that no issues have been detected with the connection, but we've provided at least one recommendation to improve your connection quality.
Needs attention
Your data is being imported, but there are issues that should be addressed to prevent impact to your measurement.
Needs attention means an issue with the connection needs your attention. The issue should be fixed, but the issue isn't critical.
Urgent
Critical data source connection issues are preventing your data from being imported which is impacting your measurement.
An urgent status indicates a critical issue with the connection that requires immediate attention to maintain accurate measurement. For example, if the connection was previously running but hasn't run in the last 48 hours, causing data to drop to zero, an urgent status will be triggered. To resolve an urgent status, review your setup to ensure the connection is correctly configured.
Data source diagnostics
We may show you one or more of the following diagnostics to help you identify issues with your connection setup:
- Your <data-source> credentials have been refused: This diagnostic appears when we've detected that the credentials you have provided, such as user name or password, have been rejected by the data source. This can happen when the credentials are changed, or the credentials no longer have permission to access the connected data. To fix this issue, confirm that you have the correct credentials and that they are permitted to access the data source, then reinitiate the connection setup to try authorizing again.
- History tracking not enabled in Salesforce: This diagnostic appears when we've detected that Event History Tracking is not enabled in your Salesforce account. Event history tracking is required in order to import data from Salesforce. To fix this issue, enable event history tracking in your Salesforce account.
- <Data-source> data formatting issue: This diagnostic appears when we've detected one or more formatting issues in your data source. To fix this issue, verify that your data is properly formatted and transform your data as needed. Also, review requirements in the guide for the data source.
- Source for <data-source> not found: This diagnostic appears when we've detected that a connector has an issue, but the specific cause of it could be due to a variety of reasons. Common reasons for this issue:
- Target object, such as a table or file, is deleted.
- No permission to access the data source.
To fix this issue, check whether the data source exists. If it exists, ensure that the credentials are valid, and that data sharing permissions are granted.
- Imported data and Google tag don’t have matching transaction ID: This diagnostic appears when your tag and website data sources are sending data, but the transaction ID fields produce no matches. The transaction ID is used to match the website and imported data to report accurate conversions. To fix this issue, update your offline data to ensure that the transaction ID is mapped correctly and matches the formatting of what's coming through from the tag.
- Offline data is missing conversion value: This diagnostic alert appears because your bidding strategy might be impacted due to the lack of conversion values for your offline data. To fix this issue, send conversion values for your offline data to ensure that your bidding strategy isn’t negatively impacted.
Related articles: