Settings
Loyalty Settings

Points Freeze Windows

11min

This feature is currently available to a limited group of users as part of our beta testing. We’ll include it in our release notes when it’s ready for a broader rollout.

What is a points freeze window?

A point freeze window allows retailers to set a period of time where points cannot accrue for a specific customer.

Freeze windows do not delete or create new events, or change any part of the persona record. They simply modify the point values of existing events if they fall within the selected date range.

Benefits

  • Prevent fraud or misuse of points
  • Limit points accumulation when appropriate or necessary (ie. during policy change, system maintenance or before a promotional period)
  • Business recalibration (ie. inventory reconciliation, financial reviews, etc.)

Events

During a points freeze window, some actions related to points are still allowed, but many are blocked.

ο»ΏBlocked Actionsο»Ώ

  • Customers are unable to collect points from sales, multipliers, boosts, referrals, collectibles, and legacy point events.
  • Expirations will not occur for any events that took place during a window, as they are not eligible for points.
  • Block adjustments will not be awarded during a freeze window. If a persona's balance has become negative during the point freeze window (this could be due to expirations, redemptions, merging, etc.), a block adjustment will be awarded the day after the window has ended to bring the balance back up to 0. If a freeze window is applied retroactively and there are existing block adjustments that occurred during the window, they will be ignored.

ο»ΏAllowed Actionsο»Ώ

  • Points adjustments to existing balances are allowed to occur during the point freeze window.
  • Redemptions are allowed to occur during a window if the persona has points from before the window started.
  • Expirations can occur for any events that took place before the window and are set to expire during the window if reset_gaps is not enabled.

ο»Ώ

  • Start Time: The time that the point freeze window will begin.
  • End Time (optional): If provided, the time that the point freeze window will end. If not provided, all customer actions after the event start_time will not accrue points.
  • Reset Points (optional):
    • If enabled, the persona's balance will be zeroed and persona will start accumulating points at zero (0) once the freeze window ends. If there is no end_time, the persona's balance will indefinitely stay at zero (0).
    • If disabled, the persona will keep any points accumulated before the window start_time.
  • Reset Gaps: Only applicable when expirations are enabled, and has no effect if reset_points is enabled.
    • If reset_gaps is enabled, expirations will not occur during the window for events that took place before the window's start_time. The first sale after the window's end_time will be the new starting point for expiration gaps going forward.
    • If reset_gaps is disabled, expirations can occur during the freeze window for events that took place before the window's start_time.

ο»Ώ

How it works

Each freeze window applies to a single persona, and each persona can have multiple freeze windows.

Create freeze window manually

  1. Navigate to Settings > Loyalty > 'Restrict Accrual by Persona' and select 'Manage Accrualal Restrictions'
  2. Manually enter persona's contact ID, phone number, or email, select start and end times, and optionally use the toggle to zero out a persona's balance until the restriction ends.
  3. Click 'create' to save freeze window for that persona.
Document image
ο»Ώ

Create freeze windows using bulk import

Bulk upload csv template available to download in platform.

  1. Navigate to Settings > Loyalty > 'Restrict Accrual by Persona' and select 'Manage Accrualal Restrictions'
  2. Select 'Bulk Import Blocklist'
  3. Choose appropriate file from native file picker and select 'open'
    1. File should include contact ID, phone Number, email, start time, end time, reset points and reset gaps.

Bulk upload start and end time use RFC3339 format to ensure your freeze windows start and end accurately. You can find date-time converters on google to help convert your start/end times.

Active restriction windows

To view active restriction windows, navigate to Settings > Loyalty > 'Restrict Accrual by Persona' and select 'Manage Accrualal Restrictions'. Scroll to the bottom of the drawer to find active windows.

Users can search restriction windows using PII.

Document image
ο»Ώ

Edit a freeze window

  1. Navigate to the Active Restriction Windows table and find the desired persona freeze window you want to edit
  2. Click on the row you'd like to edit and scroll up to the 'Edit Persona Accrual Restriction' fields. Adjust date or 'Zero out accumulated points' toggle and click 'Update' in the top right corner to save.
Document image
ο»Ώ

Delete a freeze window

  1. Navigate to the Active Restriction Windows table and find the desired persona freeze window you want to delete
  2. Click on the trash can icon on the row you'd like to delete
  3. Confirm delete action to finalize on confirmation pop-up. Optionally cancel action.
Document image
ο»Ώ

ο»Ώ

ο»Ώ