Every quiz records what shoppers do: when they start, which questions they see, what they answer, which results they get and which products they open. These events power quiz analytics, profiles, webhooks and your email integrations. This article shows how to get them into your own systems.
The events
| Collection | Recorded when |
|---|---|
AdvisorStartedEvents | A shopper opens a quiz. |
AdvisorQuestionOpenedEvents | A question is shown. |
AdvisorQuestionAnsweredEvents | A shopper answers a question, with the chosen answers. |
AdvisorResultViewedEvents | The results are shown, with the recommended products. |
AdvisorResultOpenedEvents | A shopper opens a recommended product. |
ConversionEvents | An order is tracked, with its totals and items. |
Events carry the quiz, the session and the visitor id, so you can follow one shopper through a quiz. The quiz and the bluebarry integrations write these events. Do not send them yourself.
Read events with the Data API
The collections are read-only OData endpoints under https://data.bluebarry.ai/data/. Authenticate with an API key and page through results with $top and $skip (up to 5,000 rows per page):
curl "https://data.bluebarry.ai/data/AdvisorResultViewedEvents?\$filter=createdDate ge 2026-09-01T00:00:00Z&\$orderby=createdDate&\$top=500" \
-H "Authorization: bb_your_api_key"The API docs link in the Developer area lists every field. Paging and filtering work the same as in read profiles via the API.
Other ways to get events
- Webhooks push answers, results, profile updates and submitted emails and phone numbers to your endpoint as they happen. See webhook payload reference.
- Google Analytics 4 receives quiz events through Google Tag Manager. See send quiz funnel data to GA4.
- Klaviyo and Omnisend receive quiz events for flows automatically once connected.
- AI assistants can summarize events for you through the MCP server. See MCP tool reference.