If you prefer, you can check out this information in video format.
Connect Lantern quiz completions to your Gameball loyalty program using Shopify Flow. This lets you automatically add points, reward a campaign, or adjust tiers when a customer completes a quiz.
Prerequisites
Shopify Flow installed and active on your store.
Gameball installed and configured. (Gameball’s Shopify Flow actions are available on paid plans; some actions may require higher tiers.)
A Lantern quiz published with an Opt‑in page that collects an email address.
In the quiz Results Page → Orders & Tags, enable Create customer in Shopify so Flow has a customer to act on.
Tip: Create the Gameball Flow activity before turning on your Shopify Flow.
1. Choose the Reward
1.1 This guide focuses on Add Points—the fastest way to reward a quiz completion.
1.2 Gameball also offers other Flow actions (not covered step‑by‑step here): Adjust Customer Tier, Reward a Campaign, Deduct Points, and Send an Event (plan‑dependent). Use the same trigger and email mapping shown below.
2. Create the Workflow in Shopify Flow
2.1 Open Shopify Flow and click Create workflow → Select a trigger.
2.2 In the editor, choose Lantern as the app.
2.3 Select the trigger Quiz Completed — with customers.
3. (Optional) Filter by Quiz
3.1 Add a Condition block to check the Quiz ID so points are only awarded for a specific quiz (recommended if you run multiple quizzes).
3.2 You can find the quiz ID under the quiz’s More Integrations tab.
4. Add a Delay (Recommended)
4.1 Click Add action → Flow → Wait.
4.2 Set the delay to 30–60 seconds. This gives Shopify time to create/propagate the new customer so Gameball can find them.
5. Add the Gameball Action
5.1 Click Add action → Gameball → Add Points.
5.2 Customer Email: click Add variable, then select email (string) from the Quiz Completed — with customers trigger.
5.3 Points to be added: enter the number of points (e.g., 50).
5.4 Reason: e.g., Completed Lantern quiz.
6. Turn On the Workflow
6.1 Click Turn on workflow to activate.
Notes & Tips
Use the with customers trigger so a Shopify customer exists and Gameball can locate the player via email.
If a new customer is created at quiz completion, insert a short Wait step (e.g., 30–60 seconds) before the Gameball action.
To avoid duplicate rewards, add a customer tag after rewarding (e.g.,
quiz-rewarded) and prevent repeats by placing a Condition near the start of the flow that exits when the customer already has this tag.
Advanced users can branch by quiz responses (using Flow conditions + Liquid) to award different points or campaigns per segment.
The Send an Event action is available on Guru plans if you want to push custom events (e.g.,
Quiz_Completed).
Quiz vs. Order-based Flows (Important)
For quiz completions, use Lantern → Quiz Completed — with customers and map Customer Email from the trigger. There is no order at quiz completion, so keep any order fields blank.
For purchase-based rewards (e.g., award after a paid order), build a separate Flow using Shopify’s Order paid (or similar) trigger and configure the Gameball action accordingly.
Troubleshooting
Gameball action not visible: Ensure your Gameball plan supports Shopify Flow actions; some actions require higher tiers.
Customer not found: Confirm the workflow uses Quiz Completed — with customers, the quiz creates a Shopify customer, and you mapped email (string) correctly. Add a short Wait 30–60s if the customer is brand-new.
Duplicate rewards: After rewarding, Add customer tag (e.g.,
quiz-rewarded) and at the top of the Flow add a guard condition: ifcustomer.tagscontainsquiz-points-awarded, stop.Campaign ID errors (for Reward a Campaign): Double-check the Campaign ID copied from Gameball.