Ratings & Reviews

In this article, we will look at:

• How to add a Rating & Reviews feed
• How to change what fields are displayed in Ratings & Reviews
• How to personalize how your Ratings & Reviews looks
• How to display your Ratings and Reviews board
• How to make Ratings and Reviews content rights approved
• How to swap the Ratings and Reviews form to a Form Builder Form 
• How to get a Verified Buyer Badge on a review
• How to edit the Verified Buyer Label on a review 
• How to add the Incentivized Review label on a review
• How to remove the Incentivized Review label on a review
• How to edit the Incentivized Review label on a review
• How to automatically trigger the Incentivized Review label on review via the acceptance box in the Form Builder form
• How to auto-tag content via a Form Build Submission

Collect, curate, moderate, and display conversion-driving Ratings and Reviews from your customers.  With Ratings & Reviews, you can generate a web embed code that you place on your products page and collect Ratings & Reviews which automatically go into your TINT board via a feed you set up. The Ratings and Reviews functionality has been upgraded! You can now create Ratings and Reviews forms using the more versatile Form Builder. Existing feeds that haven't been upgraded yet will continue to use the original Ratings and Review form. However, please note that you won't be able to create new Ratings and Reviews feeds using the older version of the form.

Note: if you are still using the original Ratings & Reviews form and haven't upgraded to the Form Builder Form yet, please click here or any information regarding how the old versions work and compatible options.

How to add a Ratings & Reviews feed

To add this feed to your TINT board, go to: 

1. Go into the TINT board that you would like to add the Rating and Review feed onto, navigate to the CONTENT panel, and then click the "Ratings and Review" icon
2. A pop-up window will appear in the right side of the screen
3. Click Select Form and you will have the option to pick an existing Form Builder Form or to add a new Form. Click here for more information on Form Builder. For Ratings and Reviews feed, you will have the options of either Product Review or blank forms created. 
   • 
4. Once, you have picked your form, you will see the following option
   • SELECT AUTHOR NAME - Choose the field that you want to map to the post’s author name
   • SELECT AUTHOR EMAIL - Choose the field that you want to map to the post’s author email
   • SELECT AUTHOR AVATAR - Choose the author avatar field
   • RATING - Choose the field that you want to map to the post’s rating
   • POST TITLE - Choose the field that you want to map to the post’s title
   • POST TEXT - Choose the field that you want to map to the post’s body content section
   • POST TAGS - Choose the field that you want to map to the post’s tags. This field will automatically tag the post with the chosen field
   • SELECT MEDIA - Choose the media field
5. All selections are optional except for either media or text – at least one of those needs to be set
6. To enable Moderation on the connection, keep "I would like to manually approve posts before they appear publicly on my TINT" selected but if you would like auto-moderation, untick this option
7. If you press cancel at any point on this screen, this will stop the upgrade from going through but once you have pressed Save, you are unable to revert this process

How to change what fields are displayed in Ratings & Reviews

If you want to change what fields are displayed on the form once the feed is active, you can edit this by going to:

1. Go to your Ratings & Review feed
2. Click on the cog
3. Click on Change Settings
4. On the right-hand side, the same pop-up box will appear
5. Untick or tick what you to want to remove or add-in
6. Click Save

How to personalize how your Ratings & Reviews looks

For Ratings and Reviews, we have created a new personalization option. 

To add the Ratings and Reviews personalization:

1. Go to personalizations via either the TINT board that you are on or the personalization button at the top of the list of TINT boards.
2. Click on the + Add button
3. Select Ratings and Reviews option
4. Click Create
5. This should open up a new personalization and the theme is called Table

If you have no ratings and reviews in your feed currently, you will still be able to design your look as you will see a default placeholder visualization on how it will look.

Newly added feeds get set up with the Form Builder Form so these forms can vary in looks.  Most users will want to choose the Product Review for their form.

The options that you can change currently:

• Background Colour and option to tick transparent 
• Font 
• Tick the option to show the author of the review

Also, you can use the Custom CSS to modify any elements you would like to change.

How to make Ratings and Reviews content rights approved

You will need to make sure that you add Rights Management Consent to your form. Otherwise, the content will come through without being rights requested and will not go into UGC Studio.

How to display your Ratings and Reviews board

Ratings and Reviews is a web embedded option.  You can retrieve the web embed code from your TINT board or from your Personalization.   For further instructions on how to do this, click here. 

How to swap the Ratings and Reviews form to a Form Builder Form 

If you have an existing Ratings and Reviews feed, you can now switch this to a Form Builder version of the form. 

Important information before swapping to a Form Builder Form

• Once you upgrade, you will not be able to revert back to the R&R version of the form
• Existing form submissions will be imported into the feed. If the form has been accumulating content over time, there will be a cap of 250 posts that get pulled into the feed
• The same form can be reused across multiple boards – in this case, posts will be the same on the boards that this form appears on
• This change currently does not work with our auto-generated tags. We will be releasing an update for this soon.  So if you want your content to auto-tag, do not swap to this yet

To do this:

1. Go to the Ratings and Reviews feed that you like to swap to a Form Builder Form
2. Click on the Settings cog
3. Click on Upgrade
4. A pop-up window will appear in the right side of the screen
5. Click Select Form and you will have the option to pick an existing Form Builder Form or to add a new Form. Note that you will only see Product review or blank forms. Click here for more information on Form Builder
6. Once, you have picked your form, you will see the following option
   • SELECT AUTHOR NAME - Choose the field that you want to map to the post’s author name
   • SELECT AUTHOR EMAIL - Choose the field that you want to map to the post’s author email
   • SELECT AUTHOR AVATAR - Choose the author avatar field
   • RATING - Choose the field that you want to map to the post’s rating
   • POST TITLE - Choose the field that you want to map to the post’s title
   • POST TEXT - Choose the field that you want to map to the post’s body content section. This field will automatically tag the post with the chosen field
   • POST TAGS - Choose the field that you want to map to the post’s tags
   • SELECT MEDIA - Choose the media field
7. All selections are optional except for either media or text – at least one of those needs to be set
8. To enable Moderation on the connection, keep "I would like to manually approve posts before they appear publicly on my TINT" selected but if you would like auto-moderation, untick this option
9. If you press cancel at any point on this screen, this will stop the upgrade from going through but once you have pressed Save, you are unable to revert this process

How to get a Verified Buyer Badge on a review

By default, all reviews will be marked as not verified but with our webhooks, you can let us know that a review is verified.  To set up the webhook in TINT:

1. Click on the account name in the right-hand corner
2. Click on Team Settings
3. Click on API
4. On the Webhooks section, click on + Add
5. Add the endpoint URL, Shared Shared, and Description if needed
6. Tick Post Created 
7. Click Apply to set up the webhook

You can also set up the webhook via the API. Click here for more information on how to do this. Depending on your setup, you will need to write code to verify the review information against your purchase records using the author’s email in the post and your tagged products. Once verified, you should make an API call to update our system.

How to edit the Verified Buyer Label on a review 

1. Go to the Personalization that is attached to the display
2. Click on Theme Settings
3. In VERIFIED BUYER LABEL, type in what you would like to see
4. Click Publish
5. This will change the wording to the chosen phrase

How to add the Incentivized Review label on a review

1. Go to the TINT board
2. Find the post that needs to be marked as Incentivized
3. Click on ...
4. Click on Mark on Incentivized
5. This will add the label to the review on the display

How to remove the Incentivized Review label on a review

1. Go to the TINT board
2. Find the post that needs to be unmarked as Incentivized
3. Click on ...
4. Click on Unmark on Incentivized
5. This will remove the label to the review on the display

 

How to edit the Incentivized Review label on a review

1. Go to the Personalization that is attached to the display
2. Click on Theme Settings
3. In INCENTIVIZED REVIEW LABEL, type in what you would like to see
4. Click Publish
5. This will change the wording to the chosen phrase

How to automatically trigger the Incentivized Review label on review via the acceptance box in the Form Builder form

1. Go to your Rating & Review form in Form Builder.  Create a form or edit an existing form
2. Add Element - Acceptance and customize - recommended to rename this element id to something more linked to the incentivized element
3. Click Publish to publish the changes
4. Go to the TINT boards
5. Add the Ratings and Review feed or click to change the settings
6. Under the section, INCENTIVIZED REVIEW, pick the element ID for the acceptance element
7. If a user ticks this acceptance element, the post coming to the TINT board will be automatically marked as an Incentivized Review

How to auto-tag content via a Form Build Submission

You can auto-tag a post when a user submits their form. To set this up, you will need to do the following two steps:

1. Add a Ratings & Review feed to your TINT board with the option Post Tag enabled. This will not work with Form Builder Feed as only Public Add a Post and R&R have the auto-tag option.
2. Add the element Hidden on the form and Publish. Take note of the Form Element ID as this is what you will use in the next part. To get this, click on the element. You can also add multiple Hidden elements but in this example, we will only be using one and the Form Element ID is hidden_0.
   
   
3. Now you will need to modify your form embed script. Either pull it from TINT or edit this if already embedded. To trigger the tagging element of the script, you will need to add: data-form-values="data-form-values="hidden_x=xxxxxx"

This is an example

<script async src="https://www.tintup.com/app/dist/tint.js"></script>
<div data-team-id="360919" 
data-form-values="hidden_0=test%20for%20article" 
data-form-id="1499"></div>

This will trigger my hidden_0 element to auto-tag with test for article tag when to any submission that comes in. You can also use the [] to auto-tag multiple tags. For example: data-form-values="hidden_0=test%20for%20article&hidden_1[]=tag1&hidden_2[]=tag2"

To see these tags on your posts in the Ratings and Review feed, you need to make sure that you set your Post Tag element the same as the hidden element that you have put in your form and embed.

As shown in my example, the tag test for article contains spaces. However, in code, spaces must be represented in a specific way, such as "test%20for%20article".  This is the same for other characters so to ensure your text is displayed and tagged correctly, you can use an encoder to convert it properly.  Click here for a tool to encode or decode. 

If you have any questions regarding Rating and Reviews, please don’t hesitate to contact Technical Support at support@tintup.com.