Stamped's unique integration with Klaviyo allows you to manage the entire review request process from Klaviyo, which drives great response rates. Follow this guide to learn more!
Key Notes
- This integration can help you send both email and SMS messages through Klaviyo.
- This integration is available for the Business, Professional, and Enterprise pricing plans.
In this Guide
- How it Works
- Customer Events & Properties
- Benefits
- Getting Started
- Connecting Stamped & Klaviyo
- Use Cases
- Setting Up Review Links Using Klaviyo
Introduction to Klaviyo/Stamped Reviews
Sending review requests and other review communications directly from Klaviyo helps in maintaining consistent branding, domain/sending authority, & more flexibility in their flow builder. Note that Klaviyo does not offer an embedded email form for review requests - if this is key to driving a higher conversion rate on your reviews, we recommend sending the email from Stamped still and using the Klaviyo integration to manage follow-ups.
Learn more about the integration in our blog post.
Head here for the Loyalty integration.
How it works
We send review data in the form of events to Klaviyo, which allows you to trigger actions that are based on those events. Each event has dynamic review information that you can use in your Klaviyo flows and emails or SMS messages.
While Klaviyo can send both email and SMS messages, a lot of brands may send emails through Klaviyo and SMS messages through another platform. If this is the case, you can send through both channels so that you're communicating with each customer in the way that they prefer. You can also use the integration for loyalty events, bringing all of your communications into one place.
Customer Properties & Events
Reviews Customer Properties
Property Name | Description | Trigger |
stamped_number_of_reviews | The total number of reviews that the customer has provided the merchant across all products. | Any new review |
stamped_last_review_score | The score, out of 5, that the customer gave on their last review of the merchant. | Any new review or review update |
stamped_last_review_date | The date of the customer’s last review within the Merchant’s store. | Any new review or review update |
stamped_last_review_sentiment_score | The sentiment of the last review, indicating detractor or promoter. | Any new review or review update |
stamped_last_date_sent | The date that the latest review request was sent to this customer. | Any review request sent |
stamped_number_of_nps | The amount of NPS surveys that the customer has taken over their lifetime of interactions with this merchant. | Any new NPS |
stamped_last_nps_score | The score, out of 10, that the customer gave on their last nps rating for this merchant. | Any new NPS or NPS update |
stamped_last_nps_date | The date of the customer’s last nps rating for this merchant. | Any new NPS or NPS update |
Review Events
Event | Description | Properties |
SubmittedReviewPositive | This event fires when a customer leaves a review 4 stars and above. | -reviewedRating -reviewedTitle -reviewedItem -reviewedURL -dateSentEmail |
SubmittedReviewNegative | This event fires when a customer leaves a review below 4 stars. | -reviewedRating -reviewedTitle -reviewedItem -reviewedURL -dateSentEmail |
SubmittedReview | This event fires when a customer leaves a review regardless of the star rating. | -reviewedRating -reviewedTitle -reviewedItem -reviewedURL -dateSentEmail |
SubmittedReviewVideo | This event fires when a customer leaves a video review regardless of the star rating. | -reviewedRating -reviewedTitle -reviewedItem -reviewedURL -dateSentEmail |
SubmittedReviewPhoto | This event fires when a customer leaves a photo review regardless of the star rating | -reviewedRating -reviewedTitle -reviewedItem -reviewedURL -dateSentEmail |
SubmittedNPS | This event fires when a customer leaves an NPS review. | -reviewedRating -reviewedTitle -reviewedItem -reviewedURL -dateSentEmail |
SubmittedQuestion | This event fires when a customer leaves a question. | -reviewedRating -reviewedTitle -reviewedItem -reviewedURL -dateSentEmail |
Benefits
Once you use Klaviyo's platform to perform these actions, you can leverage all of the features they offer; like A/B testing, suppression lists, conditional splits, customer segments, etc.
You also have a lot more customization in how you perform these actions and create follow-up flows that support the review request process in Stamped, Your email can be totally custom & on-brand, and a lot of brands appreciate being able to send an email or SMS as the message, add segmentation to the flow, or perhaps a reminder message some days later.
Getting Started
We recommend watching this two-part tutorial to learn how to connect Stamped and Klaviyo, and keep reading for more step-by-step instructions and use cases.
Connecting Stamped & Klaviyo
Head to your Klaviyo account to start the setup process.
- In Klaviyo Settings, find and copy the Public API Key / Site ID for Stamped:
https://www.klaviyo.com/account#api-keys-tab
Refer to their API guide and follow the instructions.
- Select Create Private API Key; under Access Type, select Full-Access Key
- Create a name for the key and click create
- Copy the Key to your clipboard and head to the Stamped dashboard under Settings > Apps > Klaviyo
- Paste the Site ID
-
Paste your Private API key
-
Click Save and Stamped is now connected!
Note - When a new review is received after the integration has been enabled, a "Custom Event" will be created in the Customer's Klaviyo profile.
Creating Segments
Once connected, you can create segments in Klaviyo to group customers according to their events. If you're using the integration to manage responses to positive and negative reviews, you would create two segments.
Here's how to create Segments in Klaviyo:
- In your Klaviyo Dashboard, navigate to Lists & Segments via the main menu:
- Click Create Segment
-
Select What someone has done (or not done) under the definition drop-down list, which filters for tracking events:
-
Search for Stamped's tracking events, which will be under the API category:
-
It's possible to define the criteria further by filtering for the properties within the tracking event. For example, the tracking event "SubmittedReviewPositive" will include all 4 and 5-star rating reviews by default. A filter for the property ReviewedRating can be added to only include 5-star reviews:
-
Fill up the rest of the details for the segment as required.
Use Cases
Here are a few examples of use cases for the Stamped & Klaviyo integration. Use any of the segment events to create your own unique campaigns, and share them with us so we can highlight them!
Positive Review Flow
Create a segment for customers who left a positive review, which can be used for email campaigns (reward/thank you emails):
Negative Review Flow
Create a segment for customers who left a negative review, which can be used for email campaigns:
Some other use cases:
- Sync customer's properties (e.g. age, height, waist, shoe size) from Stamped to the customer profile on Klaviyo
- Sync customer reviews & rewards events & properties to Klaviyo
- Add dynamic latest positive reviews in your email templates
- Sync unsubscribers from Klaviyo to Stamped
With Stamped's custom form feature, you can integrate the collected data into Klaviyo's customer profile, and make use of these data to set up segments/flows that can better target the customer groups for your marketing campaigns.
The image below illustrates how the custom form answers submitted by customers are pulled in as customer properties in Klaviyo using the segment feature:
Once the segment is set up, it can be used as part of a flow to target customers based on specific profiles. Here's a campaign created for customers who have submitted positive feedback for the custom form questions based on the example above, which invites them to be part of the brand's ambassador team:
Include Reviews in Email Templates
Reviews are only valuable if they are embedded in the right places. Your regular email communications to customers are a great place to leverage social proof. These work best in abandoned cart flows, sales, or cross-sell campaigns.
Setup for old Klaviyo email layout
- Create a new web feed in Klaviyo by navigating to Data Feeds > Add Web Feed
- Fill in the following fields:
Feed name
Name to identify the feed (to be used in Step #4 below)
Feed URL
Find the URL under Stamped's dashboard, Settings - Apps - Klaviyo Integration
You can further specify the reviews to retrieve from the feed by including the following parameters:
reviewIds=exampleID
Filter the feed based on the indicated review ID(s), and include multiple of the same parameter if you would like to filter multiple review ID(s):
E.g. reviewIds=123&reviewIds=456
productIds=exampleID
Filter the feed based on the indicated product ID(s), similarly include multiple of the same parameter if you would like to filter multiple product ID(s):
E.g. productIds=123&productIds=456
sortReviews=featured
Sort the feed to showcase featured reviews at the top
tags=exampleTag
Filter the feed based on reviews with the tag applied
Request Method
GET
Content Type
JSON
- Within Klaviyo's email template, create a table block with 1 column. Select "dynamic" under source.
- Under "Data Source", enter the following details into the fields:
Row Collectionfeeds.##feed_name_here##.data|slice:'3'
Note: ##feed_name_here## (including the hashes) needs to be replaced with the actual feed name entered in step #2 above
Row Alias
review -
Switch to the HTML editor for the column, and enter the following codes:
<p><span style="font-size:18px;color:#FFD700;">★★★★★</span><strong>{{ review.reviewTitle }}</strong><br />{{ review.reviewMessage }}<br/></p><br>
- Check the relevant data feed so that the reviews can be relayed into the template. This can only be activated:
- Save the template and you will see the top reviews populated in the table section. You will be able to preview the content when selecting the email template in your campaign setup:
Note: You can use these codes to surface the customer's photos if available, or any other details available within the review feed such as {{ review.productName }}, {{review.productImageUrl }}, etc.
Setup for new Klaviyo email layout
- Create a new web feed by navigating to Settings > Other > Web Feeds > Add web feed
- Fill in the following fields:
Feed name
Name to identify the feed (to be used in Step #4 below)
Feed URL
Find the URL under Stamped's dashboard, Settings - Apps - Klaviyo Integration
You can further specify the reviews to retrieve from the feed by including the following parameters:
reviewIds=exampleID
Filter the feed based on the indicated review ID(s), and include multiple of the same parameter if you would like to filter multiple review ID(s):
E.g. reviewIds=123&reviewIds=456
productIds=exampleID
Filter the feed based on the indicated product ID(s), similarly include multiple of the same parameter if you would like to filter multiple product ID(s):
E.g. productIds=123&productIds=456
sortReviews=featured
Sort the feed to showcase featured reviews at the top
tags=exampleTag
Filter the feed based on reviews with the tag applied
Request Method
GET
Content Type
JSON
- Within Klaviyo's email template, create a table block with 1 column. Select "dynamic" under source.
- Click Table Settings > Dynamic and under "Data Source", enter the following details into the fields:
Row Collectionfeeds.##feed_name_here##.data|slice:'3'
Note: ##feed_name_here## (including the hashes) needs to be replaced with the actual feed name entered in step #2 above
Row Alias
review
- Click "Content" and "Source Code", and enter the following codes:
<p><span style="font-size:18px;color:#FFD700;">★★★★★</span><strong>{{ review.reviewTitle }}</strong><br />{{ review.reviewMessage }}<br/></p><br>
- You can immediately preview the template and the review feed should be populated:
Setting Up Review Links Using Klaviyo
You can now send a review link using Klaviyo with the following guide:
Sending a Review Link Using Email Marketing Apps