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

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

Understanding Results

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

Result Status

• Verified - The account connection is healthy and accessible
• Failed - There is an issue with this account connection

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
• 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
   • 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
4. Remove connections to deleted or inaccessible accounts
5. Run the health check again to verify the issues are resolved