With our Klaviyo integration, Grapevine will send details of new survey responses which can be used to create workflows and automations. This article will detail the various survey events that are sent.
The Klaviyo integration will need to be enabled. Please see the following article for details on how to set that up: How to enable the Klaviyo integration
Target Klaviyo profiles:
As long as there is an email associated with a survey response, we can push survey events into Klaviyo.
Events will be pushed into an existing Klaviyo profile associated with that email address, or if no profile exists, then a new profile will be created.
Survey events:
There are currently three types of survey events we send to Klaviyo:
- survey response
- survey response question answered
- survey response completed
The events and their parameters are detailed below:
Survey Response event
The survey response event is sent when a survey's Next or Submit button is first clicked. Only one instance of this event will be sent even in the case of multiple questions. It is, essentially, a 'Survey started' event:
Survey Type: All surveys created after January 10th 2024 will be of type multi_question, even if they have just a single question. Surveys created before this date will have used an old architecture and will be single question surveys with their survey type being Fixed Response, NPS, or Open Text.
Survey Code: This is a survey's unique identifier. It can be used within Klaviyo Flows as a trigger or filter.
External Id: A URL parameter ?external_id=something can be included within a Standalone survey URL link. It is useful if you would like to use an identifier from another system such as a profile id from a CRM system.
https://mystore.myshopify.com/tools/survey/663ca1c54e08b?external_id=CUST_3748
Survey Response Question Answered event
The survey response question answered event is sent when either a Next button on an Order Status Page survey, or the Submit button of Standalone Page survey has been clicked:
Question Code: This is a survey question's unique identifier. It can be used within Klaviyo Flows as a trigger or filter.
Answer: If an un-required question goes unanswered, it will still trigger a survey response question answered event. However, the Answer value will be null:
Is Other: A value of Yes will signify that the Global Other option has been used for the response:
Score: The response score from an NPS survey question:
Cohort: A value of promoter, passive or detractor based on the NPS response score. A very useful metric when used to create Flows and Segments within Klaviyo:
Survey Response Completed Event
The survey response completed event is sent when a survey's final Submit button has been clicked. If the survey includes non-required questions that go unanswered, this event is still sent as the respondent has followed the survey through till the end:
Multi question surveys
When a survey has more than one question, events may come through to Klaviyo between 1 and 5 minutes apart. This short delay prevents events being overwritten by each other when delivered to Klaviyo with the same timestamp.
Please Note:
Due to this short delay, the order in which the events arrive may not be the order in which they were performed.
Please see the article linked below for examples on how to use these events within your Klaviyo flows: