schemaVersion

Your own event-schema/tracking-plan version, stamped onto every envelope as schema_version — distinct from the library's own Envelope.sdk version. Null (the default) omits the field. Evolve it only for changes that alter how downstream consumers must interpret an event (e.g. a renamed or repurposed property); purely additive changes don't need a bump, since existing readers already ignore unknown fields.