Welcome
A short tour of the Artificial Poets Platform documentation — what each section covers, and where to start depending on what you want to do.
The Platform documentation is organized around the questions you can ask of your audience and content. Each top-level section maps to a tab in the dashboard. Each page inside it covers a concept, a metric, or a view you'll see in the product.
This page is your map. Skim the section summaries below, then jump to the area that matches what you're trying to learn.
How the docs are organized
The docs split into three parts. The engine explains how the platform works. Analytics holds the five sections that mirror your dashboard tabs. Workspace covers managing your sites, team, and account.
Engine
| Section | What it covers |
|---|---|
| Platform | How the engine is organized: the six pipeline lanes and the concepts behind them. Concepts only; live accounts have no Platform section in the dashboard. |
Analytics
| Section | What it covers |
|---|---|
| Audience | Who's visiting — active users, acquisition channels, returning visitors, retention, intent. |
| Engagement | How people interact — sessions, pageviews, scroll depth, search behavior, bounce rate. |
| Revenue | Where buying intent is — high-intent articles and how intent changes as visitors read more. |
| Content | What's being read — top pages, content classification by intent, search stats, device segmentation. |
| Performance | How fast your site feels — Core Web Vitals (LCP, FCP, INP, CLS), per-page breakdowns, SEO risk. |
| Glossary | Alphabetical index of every metric and term used in the dashboard. |
Workspace
| Section | What it covers |
|---|---|
| Sites | Every site connected to your workspace — the list view, connection health, the five per-site tabs (Overview, Health, Stack, Content, Settings), and how site data is collected. |
| Agents | The agents built for your organization, with their latest reports. |
| Organization | Org-level settings, team management, and billing. |
| Profile | Your own account: name, photo, sign-in, connectors and preferences. |
Where to start
Pick the entry point that matches your role:
- "I'm new — show me around." Read the Audience overview and Performance overview. Together they answer "how many people are here and how does the site feel."
- "I want to understand the AI under the hood." Open the Platform section. It walks through the six lanes your content passes through, from ingest to serving.
- "I'm setting up a new site." Open Sites for the list view and the per-site Settings tab.
- "I'm an editor or content strategist." Start with Content and Engagement. They surface which articles work and how readers move through them.
- "I'm responsible for site performance." Jump to Performance → Core Web Vitals and then Traffic Loss Risk to see what's costing you ranking.
- "I'm focused on monetization." Start in Revenue — Journey Optimization and High-Intent Content are the two pages to bookmark.
- "I'm managing the team or billing." Go to Organization for team members, invoices and payment methods.
- "I just need to look up what a metric means." Open the Glossary and search for the term.
How to read a metric page
Every metric page in the dashboard has a dedicated docs page. They follow the same shape:
- What it is — a one-paragraph definition.
- How it's calculated — the formula or rule the Platform applies, plus any thresholds (e.g. "good ≤ 2.5 s" for LCP).
- How to interpret it — what high and low values mean, with the relevant caveats.
- How to use it in the dashboard — which filters and breakdowns help you act on the number.
If a page mentions another term in bold, the first mention links to that term's definition. Hover the link to see a short summary without leaving the page; click to open the full page.
Domain filters
The domain filter in a page header waits for you. Tick the sites you want, then select Apply; the page updates once. Filters in a table's column header change the table right away.
Row numbers in tables
A table that holds more than 10 rows shows a # column first. Use it to point someone to a row, such as "row 50".
The number is the row's place in the current sort and filter. It carries on across pages: at 25 rows per page, page 2 starts at 26. It is not a fixed ID, so sorting or filtering numbers the rows again.
A note on numbers
Web analytics is a noisy measurement. Core Web Vitals are reported at the 75th percentile (p75): 75% of measurements fall at or below the number shown. That shows the typical experience without extreme outliers skewing it. The p75 glossary entry explains the trade-offs and when to look at other percentiles.
Need something that isn't here?
Can't find a term you saw in the dashboard, or a topic you expected? Let us know. We update the docs whenever the product changes.