Fires when a visitor completes a quiz, product recommendation quiz, or assessment. This is a recommended custom event for tracking quiz funnels and product discovery flows.
Custom Event — This event is not automatically tracked. Fire it manually using the JavaScript SDK when a quiz is completed.
JavaScript
window._upstack('track', 'quiz_completed', {
quiz_id: 'skin-type-finder',
quiz_name: 'Find Your Perfect Skincare Routine',
result_id: 'oily-acne-prone',
result_name: 'Oily & Acne-Prone Skin',
questions_answered: 8,
time_to_complete: 145,
value: 25.00,
currency: 'USD'
});
window._upstack('track', 'quiz_completed', {
quiz_id: 'gift-finder',
quiz_name: 'Holiday Gift Finder',
result_id: 'tech-enthusiast',
recommended_products: ['SKU-1234', 'SKU-5678', 'SKU-9012'],
questions_answered: 5
});
Properties
| Property | Type | Required | Description |
|---|
| quiz_id | string | Yes | Unique identifier for the quiz |
| quiz_name | string | No | Human-readable quiz title |
| result_id | string | No | Identifier for the quiz result or outcome |
| result_name | string | No | Human-readable result description |
| questions_answered | number | No | Total questions completed |
| time_to_complete | number | No | Seconds from quiz start to completion |
| recommended_products | string[] | No | Array of product SKUs recommended by the quiz |
| value | number | No | Estimated value of the quiz completion |
| currency | string | No | ISO 4217 currency code |
When to Fire
- Product recommendation quiz completion
- Skin type or style finder completion
- Gift guide quiz completion
- Assessment or diagnostic quiz completion
- Personality quiz completion
Destination Support
| Destination | Support |
|---|
| Meta CAPI | Supported as Custom event type. Use for building audiences of quiz completers. |
| TikTok Events API | Supported. Use for audience building. |
| Klaviyo | Fully supported. Triggers flows based on quiz results for personalized follow-up. |
| GA4 | Supported. Maps to custom event with parameters. |
| Webhook | Fully supported. Raw payload forwarded. |
Personalization tip: Pass the result_id to Klaviyo to trigger personalized email flows based on quiz outcomes. Segment customers by their quiz results for targeted product recommendations.
