Network Health Check

Overview

Network Health Check validates:

• Credential Validity: Confirms that your network authentication credentials are still valid and haven't expired
• Account Accessibility: Verifies that every connected advertiser account is still accessible and hasn't been deleted or had access revoked
• Connection Status: Provides instant feedback on the health of your network integration

This feature works across all supported networks in NinjaCat, not just major advertising platforms.

How to Access

There are two ways to run a health check:

Option 1: From Network Settings (Full Network Check)

1. Navigate to Settings → Networks
2. Click Edit on any network connection
3. Click the Check Health button
4. View instant results showing the status of all connected accounts

This validates both the network credentials and every advertiser account linked to that network.

Option 2: From Command Center (Single Account Check)

1. Navigate to Command Center → Data Sources
2. Locate the advertiser data source you want to validate
3. Click the Validate button
4. View the result for that individual connection

Use this option when you want to quickly check a single account without running a full network-wide check.

Understanding Results

The health check returns immediate results with detailed information for each connected advertiser account:

Result Statuses

Note: If you see Network Error, the issue is with the network's authentication credentials rather than an individual account. Fix the network credentials first, then re-run the health check to validate individual accounts.

Note: A Not Supported result means the network provider does not currently support automated account-level accessibility checks. The network credentials themselves may still be valid.

Result Details

For each account, you'll see:

• Advertiser Name - The name of the advertiser account in NinjaCat
• Connection Name - The name of the network connection
• Account ID - The unique identifier for the account on the network platform
• Error Details - For failed accounts, specific information about why the verification failed

Filtering Results

Click on the status badges to quickly filter the results:

• Click "Verified" badge to show only successful connections
• Click "Failed" badge to show only connections with issues

This makes it easy to focus on accounts that need attention.

Common Use Cases

Before Report Runs

Run a health check before scheduled report runs to ensure all data connections are working properly. This proactive approach prevents report failures and missing data.

Troubleshooting Report Failures

When a report fails, use the health check to quickly identify which specific advertiser account has connection issues, saving time versus manually checking each account.

After Credential Updates

After updating API credentials or refreshing OAuth tokens, verify that the new credentials work across all connected accounts.

Regular Maintenance

Periodically check network health as part of regular maintenance to catch and resolve issues before they impact client reporting.

Important Notes

• Instant Results: Health checks run immediately with no background jobs or polling required
• All Networks Supported: This feature works with every network integration in NinjaCat (though account-level validation may show "Not Supported" for some providers)
• Non-Destructive: Running a health check does not modify any connections or trigger data syncs
• Real-Time Validation: Results reflect the current state of your network connections at the moment you run the check

Resolving Failed Connections

When a health check identifies failed connections:

1. Review the error details provided for each failed account
2. Common issues include:
   • Expired authentication credentials (resolve with Network Error status first)
   • Revoked account access permissions
   • Deleted advertiser accounts on the network platform
   • Changed account IDs or network reorganizations
3. Update credentials or re-authenticate the network connection as needed (see Update Data Source Tokens)
4. Remove connections to deleted or inaccessible accounts
5. Run the health check again to verify the issues are resolved