Documentation
⚡ User Guide

Creating & Managing Campaigns

Plugin: v1.3.6 · 10 sections · ~8 min read · 🌍 Public

Getting Started

  1. Register at viraloo.org/register
  2. Confirm your email and log in
  3. You land on your dashboard — start from here

Your Dashboard

CardWhat it shows
CampaignsTotal created, and how many are active
ActiveCampaigns currently live
ParticipantsTotal entries across all campaigns (30-day trend)
ReferralsTotal referral clicks generated (30-day trend)

The Participant Growth & Referrals chart shows a 30-day daily line. The Top Campaigns panel ranks giveaways by participant count.

Creating a Campaign

  1. Click New Giveaway (top-right on the dashboard)
  2. Fill in the details:
    • Title — public name of your giveaway
    • Description — what participants win and how to enter
    • Start / End date
    • Prize — what you're giving away
    • Entry actions — follow, share, visit, etc.
    • Theme color and theme (light / dark)
  3. Use AI Generate to draft copy automatically from a prompt
  4. Click Create Campaign

Managing a Campaign

From your dashboard click a campaign title or the Manage button.

Overview

Live stats: participants, referrals, views, conversion rate.

Participants

Full entrant list. Filter by action, referral source, or date. Click Export CSV to download the full list.

Winners (Cryptographically Verifiable)

  1. Click Pick Winners to run the deterministic draw
  2. Only entrants who confirmed their email and are not flagged by fraud detection are eligible
  3. The system picks the configured number of winners using a SHA-256-seeded algorithm (weighted by entries)
  4. Each winner receives an automatic congratulations email
  5. A public verification page is generated at /campaign/{id}/verify
💡 After picking winners you'll see two new buttons: 🔍 View public verification page and 📋 Copy verify link. Share that link on social media when you announce winners — anyone can click "Replay draw in browser" and mathematically confirm the result is fair. Picking winners is final; the proof is immutable.

The verification page shows the cryptographic seed, the snapshot of eligible entries (with pseudonymous IDs only — no personal data), the winners by rank and ticket number, and a JavaScript replay button. Visitors can independently re-run the entire draw in their browser and see a green ✓ Verified badge.

Team

Invite collaborators by email — they accept via link and can manage the campaign alongside you. Remove members at any time.

Analytics

Traffic sources, action completion rates, referral chains, and a 30-day growth chart.

Promote Your Giveaway

Link typeUse for
Public URLShare on social media, email, etc.
Embed URLiframe-only URL for embedding in any website
Leaderboard URLShareable public leaderboard
Rules URLShareable public rules page
Copy ShortcodeCopy [viraloo_campaign id="X"] directly

WordPress Integration

Step 1 — Get Your Sync Token

Find your token in any of these places:

  • Dashboard — the WordPress Sync Token card → click Copy Token
  • Campaign → Manage → Promote Your Giveaway
  • Settings → WordPress tab

If no token exists, click Generate Token on the dashboard card first.

Step 2 — Install the Plugin

  1. Click Download Plugin on your dashboard
  2. In WordPress: Plugins → Add New → Upload Plugin
  3. Upload the zip → Install NowActivate

Step 3 — Connect & Sync

  1. In WordPress go to Settings → Viraloo Campaigns
  2. Set Viraloo Site URL to https://viraloo.org
  3. Paste your Sync TokenSave Settings
  4. Click Sync Campaigns to fetch your giveaways
💡 After creating a new campaign in Viraloo, always click Sync Campaigns in the plugin to make it available in the block/TinyMCE pickers.

Step 4 — Embed a Campaign

Gutenberg block: Click + → search Viraloo → select Viraloo Campaign → pick campaign in sidebar → Publish.

Classic Editor (TinyMCE): Click ⚡ Campaign in the toolbar → select campaign in modal → double-click or click Insert Campaign.

Shortcode:

[viraloo_campaign id="25"]

Shortcode Parameters

ParameterDefaultDescription
idrequiredCampaign ID (from manage page URL or plugin table)
urlFull embed URL (alternative to id)
height650iframe height in pixels
themelightlight or dark
[viraloo_campaign id="25" theme="dark" height="700"]
[viraloo_campaign url="https://viraloo.org/campaign/25/embed"]

Social Proof Widget

Drop a tiny JavaScript snippet onto any website and live "Sarah from UK just joined" toast notifications will pop up showing recent entrants from your campaign. This is the same psychological mechanism Booking.com and Airbnb use — it consistently boosts signups 10–30%.

How to enable

  1. Open your campaign in Manage
  2. Scroll to Section 09 — Social Proof Widget
  3. Toggle Enable social proof widget on
  4. Copy the embed snippet shown below the toggle
  5. Paste it before </body> on any page where you want toasts to appear (your landing page, blog, WordPress site — anywhere)

The snippet looks like this:

<script src="https://viraloo.org/widget.js" data-campaign="25" async></script>

Toasts show the entrant's first name and country flag only — no email addresses or personal data are exposed. You can disable the widget at any time by toggling it off; the embed snippet on external sites will simply stop showing toasts.

Automatic Reminder Emails

Viraloo automatically emails every confirmed participant ~24 hours before your campaign ends, reminding them to refer friends and earn last-minute entries. This consistently drives a referral spike in the final day.

  • Runs automatically — nothing to configure
  • Honors unsubscribes and double opt-in status
  • Each participant receives the reminder at most once per campaign
  • The email includes their personal referral link and a call to share

Referrals

Every participant gets a unique referral link when they enter a campaign. Each valid referral earns the referrer extra entries. View your stats at Dashboard → Referrals.

Profile & Settings

Go to Settings (top nav) to update display name, email, password, notification preferences, connected ESP, and your WordPress Sync Token.

Billing

Go to Billing to view your current plan, upgrade or downgrade, and see past invoices.

Campaign Status Reference

StatusMeaning
ActiveLive — participants can enter
PausedTemporarily stopped — no new entries
EndedPast end date — entry closed, winners can be picked
DraftNot yet published
On this page
    Link copied