Segmented offers use purchase history to match cardholders to the appropriate merchant offer. Use the guidance below to understand when backfilling is needed and how offers are selected when history is missing.
Coordinate with Percents to backfill purchase history. Backfilling is needed only for segmented offers, to ensure customers are segmented accurately. Unsegmented offers do not require it.
Backfilled history supports offer selection. It does not create rewards or change previous rewards. Do not submit historical purchases as new earning events.
Missing history is not the same as knowing a customer has made no purchases. Depending on Percents and merchant policy, a cardholder without enough history may:
- Receive an unsegmented offer, if one is available.
- Remain unsegmented with no matching offer.
- Be assigned to a segment selected under that policy.
As new purchases are recorded, later eligibility requests can use that history. Display the returned offer and terms. Do not infer a customer’s purchase history from a fallback or assume an offer will always match.
Where returned, segmentSource explains how the offer was selected:
| Value | Basis for selection |
|---|---|
history | Purchase history. |
unknownDefault | A fallback under Percents and merchant policy because history was insufficient. |
unsegmented | An offer that does not depend on history. |
An evaluation error is not a no-match result or a successful fallback. Follow the error and retry guidance when evaluation fails.