1. Why use tags
Use tags when you want to answer questions like:- How does login conversion differ by
country? - Does auth success differ between experiment variants (
auth_variant = AvsB)?
2. Send tags from the SDK
In the Corbado Observe SDK, flow events andconversion() accept tags as an optional second argument (Record<string, string>). Flows are the carrier: configuration known at entry goes on flowStarted(), values only known on success go on flowFinished(). The last value per key wins across a flow’s events.
You can attach tags:
- Globally via
defaultTagsin tracker initialization. - Per event by passing a tags object to a tracking call.
3. Tagging best practices
- Keep tags short, predictable and business-relevant.
- Use strings for all values (for example
is_new_user: "true"). - Avoid high-cardinality identifiers (for example raw user IDs) as tags.
- Prefer user references for identity mapping and tags for segmentation.