Dataset: AI Usage
Entity: AI Usage Measurement
Field ID: surface_name
Type: Text
Description: The raw surface value published by the provider. Kept alongside surface_ref so a value Keypup has not yet mapped is never lost.
Source: App
Transformation logic: N/A
App Mapping
GitHub Copilot | the raw |
Anthropic Claude (coming soon) | the raw |
Cursor (coming soon) | the source counter name ( |
OpenAI Platform (coming soon) |
|
OpenAI Codex (coming soon) |
|
Reporting Use Cases
The Surface Name field is the provider's own word for where the usage happened. surface_ref is the comparable version; this is the faithful one.
Finer detail than surface type: Several provider surfaces map onto one surface type. Grouping by surface name separates Cursor's composer from its agent, or Copilot's edit mode from its agent mode.
Reproducing a provider's own dashboard: GitHub counts a user with both active and passive code review signals as active only. Filtering to
surface_name = code_review_activereproduces that definition.Spotting new provider features: An unfamiliar value here is usually a surface the provider has just added and Keypup has not yet mapped, which will show as
UNATTRIBUTEDinsurface_ref.Not comparable across providers: Every provider uses its own vocabulary. Use
surface_reffor any chart that spans more than one tool.
