> For the complete documentation index, see [llms.txt](https://docs.qrbase.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qrbase.xyz/for-partners/scan-mode-campaign.md). # Scan Mode campaign *** A Scan Mode campaign builds on a token listing by adding a community-driven reveal mechanic. Collective puzzle activity progressively uncovers a hidden QR code, which eligible players can scan to claim a USDC prize once fully revealed. ### Campaign setup | Setting | Description | | --------------------- | -------------------------------------------------------------------------------------------------------- | | Reward pool | Total USDC allocated for the campaign, split between winners | | Number of winners | How many eligible players receive a share of the prize pool | | Campaign games | Target delivery volume — the number of puzzles that need to be generated to fully deliver the campaign | | Eligibility rules | Conditions players must meet to claim — token holding, puzzle solves, level requirement, task completion | | Promoted task or link | A task or external link featured in the campaign (e.g. follow a profile, visit a page) | | Rounds | After Round 1 ends, Round 2 begins with a fresh milestone cycle | #### **How delivery works** Scan Mode progress is based on delivered games, not wins. ``` 1 generated puzzle while the campaign is active = 1 consumed play from the campaign pack = 1 delivered campaign game ``` Progress is tracked as `delivered_games / target_games`. While a Scan Mode campaign is active, general puzzle packs on the same token pause automatically. They resume in FIFO order once the campaign ends. #### **Milestone schedule** Delivered games progressively unlock tiles of the hidden QR. The milestone schedule is set per campaign — exact thresholds depend on the project and campaign configuration. Once all 9 tiles are revealed, eligible players can scan the QR and claim from the prize pool. #### **Eligibility and claims** Campaign delivery and claim eligibility are tracked separately. Even after full delivery, players must meet all campaign conditions to claim: token holding requirements, puzzle solves, task completion, level threshold, and anti-cheat checks. Only users who meet all conditions can claim when the campaign opens. {% hint style="success" %} Scan Mode is the highest-engagement product in QRbase. It creates urgency, drives holding, and rewards your most committed community members. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.qrbase.xyz/for-partners/scan-mode-campaign.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.