Skip to content
Last updated

Offer Segments and Purchase History

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.

Purchase history for onboarding

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.

When Purchase History Is Missing

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.

Understand the Selection Result

Where returned, segmentSource explains how the offer was selected:

ValueBasis for selection
historyPurchase history.
unknownDefaultA fallback under Percents and merchant policy because history was insufficient.
unsegmentedAn 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.