🔧 Connection Troubleshooter - Error Code Examples

This page demonstrates how the improved Connection Troubleshooter identifies specific error codes and provides targeted solutions. The troubleshooter analyzes error messages and descriptions to detect common Microsoft Advertising issues.

📡 API Connection Issues

These errors occur when connecting to Microsoft Advertising API endpoints.

Authentication Errors

Error Message: "invalid_grant" or "unauthorized_client"
Your API credentials are invalid or expired
AUTH_001 - Authentication Failed

Targeted Solutions:

  1. Verify your Client ID and Client Secret in the Microsoft Advertising Developer Center
  2. Check if your access token has expired and refresh it
  3. Ensure your application is properly registered with Microsoft Advertising
  4. Verify the redirect URI matches exactly in your application settings
Error Message: "access_denied" or "insufficient_scope"
Your API token lacks the necessary permissions
AUTH_002 - Insufficient Permissions

Targeted Solutions:

  1. Review your OAuth scopes and ensure they include required permissions
  2. Check your account user roles and permissions
  3. Verify your application has been granted the necessary access levels
  4. Contact your account administrator to update permissions

API Rate Limiting

Error Message: "rate_limit_exceeded" or "too_many_requests"
You have exceeded the API rate limits
API_001 - Rate Limit Exceeded

Targeted Solutions:

  1. Implement exponential backoff in your API calls
  2. Reduce the frequency of your API requests
  3. Consider upgrading your API tier for higher limits
  4. Cache API responses to reduce unnecessary calls

🛒 Merchant Center Issues

These errors occur with product feed and Merchant Center connections.

Feed Connection Problems

Error Message: "feed_not_found" or "feed_unreachable"
Your product feed could not be uploaded
MERCHANT_001 - Feed Upload Failed

Targeted Solutions:

  1. Check your feed URL is accessible and returns valid data
  2. Verify the feed format matches Microsoft Merchant Center requirements
  3. Ensure your server allows access from Microsoft's crawlers
  4. Check for any authentication requirements on your feed URL
Error Message: "invalid_feed_format" or "missing_required_fields"
Your product data has quality or compliance issues
MERCHANT_002 - Data Quality Issues

Targeted Solutions:

  1. Review the data quality report in Merchant Center
  2. Fix missing required fields (title, description, price, etc.)
  3. Ensure product images are accessible and meet size requirements
  4. Check for policy violations and update product information

👤 Account Access Issues

These errors occur when accessing your Microsoft Advertising account.

Account Problems

Error Message: "invalid_credentials" or "account_locked"
Unable to log into your Microsoft Advertising account
ACCOUNT_001 - Login Failed

Targeted Solutions:

  1. Reset your password using the "Forgot Password" link
  2. Check if two-factor authentication is enabled
  3. Verify your account is not locked or suspended
  4. Try logging in from a different browser or incognito mode
Error Message: "account_suspended" or "policy_violation"
Your Microsoft Advertising account has been suspended
ACCOUNT_002 - Account Suspended

Targeted Solutions:

  1. Check your account for policy violations
  2. Review your billing information and payment method
  3. Contact Microsoft Advertising support immediately
  4. Provide any requested documentation for account review

🌐 Network & Browser Issues

These errors occur due to network connectivity or browser compatibility problems.

Network Problems

Error Message: "connection_timeout" or "network_unreachable"
Connection to Microsoft Advertising is timing out
NET_001 - Network Timeout

Targeted Solutions:

  1. Check your internet connection stability
  2. Try connecting from a different network
  3. Disable any VPN or proxy services temporarily
  4. Contact your IT department about firewall settings
Error Message: "dns_lookup_failed" or "host_not_found"
Cannot resolve Microsoft Advertising domain names
NET_002 - DNS Resolution Failed

Targeted Solutions:

  1. Change your DNS servers to 8.8.8.8 and 8.8.4.4
  2. Flush your DNS cache
  3. Check your hosts file for any blocking entries
  4. Contact your ISP if DNS issues persist

How the Troubleshooter Works

🔍 Error Detection Process:

  1. Pattern Matching: Analyzes error messages for specific error codes and keywords
  2. Confidence Scoring: Assigns confidence levels (60-85%) based on match quality
  3. Context Analysis: Considers connection type and issue description
  4. Solution Mapping: Provides targeted solutions for each detected error
  5. Lead Scoring: Adjusts lead scores based on error severity and type

📊 Benefits of Error Code Detection:

🚀 Try the Troubleshooter