Skip to content

onboard-new-client.md

Latest commit

 

History

History
155 lines (126 loc) · 3.73 KB

onboard-new-client.md

File metadata and controls

155 lines (126 loc) · 3.73 KB
Raw

Onboard A New Client With UXON

Onboard a new client by creating a sub-account, setting conversion goals, creating the first landing page, connecting a domain, and configuring tracking.

Inputs To Collect

  • Client or business name.
  • Website URL.
  • Reporting currency, such as USD, AUD, or GBP.
  • Reporting timezone when known, as an IANA timezone such as Australia/Brisbane. Do not add friction if unknown.
  • Landing page feedback mode, usually free_comments.
  • First conversion goal, such as Qualified Lead, Phone Call, or Purchase.
  • Preferred publishing domain or subdomain.
  • Tracking mode: gtm or direct.

Do not ask for brand colors, typography, voice, logo URL, or media assets during first setup unless the user volunteers them. UXON uses the website URL to start brand fetching, color/font assignment, and media scraping automatically.

Command Sequence

1. Create The Sub-Account

{
  "command": "subaccounts.create",
  "input": {
    "name": "Acme Dental",
    "websiteUrl": "https://acmedental.com",
    "reportingCurrency": "USD",
    "reportingTimezone": "Australia/Brisbane",
    "landingPageFeedbackMode": "ai_approvals"
  }
}

Save the returned siteId.

2. Check Branding Overview

{
  "command": "branding.get",
  "input": {
    "siteId": "site_uuid"
  }
}

Use this to confirm current color variables, brand colors, logos, fonts, brand voice, and readiness.

Optional manual adjustment, only when requested:

{
  "command": "branding.update",
  "input": {
    "siteId": "site_uuid",
    "colorVariables": {
      "button": "#F8C80B",
      "buttonText": "#111111"
    },
    "logo": {
      "dark": "https://example.com/logo-dark.svg"
    },
    "fonts": {
      "buttons": {
        "source": "heading",
        "fontWeight": "600 - Semi-Bold"
      }
    },
    "brandVoice": "Clear, useful, confident, and specific. Avoid hype."
  }
}

Logo role meaning: logo.light is a light-coloured or white logo for dark backgrounds, logo.dark is a dark-coloured logo for light backgrounds, and logo.favicon is the square browser/app icon.

Custom font imports are optional and only when requested. Use direct .woff2, .woff, .ttf, or .otf URLs in customFonts; use the web app/upload workflow for binary font files.

After any update, run branding.get again and confirm the saved values.

3. Create The First Goal

{
  "command": "goals.create",
  "input": {
    "siteId": "site_uuid",
    "name": "Qualified Lead",
    "isActive": true
  }
}

4. Create The First Blank Landing Page

{
  "command": "landing_pages.create",
  "input": {
    "siteId": "site_uuid",
    "name": "Spring Offer"
  }
}

Use landing_pages.generate_from_brief instead when the user wants UXON AI to create the page from a brief.

5. Add The Domain

{
  "command": "domains.add",
  "input": {
    "siteId": "site_uuid",
    "domain": "acmedental.com",
    "subdomain": "go"
  }
}

6. Connect The Domain

{
  "command": "domains.connect",
  "input": {
    "domainId": "domain_uuid"
  }
}

7. Configure Tracking

{
  "command": "tracking.setup",
  "input": {
    "siteId": "site_uuid",
    "mode": "gtm",
    "domain": "go.acmedental.com",
    "gtmContainerId": "GTM-ABC1234"
  }
}

Done Criteria

  • Sub-account exists.
  • Brand/media import has been triggered from the website URL.
  • Branding overview has been inspected and any explicit manual adjustments have been saved.
  • At least one conversion goal exists.
  • First landing page draft exists.
  • Domain is added and DNS instructions are available or verified.
  • Tracking mode is configured for the intended domain.
  • Next step is clear: build page content, publish when approved, or launch an experiment.