Contest lite
    • 10 Minutes to read

      Contest lite


        Article summary

        Create engaging sweepstakes using Antavo’s Contest lite module, offering customers the opportunity to spend their points for a chance to win prizes, similar to lottery tickets.

        Running a contest is a cost-effective way to reduce the number of unspent points in a loyalty program, as customers will redeem their points for the chance to win a prize – not directly for the prize itself.

        All configured settings are accessible via Display API, allowing you to implement your own design on the customer-facing membership site. The Display API also provides the activities/{contest_id}/enter and activities/{contest_id}/revoke endpoints to enter and remove customers from contests.

        Discover the Participate in a contest and Remove from contest workflow nodes to execute a contest-based workflow or campaign. This particular use case explains the scenario where you can reward customers with multiple contest entries.

        To find the configuration page, navigate to the Modules menu and search for the Contest lite module. The page will open, displaying the contests already set up with the following information:

        Name

        The name of the contest. The status of the contest is displayed under the name of the contest which reflects the progress and availability.

        • Active: Currently ongoing and accepting entries.

        • Inactive: The contest has not been activated or a platform user has deactivated it.

        • Completed: The contest has been completed and winners have been selected.

        • Scheduled: The start date of the contest is configured as a future date.

        Start date

        The start date of the contest.

        End date

        The end date of the contest.

        The default sorting order of the contests in the list is as follows:

        1. Start date of the contest: The contest with the earliest start date is at the top of the list.

        2. End date of the contest: If multiple contests have the same start date, the one that ends sooner is placed higher on the list.

        3. Name of the contest: If multiple contests have the same start and end date, the contests are ordered alphabetically by their names.

        Creating a new contest

        To create a new contest, click the Create new contest button in the sidebar of the Contest lite module page or click the Create button in the top-right corner.

        Basic information

        • Enter the title of the contest

        • Upload an image for the contest

        • Write the description of the contest

        • Enter the Terms & Conditions of the contest
          The Terms & Conditions should contain all the legal details about the rules for participation.

        • Add the completion text
          This text may appear after the contest has ended.

        Mechanics

        • Set the start and end dates of your contest

        • Define the date until the contest should be visible
          If this date is later than the end date, the Display API that lists the available contests for each customer will indicate that the progression of the contest is completed.

        • Select the segment(s) for which you’d like to make the contest available
          The Display API will include the contest in the list with restricted status to customers outside of the selected segment(s).

        • Restrict winner selection to the segment checkbox
          Refine the segment-based contest participation. This option is only available if you have selected segment(s) in the previous step. It is set to false by default. Enable it to remove customers who are no longer in the specific segment(s) at the time of winner selection from the winner selection pool. This means that they cannot be selected as winners.

        • Write a restriction message
          This message informs customers why there are not able to enter the contest If the contest is restricted to specific segment(s), enter a general message that covers both time- and segment-related limitations.

        • Specify the number of points the customers will spend to enter the contest
          The price you set here applies to one entry.

        • Set the number of times a customer can enter the contest

        • Set the number of winners of the contest

        Winner selection method

        In the last section of the module configuration page, you can choose how you would like to draw winners for your contest. Here are the options:

        • Select randomly from all customers: Winners will be selected randomly from the pool of all entrants, without any prioritization.

        • Select randomly from the top X customers: Winners will be randomly selected from customers with the most entries.

        • Customers with the most entry points: The customer(s) with the highest number of points spent to enter will win.

        Points economy

        If you use Multi-accounts, select the account from which the entry points should be deducted.

        • Click Create to save the contest

        Activating the contest

        After saving for the first time, the status of the contest is inactive, meaning it only appears in the list of contests on the module configuration page.

        To activate the contest, you can use the Set active button on the upper right-hand side of the setup page and confirm the activation in the dialog that subsequently appears.

        Managing contests

        Edit a contest

        Contests can be edited until the end date of the contest.

        • Navigate to the Contest lite module configuration page

        • Click the Edit button of the specific contest’s hamburger menu on the module configuration screen

        • Edit your contest

        • Save your changes by clicking Save

        Copy the contest ID

        When looking up a contest in workflows you need to enter the ID of the contest. By clicking the Copy ID button of the contest of the specific contest’s hamburger menu, the ID can be copied to the clipboard allowing you to paste it in the Lookup value field when configuring the Entity lookup workflow node.

        Select winners

        Once a contest ends, you can select winners using the winner selection method you chose when creating the contest.

        • Navigate to the Contest lite module configuration page

        • Click the Winner selection button in the hamburger menu of the finished contest on the module configuration screen

        You’ll see a list of customers who participated in the contest, along with the previously selected set of winners (if applicable).

        📓

        Please note that the list includes every customer who participated in the contest. However, the winner selection mechanism will exclude customers who are no longer eligible to participate based on the segment restriction settings applied when the winners are selected.

        • Click the Select winners button on the upper right-hand side of the page
          The name of the winner will appear immediately under the Selected winners section.

        You can draw winners in a contest an unlimited number of times using the Draw again button.

        Close the contest

        To prevent anyone from overwriting the results of the winner selection, it’s essential to close every contest.

        • Go to the Contest lite module configuration page

        • Navigate to the contest’s Winner Selection screen

        • Click the Close the contest button

        • Confirm your choice in the dialog that appears

        Deactivate a contest

        To deactivate an inactive contest, follow these steps:

        • Navigate to the Contest lite module configuration page

        • Click the Edit button of the contest’s hamburger menu you want to deactivate

        • Click the Set inactive button on the upper right-hand side of the page

        • Confirm your choice in the dialog that appears

        Inactive contests are not returned by the activities/contests Display API endpoint.

        Archive a contest

        You have the option to delete the inactive contests from the Management UI by archiving them.

        • Go to the Contest lite module page

        • Click the Edit button of the contest’s hamburger menu you want to archive

        • Click the Archive button on the upper right-hand side of the page

        • Confirm your choice in the dialog that appears

        Archiving is irreversible. Once a contest is archived, it cannot be restored anymore.