Set up a flow in Klaviyo's new editor to start sending review request emails to your customers.
Before you begin
If it isn't already, the Okendo and Klaviyo integration will need to be enabled in the Okendo admin - see here for instructions.
Okendo Review Request Metrics
The following events and properties are sent from Okendo to Klaviyo once integrated.
Eligible for Okendo Review Request
This event contains the list of products that are eligible to be reviewed within a customer's order (Product Title, Product Image URL and links to our Review capture form). This is sent from Okendo when an order has been fulfilled through the Forward to Klaviyo sequence.
An example of the payload:
Email Address: bob.mcgee@example.com
First Name: Bob
Last Name: Mcgee
Products: {u'Image Url': u'https://d3hw6dc1ow8pp2.cloudfront.net/emails/review/product-placeholder.png', u'Review Rating Urls': [{u'Url': u'#1', u'Stars': 1}, {u'Url': u'#2', u'Stars': 2}, {u'Url': u'#3', u'Stars': 3}, {u'Url': u'#4', u'Stars': 4}, {u'Url': u'#5', u'Stars': 5}], u'Name': u'Placeholder Product', u'Review Url': u'#'}, {u'Image Url': u'https://d3hw6dc1ow8pp2.cloudfront.net/emails/review/product-placeholder.png', u'Review Rating Urls': [{u'Url': u'#1', u'Stars': 1}, {u'Url': u'#2', u'Stars': 2}, {u'Url': u'#3', u'Stars': 3}, {u'Url': u'#4', u'Stars': 4}, {u'Url': u'#5', u'Stars': 5}], u'Name': u'Placeholder Product', u'Review Url': u'#'}
Review Request Id: d8d075f8-fd43-4b4b-abde-26e04d93b082
Ineligible for Okendo Review Request
This event is sent to indicate that an order is no longer eligible for a review request (the order was returned/refunded, for example).
Created Okendo Review
The Created Okendo Review metric/event is automatically sent to Klaviyo when a review is submitted. The metric contains all the data submitted in the review.
Note that you can set custom attributes for your product reviews within the Okendo app and these will appear in the payload as well.
Consider how these attributes may be useful for other flows or campaigns once captured.
Rating: 4,
Review Title: My New Favourite Product,
Review Body: I cannot believe how much I love this new product.,
Is Recommended: true,
Sentiment: positive,
Language Code: "en,
Source: write-review-button,
ProductID: 1885452822491,
Product Name: Small Cat Toy,
VariantID: 17387480307827,
Variant Name: Roller Coaster,
Sku: 888888,
Reviewer Display Name: Bob M.,
Reviewer Full Name: "Bob McGee,
Coupon Code: OKR-DISCOUNT-CODE,
Coupon Description: $5 off your next order,
Loyalty Events: OkendoLoyaltyEvent,
Loyalty Points: 100,
Loyalty Provider: LoyaltyLlama,
Image Count: 1,
Image Urls: https://i.imgur.com/PU37h8I.jpg
Video Count: 0,
Size Purchased: 4,
Body Shape: Hourglass,
Size Purchased: 12 / L
An example payload in Klaviyo:
Set up a review request email flow using Klaviyo's new editor
Open Klaviyo and create a new flow with the trigger "Eligible for Okendo Review Request" at least once since starting this flow, and the flow filter "Ineligible for Okendo Review Request" at least zero times since starting this flow. This trigger refers to an order being fulfilled and paid for in full (no refunds or cancellations).
2. Drag and drop a new email into the flow, and click configure.
3. Drag and drop a table block into the email.
4. Go to Table Settings > Dynamic > Data Source and fill out the Row Collection and Alias. These variables are case-sensitive and must be entered as below.
event.Products
product
If you would like to limit the number of products to show, configure it as below. Inputting 3 will limit the number of products showing to 3.
event.Products|slice:'3'
product
6. Scroll down below the data source and configure the columns as shown.
7. Go to Content > Dynamic Rows > and select the image. Add a dynamic image and insert the following URL:
{{ product|lookup:'Image Url' }}
From there, insert the following alt text, link address, and max width.
{{ product.name }}
{{ product|lookup:'Review Url' }}
8. Next, click on the text button in column 2 > source > insert the code. Click the source button again to save.
<div class="mj-column-px-350 outlook-group-fix" style="vertical-align: middle; display: inline-block; direction: ltr; font-size: 13px; text-align: left; width: 100%;">
<table style="vertical-align: middle;" role="presentation" border="0" width="100%" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td style="word-break: break-word; font-size: 0px; padding: 10px 25px;" align="left">
<div style="cursor: auto; color: rgb(29, 34, 54); font-family: 'Helvetica Neue', Arial, sans-serif; font-size: 16px; font-weight: bold; line-height: 22px; text-align: center;">{{product.Name}}</div>
</td>
</tr>
<tr>
<td style="word-break: break-word; font-size: 0px; padding: 10px 25px; padding-bottom: 0px;" align="left">
<div style="cursor: auto; color: rgb(84, 88, 102); font-family: 'Helvetica Neue', Arial, sans-serif; font-size: 16px; line-height: 22px; text-align: center;">How many stars?</div>
<p> </p>
</td>
</tr>
<tr>
<td style="word-break: break-word; font-size: 0px; padding: 10px 25px;" align="left">
<div style="cursor: auto; color: rgb(0, 0, 0); font-family: Ubuntu, Helvetica, Arial, sans-serif; font-size: 13px; line-height: normal; text-align: center;"><a aria-label="Vote 1 Star" href="{{product|lookup:'Review Rating Urls'|lookup:'0'|lookup:'Url'}}"><img style="border: none; outline: none; text-decoration: none;" src="https://d3hw6dc1ow8pp2.cloudfront.net/emails/review/star.png" alt="1 Star" width="30" height="28"></a> <a aria-label="Vote 2 Star" href="{{product|lookup:'Review Rating Urls'|lookup:'1'|lookup:'Url'}}"> <img style="border: none; outline: none; text-decoration: none;" src="https://d3hw6dc1ow8pp2.cloudfront.net/emails/review/star.png" alt="2 Star" width="30" height="28"></a> <a aria-label="Vote 3 Star" href="{{product|lookup:'Review Rating Urls'|lookup:'2'|lookup:'Url'}}"> <img style="border: none; outline: none; text-decoration: none;" src="https://d3hw6dc1ow8pp2.cloudfront.net/emails/review/star.png" alt="3 Star" width="30" height="28"></a> <a aria-label="Vote 4 Star" href="{{product|lookup:'Review Rating Urls'|lookup:'3'|lookup:'Url'}}"> <img style="border: none; outline: none; text-decoration: none;" src="https://d3hw6dc1ow8pp2.cloudfront.net/emails/review/star.png" alt="4 Star" width="30" height="28"></a> <a aria-label="Vote 5 Star" href="{{product|lookup:'Review Rating Urls'|lookup:'4'|lookup:'Url'}}"> <img style="border: none; outline: none; text-decoration: none;" src="https://d3hw6dc1ow8pp2.cloudfront.net/emails/review/star.png" alt="5 Star" width="30" height="28"></a></div>
</td>
</tr>
</tbody>
</table>
</div>
9. Lastly, preview the changes in the top right button.
Change Star Color
Our standard star color is hex 000000. To change the star color, locate “starHex” in the code block and update your hex value accordingly.
Change the hex code in the first line to the color of your choosing (starColor='000000').
Replace the code in Rows > Dynamic > Column 2 (select source) with the code from above.
⚠️ Note: Not all hex values have been generated. If you have broken star images:
Go to the Okendo app > Mail > Email Templates.
Click on Review Request (this is important as selecting other template types will generate different types of stars) and select any template.
Click on styling and override styling.
Change the Star Color to the same color as the value you set previously in the template and wait for the preview to take place (no need to save).
Star Color should match the starColor in your code
Card Background Color should match the backgroundColor in your code (backgroundColor='FFFFFF')
After a few seconds, preview the email to see the updated stars.
To change the text color, simply change the hex values in the second line of code.
Write a Review Button
To show an additional CTA for the response form, insert a button and configure it as below.
{{ event.Products.0|lookup:'Review Url' }}
Start the Forward to Klaviyo sequence
The final step is to set the Klaviyo email to live.
From there, go to the Okendo app > Mail > New Sequence > Klaviyo.
Configure the recruit date and time delay, and click Start.
