Account Settings

Manage connected ad accounts. Credentials are stored locally on the server.

🔌 Connected Accounts

🔌
Loading accounts…

➕ Connect a New Account

▼
🔵
Google Ads
Developer Token + OAuth2
🔷
Facebook Ads
App + Access Token
🟣
Windsor AI
Legacy API (being sunset)
Sign in with Google → grant Ads access. Auto-fills Client ID, Secret & Refresh Token below. Then enter Developer Token + Customer ID and Save.
Google Ads API Center → API Access
Your ad account ID (dashes OK)
Generate via OAuth2 Playground or google-auth-oauthlib
Facebook Business Manager → Ad Accounts
Long-lived User Token or System User Token from Meta Developer Portal
⚠️ Windsor AI API is being sunset. Consider migrating to direct Google Ads or Facebook Ads connections.
Comma-separated platform account IDs

⚙️ Dashboard Preferences

▼
Auto-selected on homepage load
Auto-selected on homepage load
Server runs in UTC — 11:00 UTC = 6:00 AM EST

🤖 AI Settings (Recommendations)

▼

Keys are stored server-side in data/settings.json and are never sent to the browser unmasked. You can also set them as environment variables (ANTHROPIC_API_KEY, OPENAI_API_KEY) — env vars take priority.

Status: checking…
Status: checking…
Which AI powers the 💡 AI Tips tab on the dashboard

📖 Setup & How to Run the Application

▼

📁 Where to Find the Code

All application files are in your selected folder:

Autorama/ads-dashboard/
Backendmain.py
Google Adsservices/google_ads.py
Dashboard UIstatic/index.html
Settings UIstatic/settings.html
Accountsdata/accounts.json
Cachedata/cache/
Snapshotsdata/snapshots/

⚙️ First-Time Installation

  1. Open a terminal and navigate to the folder:
    cd ads-dashboard
  2. Install Python dependencies:
    pip install -r requirements.txt
    If that fails, try the minimal install first:
    pip install -r requirements-core.txt
  3. Start the server:
    python main.py
  4. Open your browser at:
    http://localhost:8000

🔑 Google Ads Credentials

  1. Developer Token — Google Ads → Tools → API Center
  2. OAuth2 Client ID & Secret — Google Cloud Console → APIs → Credentials → Create OAuth2 Client (Desktop app type). Add http://localhost:8080/ as an authorized redirect URI.
  3. Refresh Token — Use OAuth2 Playground. In settings, check "Use your own OAuth2 credentials" and enter your Client ID and Secret. Authorize scope https://www.googleapis.com/auth/adwords, then exchange for a refresh token.
  4. Customer ID — Found in the top-right of your Google Ads account (format: 123-456-7890).
  5. Login Customer ID — Only needed if using a Manager (MCC) account.

🚀 Running in Production

For a more stable deployment:

pip install gunicorn gunicorn main:app -w 2 -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:8000

Enable login protection by adding a .env file:

AUTH_ENABLED=true AUTH_USERNAME=admin AUTH_PASSWORD=your-strong-password

Adjust cache duration (default 6 hours):

CACHE_TTL_HOURS=12

To run behind Nginx, proxy requests to localhost:8000 and set up SSL with Certbot.