Attribution slots (simple & advanced)
Understand how attribution slots split reward quantity across time and what the slot validation rules enforce.
In this article, you'll learn what attribution slots are, when to use them, and which timing and quantity rules OmniLab checks before publication.
Advanced tool, simple purpose
An attribution slot is just a time window with a quantity attached to it. Use slots only when one continuous reward window is not precise enough for the campaign.
What an attribution slot is
An attribution slot is a bounded window that makes a specific quantity available during a specific period.
Use slots when the reward should not be evenly available across one long window. Instead of saying "50 rewards anytime this week," you can say "10 rewards this morning, 20 this afternoon, and 20 tomorrow."
Simple versus Advanced
| Mode | Best when | What you configure |
|---|---|---|
Simple | One continuous reward window is enough. | One start date, one end date, one total quantity |
Advanced | Distribution should change over time. | Several attribution slots, each with its own dates and quantity |
Start with Simple unless you have a real reason to control how the quantity is spread across the campaign.
Where slots appear
You can encounter attribution-slot logic in several places:
- reward-level
Instant Win scheduleflows - advanced luck-based game distribution
- receipt-game winning options
Even when the slot editor appears in different places, the same validation logic applies: dates must be valid, quantities must be positive, and the total must stay coherent.
Rules that always apply
Attribution slots should follow the same checklist every time:
- each slot needs a start date and an end date
- the end date must come after the start date
- slot dates must stay inside the effective campaign window
- slot quantities must be greater than
0 - overlapping slots for the same reward are not allowed
- the sum of all slot quantities must match the reward quantity
If a touchpoint uses date overrides, the slot window still has to fit the effective touchpoint window, not just the campaign-level dates.
Common validation issues
| Validation message | Meaning | Fix |
|---|---|---|
Attribution slot {{slot_index}} for reward '{{reward_name}}' is missing a start date | The slot cannot become active at a defined time. | Add the start date for that slot. |
Attribution slot {{slot_index}} for reward '{{reward_name}}' has invalid quantity {{quantity}} | The slot quantity is 0 or otherwise unusable. | Set a positive quantity. |
Attribution slots {{slot1_index}} and {{slot2_index}} for reward '{{reward_name}}' overlap | Two slot windows conflict for the same reward. | Adjust the dates so the slots do not overlap. |
Attribution slots for reward '{{reward_name}}' total {{slot_total}} but reward quantity is {{reward_quantity}} | The slot breakdown does not match the reward quantity. | Rebalance the slot quantities until the totals match. |
Related
Instant Win rewards
Use slots when a global Instant Win reward needs more than one continuous window.
Dates (Pattern B)
Keep reward timing inside the overall campaign schedule.
Touchpoint dates override
See how touchpoint-specific date windows affect reward timing.
Winning options and attribution slots
Compare the same timing logic in transaction and receipt-style configurations.