Yotpo Integration

read
Last updated at:

Overview

Yotpo is a user-generated content partner that allows you to collect and publish reviews, photos, and Q&A that can be used to identify segments and enrich marketing emails. Yotpo built and supports the Yotpo+Klaviyo integration, which imports Yotpo data directly into Klaviyo. Once your Yotpo data is synced, embed your best customer reviews and feedback into your campaigns. You can also create specialized segments based on Yotpo customer data.

This guide will walk you through integrating Yotpo with Klaviyo. First, we'll enable the integration, configure your first set of review highlights, and display those in a Klaviyo campaign.

At this time, Yotpo reviews can only be featured in campaign emails, and cannot yet be displayed in flow emails.

After your initial campaign with highlighted reviews, you'll follow a slightly different set of instructions to create additional Yotpo data feeds and embed them in other email campaigns.

Finally, you'll get a deeper look into how Yotpo data looks in your Klaviyo account and run through some examples of how businesses use Yotpo with Klaviyo.

Connect Yotpo with Klaviyo

First, you'll need to generate a private API key in Klaviyo. Log into your Klaviyo account. Then, click your Account Name in the upper right and choose Account. From the Settings dropdown, choose API Keys.

API_Key_1_blurred.gif

Select Create API Key. You can label the API key for clarity.

API_Key_2_blurred.gif

Copy the API key and head over to Yotpo. In your Yotpo account, navigate to Integrations. Then, select Klaviyo.
Yotpo1.png

Paste your API key into the Klaviyo private API key field and click Connect.
Yotpo2.png
Yotpo is now connected to Klaviyo.

First Sync: Configure Review Highlights

Once your Yotpo and Klaviyo accounts are connected, you can choose what reviews you'd like to highlight in your Klaviyo account. The first time you create a data feed, you'll choose up to 10 Yotpo topics, and then up to 10 Yotpo products.

  • If you want to create review highlights for a single product, select just one product.
  • If you want to create review highlights for multiple products, select several products.
    You'll be able to configure review data feeds later for one or many products as well.

When you select topics, Yotpo will feature reviews related to those topics such as "Smell" and "Color." When you also select products, Yotpo will feature reviews reflecting a combination of topics and products. For example, the product choice "Faded T-Shirt" combined with the topic "Color" will result in reviews for "Faded T-Shirt" that mention "Color."

In Yotpo, within Review Highlights, select up to 10 topics. Next, choose up to 10 products. If you wish to feature reviews for only one product, select just one product.
89f6f1a9-d885-444b-90b2-96e7b447930a.gif

If you select one or more products with limited review content, highlights from related products may be displayed instead.

First Sync: Add Review Highlights to a Campaign

In this section, you'll learn how to add review highlights into a campaign email for the first time. Instructions on embedding a Yotpo data feed will be slightly different subsequent times. We'll cover that later in this article.

Configure a Yotpo Data Feed

You'll need your Yotpo API key to configure a data feed within Klaviyo.

Within Yotpo, click the icon on the upper right and choose Account Settings. Then, choose Store. Your Yotpo API key will be located towards the bottom of this screen. Leave the screen open for later use, and head over to Klaviyo.
YotpoAPIKey.gif

In Klaviyo, select Data Feeds. Then choose Add Web Feed.
Yotpo4.png

Enter a unique feed name. You can use alphanumeric characters and underscores, but make sure there are no spaces within the feed name. Keep this name handy, as you'll need it shortly.
Yotpo5.png
In the Feed URL field, you'll combine a URL and your Yotpo API key.

Copy the following URL and paste it into the Feed URL field.
https://email-integrations.yotpo.com/v1/:app_key/klaviyo/reviews_highlights.json

Yotpo7.png

Switch over to Yotpo and copy your API Key.
Yotpo6.png

Head back over to Klaviyo. In the Feed URL field, replace the :app_key placeholder with your Yotpo API key. After the replacement, your URL will look something like this:
Yotpo8.png

Select GET as the Request Method, and JSON for the Content Type. Then click Add Data Feed.
Yotpo9.png

Once you create your data feed, view its contents by selecting Preview on the upper right of the screen.
Yotpo11.png
This is what a data feed preview looks like:
Yotpo12.png

Insert Data Feed into a Campaign Email

In Klaviyo, navigate to Campaigns. Select an existing campaign or create a campaign to edit.

For a new campaign, once you've named and configured the campaign email, click Create Content.
For an existing campaign, click Edit Content.
Yotpo13.jpg

Add a text block to your campaign, or click to edit an existing text block.
Yotpo14.jpg

Head back over to Yotpo to Integrations > Klaviyo. Copy the widget code at the bottom of the page. The code snippet displays three reviews by default. You have the choice to Show grouped highlights or to Show highlights separately. Click Copy Code for your desired format.
YotpoShowHighlights.gif

If you choose to show highlights separately, the code snippet for each separate review can be pasted and positioned into your desired location with the email.

Switch back to Klaviyo, and select Source. Paste the code snippet into the text editor.
Yotpo15.gif
In line one of the snippet, replace #feedname# with the exact name of the feed you wish to display, and Save the code modification.
Yotpo16.jpg
Yotpo9b.png
This is an example of modified code in the text editor:
{% with feed=feeds.YotpoFeed1 %}

This is how the feed will look in the text block of your email:
Yotpo17.jpg

Select Data Feeds at the bottom of your email editor.
Yotpo18.jpg

Select the data feed you want to use and click Save. You're ready to send the campaign.
Yotpo19.jpg
Use Klaviyo's Live Preview option to view the product reviews.Yotpo20.png

Add Review Highlights to Additional Campaigns

Once you've set up and launched your first Klaviyo campaign featuring Yotpo's review highlights, you can create additional data feeds that can be used in campaigns, flows, or reusable text blocks. Each new data feed should have a unique name.

Create a New Data Feed

We'll start by grabbing your Yotpo API key.

In Yotpo, click the icon on the upper right of your Yotpo screen and choose Account Settings. Then choose Store. Copy your Yotpo API key, which is located toward the bottom of this screen.
YotpoAPIKey.gif

Head back over to Klaviyo and select Data Feeds. Then choose Add Web Feed.
Yotpo4.png
Enter a unique feed name. This name should be different from any existing data feed(s). You can use alphanumeric characters and underscores, but do not include spaces within the feed name. Keep this name handy, as you'll need it shortly.
Yotpo6a.png
In the Feed URL field, you'll combine several elements, including your Yotpo API key and data feed parameters.

Copy the following URL and paste it into the Feed URL field.
https://email-integrations.yotpo.com/v1/:app_key/klaviyo/reviews_highlights.json

Replace the :app_key placeholder with your Yotpo API key. After pasting your Yotpo API key, your URL will look something like this:
Yotpo7a.png

Now, we'll add review parameters to the end of the URL.

  • To display review highlights for specific topics, add the following URL parameter(s) to your data feed URL:

    Topics are defined in your Yotpo account. Head over to the Yotpo Help Center to read about identifying topics.

    1. Single topic (price): ?topics[]=price
    2. Multiple topics (price, quality, color): ?topics[]=price&topics[]=quality&topics[]=color

  • To display review highlights for certain products, add the following URL parameters to your data feed URL:

    Product IDs are defined in your ecommerce account. For more information on finding product ID in your ecommerce platform, head over to this article on the Yotpo Help Center.

    1. Single product: ?product_ids[]=#product_id_value#
    2. Multiple products (up to 10):
      ?product_ids[]=#product_id_value#&product_ids[]=#product_id_value#
    3. Each additional product should be added with an ampersand (&)
    4. For example, the following string includes seven different products:
      ?product_ids[]=123456&product_ids[]=54321&product_ids[]=7896&product_ids[]=45325&product_ids[]=76567&product_ids[]=39576&product_ids[]=4567435

A complete data feed URL with topics and products defined should look something like this:
https://email-integrations.yotpo.com/v1/##Your_App_Key##/klaviyo/reviews_highlights?topics[]=price&topics[]=quality&topics[]=color&product_ids[]=15432&product_ids[]=67345&product_ids[]=344243&product_ids[]=3453&product_ids[]=5676&product_ids[]=64523&product_ids[]=745345

Once you've queried the relevant topics and/or product ID's, copy and paste the complete data feed into Feed URL. Select GET as the Request Method, and JSON for the Content Type. Then click Add Data Feed.

Yotpo8a.png

Once your data feed is created, view your data feed by selecting Preview on the upper right of the screen.
Yotpo9a.png
This is an example of what a data feed looks like:

Yotpo10a.png

Your new data feed can now be inserted into campaign emails.

Add Review Highlights to Campaign Emails

Once you've configured new data feed(s), you'll need to embed the data feeds into your Klaviyo email template.

In Yotpo, navigate to Integrations > Klaviyo. Click Copy Code in the Widget Code section at the bottom of the page.
816581ee-4f79-41a9-9653-8e7d12087831.gif

  • Show grouped highlights displays review highlights as a single block of three highlights and copies the bulk snippets code.
  • Show highlights individually displays review highlights as individual entries and copies one of the highlights. You'll need to copy/paste each highlight separately to insert them in your Klaviyo email.
  • Star color modifies the star color within your reviews. For example, a five-star rating will appear with five blue stars.

Switch back to Klaviyo, and navigate to Campaigns. Select an existing campaign or create a new campaign.

For a new campaign, once you've named and configured the campaign email, click Create Content. For an existing campaign, click Edit Content.
Yotpo3a.png

Drag in a new text block, or click to edit an existing text block. Select Source.
Yotpo4a.gif

You can insert a data feed into any block format, which contains a text section such as a Split Block or Table Block. Embedding a data feed into an alternate block format gives you the flexibility to format your reviews creatively.

Paste the code into the text editor.
Yotpo14a.png

In the first line of the snippet, replace #feedname# with the exact name of the feed you wish to display, and Save the code modification.

This is an example of modified code in the text editor:
{% with feed=feeds.MothersDay %}

If you choose to display highlights separately, update the feed name of each snippet.

Below is an example of how the feed will look in the text block of your email.
Yotpo13a.png

Click Data Feeds at the bottom of the email editor.
Yotpo15a.png

Select the data feed to use and click Save. If you are embedding multiple data feeds, select all of them and click Save. You're ready to send the campaign.
Yotpo16a.png

Use Klaviyo's Live Preview option to view the product reviews.
Yotpo17a.png

Head over to Add a Custom Web Feed to a Campaign for more info.

Data Synced to Klaviyo

When Yotpo syncs to Klaviyo, mutual contacts are updated with reviews data including:

  • Latest review score
  • Number of reviews
  • Custom question responses

This data can be used in Klaviyo to segment profiles in your account and create targeted campaigns in response to review scores, total number of reviews, and responses to custom questions.

Since Yotpo built the integration, contact Yotpo Support for a complete list of Yotpo attributes sent into Klaviyo.

Review data is attached to Klaviyo profiles in the form of custom properties.

This is what a profile with synced Yotpo data looks like:
YotpoProfile.png

Each Yotpo attribute can be used to segment groups of customers so that you can then send them highly customized content. The next section features specific use cases that demonstrate how businesses use Yotpo data in Klaviyo.

How to Use Yotpo Data in Klaviyo

Take a look at Yotpo's use case scenarios to learn more about how to use Yotpo with Klaviyo.

Segment Customers with Yotpo Data

Create segments using review scores and custom forms data such as age, service satisfaction, or any custom property you capture though Yotpo.

This is an example of how to segment customers by age group. Customers are asked to fill out a Yotpo review which includes the selection of an age group: 18-24, 25-34, 35-44, 45-54, 55-64,  64+. The age group custom property is yotpo_age; this segment isolates the 55-64 age group:

YotpoExample3.png

Create campaigns geared toward each respective age segment.

Trigger Flows Based on Yotpo Review Scores

When a customer submits a positive review, trigger a "Review Thank You" flow and send them an email thanking them. The attribute that triggers the flow is yotpo_latest_review_score.

This segment identifies customers who submit a five-star review on Yotpo:
YotpoExample1.png

This flow is triggered when someone is added to the segment Yotpo Review Score 5+:
Yotpo_Example2.png

Similarly, when a customer submits a negative review (one or two stars), it can trigger an "apology" flow, which sends a coupon to the customer to make up for the negative experience.

Feature Yotpo Reviews in Klaviyo Campaigns

This article features detailed instructions on how to embed Yotpo reviews in campaigns. Here are some examples of campaigns that work well with product reviews:

  • Target customers who leave four-five star reviews with campaigns featuring related products and complimentary reviews.
  • Target VIP customers with campaigns featuring products with good reviews.
  • Create brand ambassadors by sending campaigns to engaged customers with positive brand reviews.
  • Send campaigns to specific customer tiers, such as lapsed-enthusiasts, reminding them that your products are excellent, as demonstrated by a collection of excellent product reviews.
x
Was this article helpful?
4 out of 7 found this helpful