Klaviyo & Stamped Reviews

  • Updated

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 on the Business, Professional, and Enterprise pricing plans

In this Guide

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

stamped_number_of_reviews The total number of reviews that the customer has provided the merchant across all products.
stamped_last_review_score The score, out of 5, that the customer gave on their last review of the merchant.
stamped_last_review_date The date of the customer’s last review within the Merchant’s store.
stamped_last_review_sentiment_score The sentiment of the last review, indicating detractor or promoter.
stamped_last_date_sent The date that the latest review request was sent to this customer.
stamped_number_of_nps The amount of NPS surveys that the customer has taken over their lifetime of interactions with this merchant.
stamped_last_nps_score The score, out of 10, that the customer gave on their last nps rating for this merchant.
stamped_last_nps_date The date of the customer’s last nps rating for this merchant.

 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.

  1. 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.

    KlaviyoReview1.png

  2. Select Create Private API Key; under Access Type, select Full-Access Key
  3. Create a name for the key and click create
  4. Copy the Key to your clipboard and head to the Stamped dashboard under Settings > Apps > Klaviyo
  5. Paste the Site ID
  6. Paste your Private API key

  7. 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:

  1. In your Klaviyo Dashboard, navigate to Lists & Segments via the main menu:

    KlaviyoReview3.png

  2. Click Create Segment

    KlaviyoReview4.png

  3. Select What someone has done (or not done) under the definition drop-down list, which filters for tracking events:
    KlaviyoReview5.png

  4. Search for Stamped's tracking events, which will be under the API category:
    KlaviyoReview6.png

  5. 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:
    KlaviyoReview7.png

  6. 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):

KlaviyoReview8.png

Negative Review Flow

Create a segment for customers who left a negative review, which can be used for email campaigns:

KlaviyoReview9.png

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:

KlaviyoReview10.jpg

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:

KlaviyoReview11.png


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. 

KlaviyoReview12.png

Setup for old Klaviyo email layout

    1. Create a new web feed in Klaviyo by navigating to Data Feeds > Add Web Feed

      KlaviyoReview13.png

    2. 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

      KlaviyoReview14.png

      Request Method
      GET

      Content Type
      JSON

      KlaviyoReview15.png

    3. Within Klaviyo's email template, create a table block with 1 column. Select "dynamic" under source.
    4. Under "Data Source", enter the following details into the fields:


      Row Collection
      feeds.##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

      KlaviyoReview16.png

       

    5. 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>
      	

      KlaviyoReview18.png

    6. Check the relevant data feed so that the reviews can be relayed into the template. This can only be activated:

      KlaviyoReview20.png
      KlaviyoReview21.png
    7. 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:

      KlaviyoReview23.pngNote: 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

  1. Create a new web feed by navigating to Settings > Other > Web Feeds > Add web feed


  2. 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

    KlaviyoReview14.png

    Request Method
    GET

    Content Type
    JSON

    KlaviyoReview15.png
  3. Within Klaviyo's email template, create a table block with 1 column. Select "dynamic" under source.
  4. Click Table Settings > Dynamic and under "Data Source", enter the following details into the fields:

    Row Collection
    feeds.##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

    KlaviyoReview16.png

  5. 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>
    	

    KlaviyoReview19.png

  6. You can immediately preview the template and the review feed should be populated:

    KlaviyoReview22.png


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

Was this article helpful?

0 out of 1 found this helpful

Have more questions? Submit a request