Slots
Measure ad performance by placement so you can experiment, measure, optimize.
A slot names a placement of a Koah ad in your app — in-chat, sidebar, inline feed card. Tag each ad request with its slot and Koah attributes every metric to that placement, so you can compare them and double down on what earns the most.
How to use slots
Register the slot first
Slots must be registered before use. Add them in settings under Slots and enter a name (see naming rules below).
Passing an unregistered slot fails the ad request with an error.
Pass the slot on each request
Pass the registered slot name as the slot field on ad request from that placement.
Break down metrics by placement
Once requests are flowing, break your dashboard metrics down by slot to compare performance.
Naming rules
Slot names are auto-formatted in the dashboard (lowercased, spaces → hyphens) and must match the pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$.
| Rule | Valid | Invalid |
|---|---|---|
| Lowercase letters and numbers | sidebar1 | Chat-Footer |
| Hyphens to separate segments | chat-footer | chat--footer |
| No leading or trailing hyphens | sidebar | -sidebar- |
| Max 20 characters | home-sidebar | this-slot-name-is-too-long |
Slots break down metrics by placement. To compare A/B variants instead, run an experiment — the two are complementary.