Appearance
Quiz Types
Reference guide for different quiz types supported by the Attune API.
Overview
Attune supports several quiz types with different functionality, audience targeting, and distribution methods. This document explains the different quiz types and their use cases.
Quiz Types
Open Quizzes
The most common type of quiz, characterized by:
- Easy to create and distribute
- Allows collection of unidentified responses quickly
- Provides a universal link that can be distributed through any channel
- Can gather identified responses by combining with URL parameter data collection techniques
- Ideal for maximum reach and simple deployment
- Required properties:
anonymous = trueANDinapp = false
Custom Quizzes
The second most common quiz type, with the following features:
- Requires a CSV file with at least respondent IDs for creation
- Generates unique links for each individual respondent
- A good method for identifying responses
- Once created, new respondents cannot be added, making it an inflexible quiz type
- Required properties:
anonymous = falseANDdisableEmailing = true
Default Quizzes
Similar to Custom quizzes but with additional requirements:
- Requires respondent emails in addition to IDs
- Utilizes Attune's built-in email distribution system to deliver quiz links
- Manages the entire distribution process through the platform
- Once created, new respondents cannot be added, making it an inflexible quiz type
- Required properties:
anonymous = falseANDdisableEmailing = false
In-App Quizzes
The most versatile quiz type:
- Combines the flexibility of Open quizzes with enhanced identification methods
- Designed to be embedded within applications rather than standalone web experiences
- Provides a universal link that can be identified with a
sessionIdin URL parameters - Required properties:
anonymous = falseANDinapp = true
Property Defaults
If not explicitly set when creating a quiz, these properties default to the following values:
| Property | Default Value |
|---|---|
anonymous | true |
disableEmailing | true |
inapp | false |
By default, a new quiz will be created as an Open quiz unless these properties are modified.
Quiz Type Summary
This table outlines the required property settings for each quiz type. It shows how the combination of anonymous, inapp, and disableEmailing properties determines which type of quiz is created. Values marked as "any" are flexible, though some settings are recommended for optimal functionality.
| Quiz Type | anonymous | inapp | disableEmailing |
|---|---|---|---|
| Open | true | false | any, true preferred |
| Custom | false | false | true |
| Default | false | false | false |
| In-App | false | true | any, true preferred |
Choosing Between Quiz Types
| Quiz Type | User identification | Data retrieval by custom identifier | Implementation complexity | Best use case |
|---|---|---|---|---|
| Open Quiz | Generated anon_id | Not supported | Simpler | Public surveys, lead generation |
| InApp Quiz | Custom sessionId | Supported | Moderate-high, flexible | In-application assessments, user-specific content |
| Custom | Preloaded emails or names or IDs | Supported | Moderate, inflexible | Low lift Web UI pre-identifiation of respondents |
| Default | Preloaded emails AND IDs | Supported | Moderate, inflexible | Targeted automatic distribution for small organizations without distribution tools |
Notes
- Quiz type selection should be based on your distribution method and identification needs
- Each quiz type has specific Web UI workflows
- Default/Custom quizzes may use a different submission flow than the others
- Open and In-App quizzes are ideal for wide distribution, while Custom and Default quizzes provide more control with respondent tracking
- In-app quizzes are ideal for embedding
- Always set the required properties explicitly when creating quizzes to ensure the desired behavior