quiz_completed Event

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'
});

Quiz with product recommendations:

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.

quiz_question_answered — Track individual question responses
lead — For capturing contact info during or after quiz
view_content — When quiz results include product views

Quiz Events quiz_question_answered

⌘I

SDK

PIXEL EVENTS

IDENTITY

AUTOMATIC TRACKING

JavaScript

Properties

When to Fire

Destination Support

​JavaScript

​Properties

​When to Fire

​Destination Support

​Related Events

JavaScript

Properties

When to Fire

Destination Support

Related Events