BidScope AI — Onboarding & Demo Setup

Step 1 of 8

Welcome to BidScope AI

A Google Ads decision system — not just a dashboard. Here's what you need to know before you start.

🟡

You are in demo / mock mode. All data shown is mock/sample data. No live Google Ads account is connected. No real changes will be made. Real integrations are locked until you complete the full A-to-Z demo checkpoint.

🧠 What BidScope Is

BidScope is a Google Ads decision system — it combines multiple data sources, applies rules-based AI logic, generates decisions with evidence, and produces an approval-based export workflow. You review every decision before anything touches your account.

📊 What BidScope Is NOT

BidScope is not an autopilot. It does not automatically change bids, pause keywords, or upload anything. There is no AI that touches your account without your approval. You remain in full control at every step.

🔗 What BidScope Combines

📢 Google Ads

Spend, keywords, impressions, CTR, QS, bid data

📈 Google Analytics 4

Sessions, CVR, bounce rate, funnel drop-off, geo data

👁️ Microsoft Clarity

Rage clicks, dead clicks, scroll depth, session recordings

📞 Leads Gear

Call tracking, missed calls, GCLID attribution, DNI

💰 CRM

Jobs booked, revenue, true ROAS, win rate

🔍 GSC + PageSpeed

Organic presence, Core Web Vitals, page load speed

🎯 Who BidScope Is For

UAE roadside and auto services businesses (and similar local services) running Google Ads — where lead quality, call tracking, and cost-per-job matter more than click-through rate. BidScope is designed for operators who want evidence-based decisions, not vanity metrics.

Step 2 of 8

How the Decision System Works

Data flows through 8 engine modules from raw inputs to an approved, exportable CSV — nothing reaches Google Ads without your sign-off.

Engine Flow

📄 Contracts

Data schemas

→

🗄️ Mock Data

Demo / live

→

🔌 Adapters

Normalise

→

🔗 Attribution

GA4+Leads+CRM

→

📊 Marts

KPI scoring

→

⚙️ Rules Engine

Decisions

→

✅ Approval Queue

You review

→

📤 Export Center

CSV package

→

🖥️ Google Ads Editor

Manual import

⚙️ Rules Engine

Applies 50+ configurable rules across spend efficiency, keyword performance, bid logic, negative keyword gaps, Quality Score changes, and cross-source attribution anomalies. Each rule produces a decision with a confidence score (0–100) and an evidence bundle.

✅ Approval Queue

Every decision lands here first. You can view the full evidence trail, approve, reject, or defer. Only approved items move to the Export Center. Nothing is automatic. Every change is your decision.

📤 Export Center → Google Ads Editor

Approved items are packaged into a Google Ads Editor-compatible CSV. You open Google Ads Editor, import the CSV, review all changes in the Editor UI, then click Post. BidScope never touches your account directly.

🔒

No Google Ads API writes. No automatic uploads. No bid changes without your import action in Google Ads Editor. Rollback snapshot generated before every export.

ℹ️

Engine modules loaded: bidscope-data-contracts.js · bidscope-mock-data.js · bidscope-adapters.js · bidscope-attribution.js · bidscope-marts.js · bidscope-rules-engine.js · bidscope-exports.js · bidscope-ui-bridge.js — all 8 modules attach to window.BidScope and run entirely in-browser. No server required.

Step 3 of 8

Data Sources Explained

BidScope combines 8 data sources. All are in mock/demo mode now. Real connections require Step 22 sign-off.

🟡

All sources are mock mode. Demo data is realistic but not from your account. Real connection details are in Connected Accounts →

📢

Google Ads

Keywords, bids, spend, impressions, CTR, Quality Score, search terms, ad performance, campaign structure.

🔒 API locked Free API

📈

Google Analytics 4

Sessions, CVR by geo/device, funnel drop-off, event tracking, conversion attribution, page performance.

🔵 Mock mode Free API

👁️

Microsoft Clarity

Rage clicks, dead clicks, excessive scrolling, session recordings, heatmaps, mobile UX issues.

🔵 Mock mode Free tool

📞

Leads Gear

Call tracking with GCLID, missed calls, call duration, DNI (Dynamic Number Insertion), call source attribution.

🔒 API locked Subscription

💰

CRM (GoHighLevel)

Jobs booked, revenue per job, win rate, true ROAS calculation, lead-to-job conversion rate.

🔒 API locked Subscription

🔍

Google Search Console

Organic keyword rankings, impressions, CTR, position data — helps identify paid vs organic cannibalisation.

🔒 API locked Free API

⚡

PageSpeed Insights

Core Web Vitals, LCP, CLS, FID, mobile vs desktop speed scores, landing page load performance.

🔵 Mock mode Free (25K/day)

🔧

Optional Paid Tools

DataForSEO · AI explanation API · Call transcription · Uptime monitor · Competitor SERP data. All optional, all capped.

🔒 All disabled $100/mo cap

Attribution Engine — How Sources Are Combined

Google Ads click → GA4 sessionGCLID + UTM matching

GA4 session → Leads Gear callDNI + session ID cross-reference

Leads Gear call → CRM jobPhone number + timestamp matching

True ROAS calculationCRM revenue ÷ Google Ads spend (not Google Ads reported)

Clarity UX → Landing Page scoreRage click rate + scroll depth + CVR combined

Step 4 of 8

Your Daily Workflow

BidScope is designed for a 15–30 minute morning routine. Here's the recommended flow from briefing to export.

Morning Routine — 15–30 min

1

🌅 Open Daily Briefing

Review the AI-generated morning summary: urgent issues, top opportunities, negatives to add, what's working. Generated at 06:00 from all connected data sources. Check the top 3 urgent items first.

2

🧠 Review Decision Center

Check AI-generated decisions sorted by urgency. Each decision shows: rule name, confidence score, evidence trail (Google Ads + GA4 + Clarity + Leads Gear + CRM), estimated impact, and risk level.

3

🔍 Open Evidence Panel

Click any decision row to expand the full evidence panel — see exactly why BidScope made this recommendation, which data sources contributed, and what the counterfactual risk is. Never approve blind.

4

✅ Approve or Reject in Queue

Approved decisions move to the Export Center. Rejected decisions are dismissed with a log entry. High-confidence, low-risk items (negatives, small bid adjustments) can be bulk-approved. High-risk items require individual review.

5

📤 Export to Google Ads Editor CSV

Click "Export & Show Summary" in the Export Center. BidScope generates a rollback snapshot first, then packages all approved items into a Google Ads Editor-compatible CSV file.

6

🖥️ Import in Google Ads Editor

Open Google Ads Editor → File → Import → From CSV. Review all changes in the Editor's review panel. Make sure you agree with every change before posting. This is your last checkpoint.

7

📊 Check Results Next Morning

The next morning briefing will show the impact of yesterday's changes. Google Ads performance data typically updates within 3 hours. GA4 and Leads Gear update continuously. CRM data syncs daily.

⚠️

What NOT to do: Do not increase bids while tracking is broken. Do not pause campaigns without checking all attribution sources. Do not add broad match keywords while negative gaps exist. BidScope's "What NOT to do" panels on each decision flag these risks automatically.

Step 5 of 8

Safety & Governance

BidScope has multiple layers of protection between AI decisions and your Google Ads account.

🎯

Confidence Score (0–100)

Every decision includes a confidence score based on evidence quality, data volume, and rule reliability. Scores below 80 are flagged as low-confidence. You can filter the queue by confidence threshold. High-risk items require individual approval regardless of score.

🔍

Evidence Bundle

Each decision links back to its evidence: Google Ads search term data, GA4 session/CVR data, Clarity UX signals, Leads Gear call data, and CRM revenue — all cross-referenced. You see exactly what data drove the recommendation.

✅

Approval Queue — Nothing Skips It

Every decision, regardless of confidence, must pass through the Approval Queue. There is no auto-approve mode. There is no scheduled automation. Every export requires a manual click from you.

🔄

Rollback Snapshot

Before generating any export CSV, BidScope saves a rollback snapshot — a record of the pre-change account state. If a change produces unexpected results, you have a reference point to revert from in Google Ads Editor.

🔒

No Direct Write Automation

BidScope has zero Google Ads API write access. There is no Google Ads API OAuth token. No changes are pushed programmatically. The only path to your account is: CSV → Google Ads Editor → your review → your Post click.

🔐

No API Keys Stored

This application stores zero API keys, credentials, or authentication tokens. All engine logic runs client-side in your browser. Nothing is sent to a server. No data leaves your browser session.

💳

Paid Tools Disabled by Default

All optional paid tools (DataForSEO, AI API, call transcription, uptime monitor) are disabled and set to enabled: false. They will not activate or incur costs until you explicitly enable them after completing Step 22.

ℹ️

Safety labels in the UI: Every decision in the queue shows one of five export status labels — ✅ Ready for CSV · ⚠ Requires Approval · 📋 Report Only · 👁 Monitor Only · 🛡 Blocked by Safety Rule. Only "Ready for CSV" items can be exported.

Step 6 of 8

$100/Month Optional Tools

BidScope runs on free APIs. If you want enhanced intelligence, an optional $100/month paid layer can be enabled after Step 22 — never before.

🔒

All paid modules are disabled. They cannot activate, incur costs, or make API calls in demo mode. No keys are stored. This table is for planning reference only.

Free-First Foundation (Enable First)

Tool	What It Adds	Cost	Status
Google Ads API	Live keyword/spend/search term data	Free	✅ Free
GA4 Data API	Sessions, CVR, funnel, geo data	Free	✅ Free
GTM	Tag management, conversion tracking	Free	✅ Free
Microsoft Clarity	Heatmaps, rage clicks, session replay	Free	✅ Free
PageSpeed Insights API	Core Web Vitals, LCP, CLS	Free (25K/day)	✅ Free
Google Search Console API	Organic rankings, impressions	Free	✅ Free

$100/Month Paid Intelligence Layer

Tool	What It Adds	Monthly Cap	Status
DataForSEO	SERP data, keyword difficulty, competitor positions	$30	🔒 Disabled
AI Explanation API	Natural-language decision explanations for client reports	$20	🔒 Disabled
Call Transcription	Auto-transcribe Leads Gear calls, extract intent signals	$20	🔒 Disabled
Uptime Monitor	Alert if landing pages go down while ads are spending	$10	🔒 Disabled
Competitor Reserve	Ad copy monitoring, auction insights enrichment	$20	🔒 Disabled

Kill-switch rule: If total monthly spend exceeds $80, all paid modules pause automatically. Per-query cap: $0.50 max. You will be alerted at $50. Full cap: $100/month absolute maximum.

💡

Recommendation: Start with the free-first foundation. Most BidScope clients see strong results from Google Ads API + GA4 + Clarity alone — no paid tools required. Only enable paid tools if you have a specific intelligence gap the free tools don't cover.

Step 7 of 8

Real Integration Lock

Real integrations are locked until all of these checkpoints are passed AND you explicitly say "start real integrations."

🔒

Integration lock is active. No connections will be made — even if you have API keys ready — until all gates below are passed and you give explicit sign-off. This protects your live account from demo-mode accidents.

✅

Browser QA passed All 4 HTML files open correctly in browser. Engine loads. No console errors. Navigation works between phases.
✅

Phase 1 demo polish complete Decision Center, Approval Queue, Export Center, Daily Briefing all polished with mock-mode labels and what-not-to-do panels.
✅

Phase 2 demo polish complete Google Ads Intelligence module polished. Amber demo banner. Mock labels in place.
✅

Phase 3 demo polish complete GA4 Intelligence, Clarity UX, Landing Page Diagnosis all polished. Mock-mode labels. What-not-to-do panels.
✅

Settings / Connected Accounts complete All 12 account cards showing not-connected. API Cost Control at $0/$100. Integration Gate visible.
✅

Onboarding complete This onboarding wizard reviewed and completed. All 8 steps understood.
⏳

Steps 20–21 complete (Command Bar + Full Cross-Phase QA) Command bar demo polish and full QA pass across all 4 HTML files pending.
⏳

Final A-to-Z QA complete (Step 22) Full pre-integration readiness gate. All engine self-tests pass. All navigation verified. All mock labels confirmed.
🔒

User explicitly says "start real integrations" This is the final gate. Even after Step 22 passes, integrations remain locked until you give this explicit instruction in the BidScope session. No automatic unlock.

ℹ️

When you are ready to start real integrations, begin with the free-first foundation in order: GA4 → Clarity → PageSpeed → GSC → Google Ads API read-only → Leads Gear → CRM. Never start with the Google Ads API write path.

Step 8 of 8

You're Ready — Start the Demo

Onboarding complete. Open any section of BidScope AI to explore the demo. Everything uses mock data — safe to click anything.

✅

Demo mode is active. All data is mock/sample. No live account connected. No changes possible. Explore freely — the approval flow, export flow, and all intelligence modules are safe to interact with.

🚀 Open a Section

🌅

Daily Briefing

Morning summary · 4 urgent issues · 3 opportunities

🧠

Decision Center

24 AI decisions · evidence panels · confidence scores

✅

Approval Queue

Review · approve · reject · export to CSV

📊

Google Ads Intelligence