Our purchases app allows you to install our widget on your order confirmation page and within user accounts, allowing users to see raffle ticket numbers after their purchase.
Already have your promotion setup and need to install it? Skip to Step 8.
Requirements
Before you begin, make sure:
You are using BigCommerce
All products and variants have unique SKUs
This is required to correctly assign raffle tickets
If you’re using a legacy Blueprint theme, contact support for help with installation
Step 1: Create a promotion
Create a new promotion
Select Purchases → BigCommerce
Step 2: Connect your store and import products
If your store is already connected, it will appear at the top
If not, connect your store
Click Update Products → Import Products and All Variants
Your products will appear on the right side.
Step 3: Select qualifying products
Choose the products or variants that should award raffle tickets
If multiple items are included, tickets will be assigned based on each item purchased
Step 4: Assign raffle tickets
Click the ticket icon next to each product/variant
Enter how many raffle tickets each purchase earns
💡 Tip: Name your SKUs or variants based on ticket amounts to avoid confusion.
Step 5: Configure promotion details
Add a promotion title
Set start and end dates
Choose the number of winners
Enable Raffle Tickets
Enter your Store URL
Step 6: Adjust entry settings
Set entries to 0 per $1 spent
(Since tickets—not entries—are being awarded)
Note:
If a customer purchases a non-qualifying product, the widget will display a message on the confirmation page indicating the order does not qualify.
Step 7: Customize your promotion
Upload images for the post-purchase widget
Add your official rules
(Optional) Enable geo-targeting
Customize widget design in the Design section
(Optional) Enable email notifications for ticket confirmations
Click Done to save your promotion.
Step 8: Install the widget (Checkout page)
Go to the Install tab in your ViralSweep dashboard
Copy the code under Step 1: Install to Checkout
In BigCommerce, navigate to:
Advanced Settings → Data Solutions → Affiliate Conversion Tracking
Paste the code and click Save
Step 9: Install the widget (Theme)
Copy the code under Step 2: Install to Theme
In BigCommerce, go to:
Storefront → Script Manager → Create a Script
Set the following:
Name: ViralSweep
Location: Head
Pages: All pages
Category: Essential
Type: Script
Paste the code and click Save
Step 10 (Optional): Show tickets in customer accounts
If your store uses customer accounts:
Copy code under Step 3: Install to Account Page
In BigCommerce, navigate to:
Storefront → Advanced → Edit Theme Files → Templates → Pages → Account → Orders → All.html
Paste the code before the closing
</main>tagSave changes
Step 11: Test your setup
Make a test purchase on your store
You’ll see the widget on the order confirmation page showing raffle ticket numbers
If enabled, customers can also view tickets in their account
Legal disclaimer
ViralSweep provides tools to run purchase-based sweepstakes and raffles. However, laws vary by location.
You are responsible for ensuring compliance with local regulations
This may include offering a free alternative method of entry, where required
If you’d like help with legal compliance in the U.S. or Canada, contact us for assistance.
Need help?
Click the chat icon in the lower-right corner to get in touch with our support team.