Fires when a visitor answers a question in a quiz or assessment. This is a recommended custom event for tracking quiz progress, identifying drop-off points, and analyzing answer patterns.
Custom Event — This event is not automatically tracked. Fire it manually using the JavaScript SDK after each question is answered.
JavaScript
window._upstack('track', 'quiz_question_answered', {
quiz_id: 'skin-type-finder',
question_id: 'q3_skin_concerns',
question_number: 3,
question_text: 'What are your primary skin concerns?',
answer_id: 'acne',
answer_text: 'Acne & Breakouts',
total_questions: 8
});
window._upstack('track', 'quiz_question_answered', {
quiz_id: 'gift-finder',
question_id: 'q2_interests',
question_number: 2,
question_text: 'What are their interests?',
answer_ids: ['tech', 'outdoors', 'cooking'],
answer_texts: ['Technology', 'Outdoors & Adventure', 'Cooking & Food'],
total_questions: 5
});
Properties
| Property | Type | Required | Description |
|---|
| quiz_id | string | Yes | Unique identifier for the quiz |
| question_id | string | Yes | Unique identifier for the question |
| question_number | number | No | Position of the question (1-indexed) |
| question_text | string | No | The question text displayed to the user |
| answer_id | string | No | Identifier for single-choice answer |
| answer_ids | string[] | No | Identifiers for multiple-choice answers |
| answer_text | string | No | Display text for single-choice answer |
| answer_texts | string[] | No | Display texts for multiple-choice answers |
| total_questions | number | No | Total number of questions in the quiz |
| time_on_question | number | No | Seconds spent on this question |
When to Fire
- After each quiz question is submitted
- When a user selects an answer (if auto-advancing)
- When moving to the next question in a multi-step quiz
Destination Support
| Destination | Support |
|---|
| Meta CAPI | Supported as Custom event type. Build audiences based on specific answer patterns. |
| TikTok Events API | Supported. Use for audience building. |
| Klaviyo | Fully supported. Track answer patterns for segmentation. |
| GA4 | Supported. Use for funnel analysis and drop-off tracking. |
| Webhook | Fully supported. Raw payload forwarded. |
Funnel analysis tip: Track question_number and total_questions to identify where users drop off. High drop-off on a specific question may indicate confusing wording or too many options.
