Core entities
Project. The unit of tracking: one brand and its competitors, topics, prompts, platforms, and schedule — the thing you set up and measure. Everything else in OpenLens hangs off a project. Organization. The owner of your projects, data, users, seats, and billing. You get your own when you sign up, and can invite people in or join someone else’s. Every request is scoped to an organization. Brand and competitor. A brand is a company tracked in a project. The project’s own company is the own brand; every other tracked company is a competitor. Both are stored the same way and scored the same way. Topic. A theme that groups prompts, e.g. “project management software.” A project has many topics; each topic holds several prompts. Prompt. A single question sent to the AI platforms, e.g. “What is the best project management tool for startups?” Prompts belong to a topic. Prompt run. One execution of a project’s active prompts across its active platforms, triggered manually (“Run Now”) or on a schedule. A run fans out into many platform responses. Run status. Where a prompt run stands. Running while it is still gathering answers; Completed when every platform finished; Failed if it could not finish; Interrupted if a restart stranded it mid-run (these recover on their own); Cancelled if you stopped it before it finished. The Recent prompt runs list shows each run’s status. Platform response. One platform’s answer to one prompt within a run. This is the atomic result OpenLens parses for mentions, citations, and response attributes. In pricing this same unit is called an output — “one answer from one AI platform for one prompt.” (See Plans for how outputs draw from your credit pool.)Metrics
Visibility. The share of platform responses that mention your brand. The headline number: how often models bring you up at all. Share of voice. Your brand’s share of the total brand discussion, measured across you and your competitors. Where visibility asks “do they mention you,” share of voice asks “when brands come up, how much of the conversation is yours.” Visibility and share of voice are different metrics and can move independently. Average position. The order your brand tends to appear in a response, where 1 is first-mentioned and most prominent. Mention (brand mention). A single instance of a brand named in a platform response. Mentions feed visibility and average position. Citation and source. A citation is a specific URL a response cited. A source is the domain that citation belongs to. The dashboard’s “AI Sources” view aggregates citations by source domain. Sentiment. Whether a response attribute is discussed positively, neutrally, or negatively about a brand.Attributes and labels
Prompt attribute. A label you assign to a prompt to slice your data — e.g.pricing, enterprise-readiness, or the built-in branded. Prompt attributes are set at prompt-generation time and never derived from a response. See Prompt attributes.
Response attribute. A quality discussed about a brand in a platform response, each with a sentiment — e.g. “noise cancellation,” “pricing,” “customer support.” Response attributes are extracted from the response text by the parser; they are brand-scoped, but the quality itself is often category- or product-level, not an intrinsic brand trait. Prompt attributes and response attributes are distinct: one is a label you assign, the other is a quality the model brought up.
Branded and unbranded. A branded prompt names a brand (“Is Acme’s pricing competitive?”); an unbranded prompt does not (“What is the best CRM?”). branded is a built-in prompt attribute, auto-assigned to prompts that name a brand, and is a common dashboard filter.
Platforms
Platform. One of the seven AI systems OpenLens measures. Each platform is reached through one channel: the consumer chat surface (“Web”) or the vendor’s public API (“API”). See How OpenLens sources data.
Google AI measures Google’s AI Overviews.
Google integrations
GSC property. The unit Search Console tracks: either a domain property (sc-domain:example.com, covering every subdomain and protocol) or a URL-prefix property (one exact prefix). Each project points at one. See Search & Traffic.
Key events. GA4’s current name for conversions. Same concept, renamed by Google in 2024. OpenLens reports them exactly as your GA4 property defines them.
AI referral traffic. Sessions arriving at your site with an AI platform as the referrer (chatgpt.com, perplexity.ai, gemini.google.com, and the rest). A lower bound by construction: native apps and pasted links send no referrer, so the true number is higher.