Quickstart Guide

Step-by-step walkthrough to set up an isolated client workspace, ingest daily ad records, and produce calibrated forecasts in under five minutes.

Last updated: October 2026

This guide walks you through establishing an operational workspace in PaceCast. By the end of this tutorial, you will have connected advertising data, executed a pre-flight schema validation, and generated a calibrated 30-day forecast with conformal bounds.

1. Account Registration & Access

PaceCast provides both a browser studio interface and an authenticated API. To create your account:

  1. Navigate to the Sign Up page and register using your business email.
  2. Verify your email address via the confirmation link sent to your inbox.
  3. Sign in to access your administrative dashboard at /dashboard.

2. Create a Client Workspace

Workspaces represent individual brands, accounts, or business units. Every workspace retains its own currency, timezone, attribution window settings, and target KPIs.

AttributeTypeRequirement & Specification
Workspace Namerequired
string
Human-readable label for the brand or client (e.g. 'Acme Footwear').
Currency Coderequired
ISO 4217
Three-letter currency code (e.g. 'USD', 'EUR', 'GBP'). All monetary metrics normalize to this currency.
Timezonerequired
IANA string
Reporting timezone matching your ad manager (e.g. 'America/New_York', 'UTC').

Workspaces can also be provisioned programmatically via the REST API or MCP:

Create Workspace via curl
curl -X POST "https://pacecast.app/api/clients" \
  -H "Authorization: Bearer <SESSION_OR_MCP_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "NorthStar Athletics",
    "currency": "USD",
    "timezone": "America/Los_Angeles"
  }'

3. Ingest Campaign Data

PaceCast supports two primary ingestion methods:

Option A: CSV Export Upload

Export daily campaign metrics from Meta Ads Manager or Google Ads covering the last 90–365 days. PaceCast automatically normalizes column aliases (e.g. “Amount spent” and “Cost” map to “Spend”).

Option B: Google Ads OAuth Link

Connect your Google Ads account directly via OAuth 2.0. Authorize access, select your 10-digit Customer ID, and PaceCast's background worker will synchronize historical campaign daily records.

4. Launch an Analysis Run

Once data is uploaded or synchronized, configure your run parameters:

  • Forecast Horizon: Choose 30 days for monthly pacing or 60 days for quarterly planning.
  • Spend Scenario: Select Hold (current run-rate), Scale (percentage budget change with diminishing returns), or Plan (custom flight schedule with promotional event dates).
  • Creative Intelligence: (Optional) Enable to analyze attached video or image assets and produce evidence-informed production briefs.

Click Run Analysis. Pre-flight checks execute instantly. If data passes verification, time-series calibration completes in under 15 seconds.

5. Review Results & Export Briefs

Upon completion, the dashboard renders the complete analysis report:

  • The Pace Line: Daily conversion volume and CPA trajectory with the 90% calibrated uncertainty band.
  • Validation Receipts: WAPE backtest score vs 7-day Seasonal-Naive benchmark.
  • Creative Strategy: Top-performing hook scripts, visual pacing hypotheses, and format recommendations.