audience-snapshot AudienceSnapshot

Age-group × gender breakdown row.

Age-group bucket. Aggregate-level only; never identifies a single viewer. Wire form preserves the numeric-range convention common to analytics APIs that report demographics this way (e.g. YouTube Analytics' `ageGroup` dimension emits `age13-17`, `age18-24`, …).

Content-type breakdown — Shorts vs VOD vs livestream.

Country-distribution row.

Authoritative content-type classification from the host platform's analytics surface, where one is exposed (e.g. YouTube Analytics' `creatorContentType` dimension). The best available signal for separating short-form, long-form, livestream, and story content in audience aggregates; the connector reconciles `Video.kind` against this where the host platform supports it.

Classification of a synced field's data sensitivity. Drives subject- rights workflows and cache-purge retention decisions.

Device-distribution row.

Device type reported by analytics surfaces. Connectors map their native device taxonomies onto the closest member.

Gender bucket reported by analytics surfaces. `user_specified` captures platforms that expose self-declared options beyond the female/male binary.

ISO 3166-1 alpha-2 country code.

ISO 8601 date (YYYY-MM-DD).

Live-vs-on-demand split row.

Live-vs-on-demand discriminator on a daily aggregate row.

Operating system reported by analytics surfaces.

Operating-system-distribution row.

Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`

Playback location reported by analytics surfaces. Connectors map their native location dimensions onto the closest member.

Playback-location-distribution row.

Per-channel audience activity attributable to the host platform's premium subscription tier, where the platform exposes one (e.g. YouTube Premium / formerly "YouTube Red"). Tracks the slice of views and watch-time that originated from premium subscribers; absent when the platform does not surface premium-tier metrics.

Retention policy applied to a synced record. Tiers are named after the discipline they impose; the connector layer maps each upstream surface onto the appropriate tier. - `thirty_day_strict` — atomic records that auto-purge or refresh at the thirty-day boundary. The dominant tier on platforms whose Terms of Service impose a thirty-day cache discipline on derived data (e.g. YouTube Developer Policies §III.E.4 for Data API outputs). - `thirty_day_aggregate_with_lineage` — atomic record purges at thirty days; the aggregate computed from it may be retained when accompanied by explicit `derived_from` + `derivation_method` lineage. - `auth_lifetime` — atomic record retains against active OAuth authorisation; tears down on token revocation or tenant deletion. Used for analytics surfaces whose ToS explicitly exempt them from the thirty-day rule (e.g. YouTube Analytics API per §III.E.4). - `creator_authored` — data the tenant originates rather than fetches; no upstream-platform retention constraint applies. - `metadata_indefinite` — structural identifiers and immutable timestamps the upstream ToS explicitly permits to retain.

Source attribution for a synced field. Records the kind of upstream surface that produced the value; combined with the parent record's `platform`, this fully attributes any value back to its origin. Open-ended by design: new connector kinds (e.g. monetary or content- owner APIs) extend without breaking changes. The platform discriminator (`Channel.platform`) carries the brand identity; this enum carries only the kind of API surface the value came from.

Subscribed-status discriminator on a daily aggregate row. Splits audience activity by whether the viewer is subscribed to the channel at the time of the play.

Subscribed-status breakdown row.

Provenance metadata stamped on every synced atomic record across the creator pillar. Per-record granularity; the `retention_tier` reflects the strictest tier of any field on the record so the cache-purge job can decide conservatively. Field-level retention distinctions are documented in each entity type's struct doc-comments — the schema documents the static taxonomy, the data carries only the per-fetch state.

Traffic-source-distribution row.

Traffic-source type reported by analytics surfaces. The eighteen members cover the union of categories surveyed across major creator analytics APIs; values prefixed `platform_` denote platform-internal sources (the platform's own search, channel pages, recommendation surfaces) that map onto each platform's native enum at the connector boundary.