This page is a draft: its text is not final.
Author guide
For people who write quizzes and assessments in ARENA Studio. ARENA is in beta (2026-11-05). This guide describes only what the beta build does.
Before you start: read Getting started with ARENA. It covers the install, your first quiz, the support channel and how ARENA handles data. This guide goes further.
ARENA runs inside your CRM sub-account, and Studio calls the platform "CRM" throughout.
1. Open Studio
- Open ARENA from its page in your CRM sub-account.
- Wait while Studio shows Connecting to your CRM.
If you see Open ARENA from inside your CRM, you opened a saved link. Open ARENA from the sub-account instead. If you see ARENA is not installed for this location, ask an admin to install it.
Studio has four sections. Admins see all four. Other users see Quizzes.
| Section | What it holds | Who sees it |
|---|---|---|
| Quizzes | Your quizzes, and for each published quiz: live session, assignments and attempts | Admins and users |
| CRM sync | What is waiting to be written to your CRM, and the audit log | Admins |
| Settings | Provisioning and Theme | Admins |
| Data requests | Export or erase one participant's ARENA data | Admins |
Only an admin or the quiz's author can publish that quiz.
The Get started checklist
An admin sees Get started above the sections until an admin chooses Dismiss the checklist. It holds:
- Try the sample quiz. Choose Create the sample quiz. You get a three-question draft. Choose Open the sample quiz to edit it.
- Premium workflow actions. A note that ARENA's workflow steps may be premium, and that your CRM provider bills each run. See the workflows guide.
- Privacy. Links to the Privacy notice and the Data processing agreement.
- Audience age. Choose I confirm once you agree not to run quizzes for people under 13. Until then, your quiz pages say they are for people aged 16 or over.
Users who are not admins see Setup is not finished, ask an admin while setup is not done.
2. Create a quiz
- Open Quizzes.
- Choose New quiz.
- Type a Quiz title. Studio will not save without one.
- Choose Save draft.
After the first save, every change saves itself within about two seconds. The line under the editor tells you the state: Saving…, All changes saved., or a note that your changes are kept on this device and ARENA will try again.
If someone else saves the same quiz at the same time, Studio shows a note with the time. Your changes are saved, and the other version is kept as an earlier version. Choose Dismiss to carry on.
If you close the editor with unsaved changes, Studio asks first. Choose Stay or Leave.
Choose the modes
- Open Quiz settings.
- Under Modes and capture, tick what the quiz is for:
- Live sessions: you host it live from Studio, for a webinar, a course session, a meeting or a training. See the host guide.
- Self-paced assessment: the same quiz also works as a personal link you send to a contact, or a public link.
- Scored funnel: a lead quiz on a funnel page.
You must tick at least one.
3. Write questions
Each question has a Question text. Pick a Question type:
| Type in Studio | Use it when |
|---|---|
| Single choice | One answer is right. Give 2 to 6 answers and mark the Correct answer. |
| Multiple choice | More than one answer is right. Mark each correct one. |
| True or false | A statement. Choose True or False for The statement is. |
| Type the answer | The player types it. Add each Accepted answer you will take. Tick Ignore accents to accept "cafe" for "café". |
| Number | The answer is a number. Set the Expected value and a Tolerance, Plus or minus or Percent. |
| Opinion poll | You want opinions. It has no correct answer and scores nothing. |
For each question you can also set:
- Time limit: 5, 10, 20, 30, 60, 90 or 120 seconds, or Quiz default.
- Points: Standard, Double or No points.
- Explanation: your note on why the answer is right.
Use Add question and Remove question. To reorder, drag a question by its handle, or use Move question {n} up and Move question {n} down. With the keyboard, press Alt plus Up or Down. Press Ctrl or Cmd plus S to save now.
Fix problems before you publish
Studio marks each problem on the question, for example Mark exactly one answer correct. or Give 2 to 6 answers. Publishing waits until every marked problem is fixed. A timed scoring mode also needs a time limit on every question, or a quiz default.
4. Scoring and rules
In Quiz settings, under Scoring, choose a Scoring mode:
| Mode | In plain words |
|---|---|
| Speed | A right answer scores more the faster it comes, down to half the points. |
| Accuracy | A right answer scores the same however fast it comes. |
| Linear decay | The score falls in a straight line as time runs out, to a small minimum. |
| Exponential decay | The score falls fast at first, then slowly. |
| Negative marking | A wrong answer costs points. |
Then set:
- Streak bonus: a bonus for answers right in a row.
- Partial credit for multiple choice: some points for a partly right answer.
- Pass mark (percent): 0 to 100.
- Retakes: No retakes, Limited (then Retakes allowed) or Unlimited.
- Attempt that counts: Best, Latest or First.
No timer under Timing removes the countdown. Speed and decay modes then score as accuracy.
A change to scoring or timing applies to new attempts. Attempts already started keep the settings of their version.
5. Outcomes and capture
Mastery tiers
When a contact finishes a quiz, ARENA gives the contact one tier tag from their score:
| Score | Tag |
|---|---|
| 80 percent or more | arena:tier:mastered |
| 50 percent or more | arena:tier:developing |
| Below 50 percent | arena:tier:needs-support |
ARENA removes the other two tier tags at the same time. These cut-offs are the same for every quiz. Use the tags in your workflows: a Contact Tag trigger on arena:played or a tier tag needs no premium step. ARENA's workflow steps are an option. See the workflows guide.
Ask for name and email
Under Modes and capture, Ask for name and email has three choices: Required, Optional and Off. The player sees Save your result with an email box and a consent tick box. The player sees the result either way.
ARENA saves a name and email only if the player ticks the box. Turn it Off and visitors to a scored funnel stay anonymous. Then ARENA has no contact to tag or write fields on.
The result page
You can set Call to action label and Call to action link (https). The player sees them as a link on the result page. Tick Show per-question feedback on the result page to show each question's result.
6. Publish and share
- Choose Publish. Studio shows Published.
- Copy the Public link or the Embed code.
Every publish makes a new version, so an attempt always matches the questions it was asked. To change a published quiz, edit it and publish again.
Embed in a funnel page
Paste the Embed code into a Custom Code element on your CRM funnel page. It is an iframe that fills the width of the element.
Send a personal link
A personal link opens the quiz as one contact, so they do not type their name again. It works for 7 days.
Under Assign this quiz (it appears once the quiz is published), choose one of these:
- Assign to this contact: type one Contact ID.
- Assign to this tag: type a Contact tag. Contacts who already carry the tag are assigned in the background, one batch a minute. A tag cannot start with
arena:.
For each contact, ARENA writes the link to the contact field arena_assessment_link, then adds the tag arena:assessment-assigned. ARENA sends nothing. Your own CRM workflow sends the email or SMS. The workflows guide explains it. This tag route has no workflow-step fee; ARENA's Send a quiz step is the premium option there.
The Contacts assigned list shows each contact's status: Waiting to write the link, Writing the link, Link written and tag added, Failed or Held. Choose Retry on a failed one.
Contacts tagged after you set the rule are assigned when ARENA hears of the new tag from your CRM. If a newly tagged contact is not assigned, assign them by Contact ID.
If a contact opens a link after 7 days, they can ask for a new one from the page. ARENA writes a fresh link and adds the tag again, so your workflow sends it.
7. Read results
Open a published quiz. Attempts lists the 50 most recent. Each row shows Who, Score, Result (Passed or Failed), Time taken, Completed and CRM sync. Anonymous players show as Anonymous.
What lands on the contact
For a player ARENA can identify (by name and email, or by personal link), ARENA writes to the contact:
| Field | Holds |
|---|---|
arena_last_quiz_title | The last quiz played |
arena_last_score_pct | The last score, in percent |
arena_last_passed | true or false |
arena_last_played_at | When they last played |
arena_total_attempts | How many attempts |
arena_best_score_pct | The best score |
arena_avg_score_pct | The average score |
arena_mastery_tier | mastered, developing or needs-support |
arena_assessment_link | Their personal link. ARENA writes it when you assign a quiz. |
ARENA also adds the tag arena:played, the tier tag, and a note on the contact's timeline. ARENA owns these fields, so a manual edit is overwritten by the next result.
The CRM sync queue
CRM sync (admins) shows Waiting to sync, Oldest waiting and Need attention. A job that needs attention lists its steps (Contact, Fields, Tags added, Tags removed) and the Error. Choose Retry to queue it again. The Audit log lists every write ARENA made to your CRM.
8. Settings for admins
Settings > Provisioning lists ARENA's set-up steps, Contact fields and Tags, each Done, Waiting, Failed or Running. When all are done it says Every provisioning step is done. If a step failed, choose Repair. Repair runs the failed and waiting steps again and leaves finished ones alone.
Settings > Theme sets the colours, fonts and corner radius players see. A value left empty comes from your brand, then from the ARENA default. Studio checks colour contrast and offers adjusted colours.
Data requests: choose how to find the participant (Email or CRM contact id), then Export or Erase. Erase asks you to type ERASE. It removes access at once and cannot be undone. The list shows each request's progress and its 30-day deadline.
9. Troubleshooting
| You see | What to do |
|---|---|
| Open ARENA from inside your CRM | Open ARENA from its page in your sub-account. |
| ARENA lost its connection to your CRM | An admin reinstalls ARENA from the marketplace. |
| Open ARENA inside a location to work with quizzes. | You are at agency level. Switch into a sub-account. |
| A score is not on the contact yet | Open CRM sync. A waiting job will finish. A job under Need attention needs Retry. |
| Publishing is blocked until every issue marked below is fixed. | Fix each marked problem in the questions and settings. |
| A contact's link has expired | They choose Request a new link on the page. Or assign the quiz again. |
10. Get help
Every Studio page ends with Pilot support: and a link, open the support channel. Reply time: we reply within 1 business day. Support hours: Monday to Friday, 10:00 to 18:00 IST. Email: support@brandbeat7.com.
When you report a problem, give the time, the Studio page and what you expected. Never send a player's name, email or contact id.