When customers leave star ratings and reviews for your products, it’s essential to display them prominently on your website. This social proof can help boost conversions and build trust with potential customers. However, simply displaying the average star rating isn’t enough. You need to show the individual ratings and reviews so that customers can see the full picture.
There are a few different ways to display star ratings and reviews. One common method is to use a star rating widget. This widget typically displays the average star rating, as well as the number of reviews that have been left. Customers can then click on the stars to see the individual ratings and reviews. Another option is to use a review carousel. This carousel displays a rotating selection of reviews, along with the star ratings. Customers can click on the arrows to navigate through the reviews.
No matter which method you choose, it’s important to make sure that the star ratings and reviews are easy to find and read. They should be prominently displayed on your product pages, and they should be formatted in a way that makes them easy to skim. By following these tips, you can make sure that your star ratings and reviews are working hard to boost your conversions.
Enabling Custom GPTs
To facilitate the display of star rating reviews, it’s necessary to enable Custom GPTs (Global Product Targeting). This allows you to target specific reviews based on custom criteria, ensuring that the displayed reviews are relevant to your store and products.
To enable Custom GPTs, follow these steps:
- Log in to your Google Merchant Center account.
- Select the “Products” tab.
- Click on the “Reviews” tab.
- Check the box for “Enable Custom GPTs”.
- Click on the “Save” button.
Once you have enabled Custom GPTs, you can create custom rules to target specific reviews. For example, you can create a rule to only display reviews for products that have a star rating of 4 or higher.
| Rule | Description |
|---|---|
| Product rating is equal to or greater than 4 stars | Only displays reviews for products with a star rating of 4 or higher. |
| Product category is “Clothing” | Only displays reviews for products in the “Clothing” category. |
| Review author is “John Doe” | Only displays reviews written by “John Doe”. |
Retrieving Star Rating Reviews
GPT-3 requests can be configured to retrieve star rating reviews for custom prompts using the rating parameter. This parameter takes a value between 1 and 5, where 1 represents the lowest rating and 5 represents the highest rating. The following example demonstrates how to retrieve a star rating review for a custom prompt:
“`
{
“prompt”: {
“text”: “Write a star rating review for the following product: [product description]”,
“rating”: 5
}
}
“`
This request will return a response in the following format:
“`
{
“candidates”: [
{
“output”: “The product is great! I would definitely recommend it to others.”
}
]
}
“`
The output field in the response contains the star rating review generated by GPT-3. The review will be based on the prompt provided and the specified rating.
Additional Notes
- The rating parameter is optional. If it is not specified, GPT-3 will generate a star rating review without any bias towards a particular rating.
- The star rating review generated by GPT-3 will be in the form of a natural language response. The length and complexity of the review will vary depending on the prompt provided.
- GPT-3 can also generate star rating reviews for multiple products or services in a single request. To do this, simply provide multiple prompts with different rating values in the request.
Handling Conditional Display
Conditional display options allow you to control the circumstances under which your star rating reviews are displayed. You can set conditions based on the following criteria:
Display Reviews Based on User Type
You can choose to display reviews only for specific user types, such as registered users or verified customers.
Display Reviews Based on Product Category
You can configure your star rating reviews to display only for specific product categories. For example, you might want to display reviews for electronics products but not for clothing items.
Display Reviews Based on Purchase History
You can display reviews only from users who have purchased the product or have a recent purchase history with your store.
Display Reviews Based on Star Rating
You can set conditions to display reviews based on their star rating. For instance, you might want to display only reviews with 4 stars or higher.
Display Reviews Based on Custom Attributes
You can display reviews based on custom attributes that you have defined for your products. For example, you might have a custom attribute for “product quality” and only display reviews from users who rated the product’s quality as “good” or “excellent.”
The following table provides additional guidance on how to configure conditional display options for your star rating reviews:
| Condition | Description |
|---|---|
| User Type | Display reviews only for registered users, verified customers, or all users. |
| Product Category | Display reviews only for specific product categories. |
| Purchase History | Display reviews only from users who have purchased the product or have a recent purchase history. |
| Star Rating | Display reviews based on their star rating (e.g., only reviews with 4 stars or higher). |
| Custom Attributes | Display reviews based on custom attributes that you have defined for your products. |
Customizing Star Rating UI
There are several ways to customize the appearance of your star rating widget. You can change the color of the stars, the size of the stars, and the number of stars that are displayed.
Changing the Star Color
To change the color of the stars, you can use the starColor property. This property accepts a hex color code or a CSS color name. For example, to change the color of the stars to blue, you would use the following code:
“`
starColor: ‘#0000FF’
“`
Changing the Star Size
To change the size of the stars, you can use the starSize property. This property accepts a number that represents the size of the stars in pixels. For example, to change the size of the stars to 20 pixels, you would use the following code:
“`
starSize: 20
“`
Changing the Number of Stars
To change the number of stars that are displayed, you can use the numStars property. This property accepts a number that represents the number of stars that should be displayed. For example, to display 5 stars, you would use the following code:
“`
numStars: 5
“`
Customizing the Star Rating Text
In addition to customizing the appearance of the stars, you can also customize the text that is displayed with the star rating. You can change the font of the text, the size of the text, and the color of the text.
To change the font of the text, you can use the textFont property. This property accepts a CSS font family name. For example, to change the font of the text to Arial, you would use the following code:
“`
textFont: ‘Arial’
“`
To change the size of the text, you can use the textFontSize property. This property accepts a number that represents the size of the text in pixels. For example, to change the size of the text to 12 pixels, you would use the following code:
“`
textFontSize: 12
“`
To change the color of the text, you can use the textColor property. This property accepts a hex color code or a CSS color name. For example, to change the color of the text to blue, you would use the following code:
“`
textColor: ‘#0000FF’
“`
| Property | Description |
|---|---|
starColor |
Sets the color of the stars. |
starSize |
Sets the size of the stars. |
numStars |
Sets the number of stars that are displayed. |
textFont |
Sets the font of the text. |
textFontSize |
Sets the size of the text. |
textColor |
Sets the color of the text. |
Displaying Reviews in Ascending Order
To display reviews in ascending order, you can use the following code:
“`html
-
{% for review in reviews %}
-
{{ review.rating }}
{{ review.body }}
{% endfor %}
“`
This code will sort the reviews by rating, with the lowest-rated reviews appearing at the top of the list.
You can also use the following code to sort reviews by date:
“`html
-
{% for review in reviews %}
-
{{ review.rating }}
{{ review.body }}
{{ review.date }}
{% endfor %}
“`
This code will sort the reviews by date, with the most recent reviews appearing at the top of the list.
You can also use the following code to sort reviews by a custom field:
“`html
-
{% for review in reviews %}
-
{{ review.rating }}
{{ review.body }}
{{ review.custom_field }}
{% endfor %}
“`
This code will sort the reviews by custom field, with the reviews with the highest value for the custom field appearing at the top of the list.
Formatting Ratings with Decimal Points
Custom GPTs offer the flexibility to display star ratings with decimal points, allowing for more granular feedback. Here’s how you can implement it:
To format star ratings with decimal points, you can use the `:step` property in the `rating` element. This property specifies the increment between each star value. For example, to display ratings with half stars, you would set `:step=”0.5″`.
In addition to the `:step` property, you can also use the `:precision` property to control the number of decimal places displayed. For example, to display ratings with one decimal place, you would set `:precision=”1″`.
| Property | Description |
|---|---|
| `:step` | Specifies the increment between each star value. |
| `:precision` | Controls the number of decimal places displayed. |
Example code:
“`javascript
“`
This code will create a star rating component that allows users to select half stars, and the selected rating will be displayed with one decimal place of precision (e.g., 3.5 stars).
Setting a Maximum Number of Stars
To limit the number of stars that can be displayed, use the max attribute. This sets the upper limit for the number of stars that will be shown. For example, to display a maximum of 5 stars, you would use the following code:
“`html
“`
The max attribute can be any positive integer. If the value of the max attribute is less than the value of the stars attribute, the stars attribute will be ignored and the max attribute value will be used instead.
The following table summarizes the behavior of the max attribute:
max Attribute Value |
Result |
|---|---|
5 |
Displays a maximum of 5 stars |
10 |
Displays a maximum of 10 stars |
less than |
Ignores stars attribute value and uses max attribute value instead |
Displaying Reviews from Specific Authors
To display reviews from specific authors, you can use the review_author_filter field in the Reviews.list() method. This field accepts a string value representing the author’s name or email address. For example, to display reviews from the author “John Doe,” you would use the following code:
“`
reviews = service.reviews().list(
gplusPlaceId=placeid,
review_author_filter=”John Doe”
).execute()
“`
You can also use the review_author_filter field to display reviews from multiple authors. To do this, separate the authors’ names or email addresses with a comma. For example, to display reviews from the authors “John Doe” and “Jane Smith,” you would use the following code:
“`
reviews = service.reviews().list(
gplusPlaceId=placeid,
review_author_filter=”John Doe, Jane Smith”
).execute()
“`
The following table summarizes the different values that you can use for the review_author_filter field:
| Value | Description |
|---|---|
| A single author’s name or email address | Displays reviews from the specified author. |
| Multiple authors’ names or email addresses, separated by commas | Displays reviews from all of the specified authors. |
| Empty string | Displays reviews from all authors. |
Using Different Text for Zero Star Ratings
In some cases, you may want to display different text for zero star ratings. This can be useful if you want to emphasize the fact that a product has no reviews, or if you want to provide a custom message for customers who have not yet left a review.
To use different text for zero star ratings, you can use the `zero_star_text` property. This property allows you to specify the text that will be displayed when a product has no reviews.
Example
The following example shows how to use the `zero_star_text` property to display the text “No reviews” for products that have no reviews:
“`
php
$reviews = $client->reviews;
$product = $reviews->product(‘my-product’);
$product_reviews = $product->reviews();
foreach ($product_reviews as $product_review) {
$rating = $product_review->rating();
if ($rating === 0) {
// Display the text “No reviews” for products that have no reviews.
echo “No reviews”;
} else {
// Display the rating as normal.
echo $rating;
}
}
“`
| Property | Description |
|---|---|
| `zero_star_text` | The text that will be displayed when a product has no reviews. |
Troubleshooting Display Issues
If you’re experiencing issues displaying star rating reviews for custom GPTs, here are some troubleshooting tips:
1. Check the Review Status
Ensure that the reviews you’re trying to display have been approved and are not in a pending or rejected state.
2. Verify the GPT ID
Double-check that you’re using the correct GPT ID in your code. You can find the GPT ID in the GPT settings.
3. Use the Correct Syntax
Review the syntax for displaying star rating reviews. Make sure that you’re using the correct HTML structure and CSS styles.
4. Check for JavaScript Errors
Open your browser’s console to check for any JavaScript errors that may be preventing the reviews from displaying.
5. Check for Network Issues
Ensure that your website has a stable internet connection. Reviews may not display if there’s a network issue.
6. Clear Your Browser Cache
Clear your browser’s cache to remove any outdated files that may be interfering with the display of reviews.
7. Disable Ad Blockers
Disable any ad blockers on your website, as they can sometimes interfere with the display of GPTs and reviews.
8. Contact GPT Support
If you’ve tried all of the above troubleshooting steps and still can’t display star rating reviews, contact the GPT support team for assistance.
9. Check GPT Compatibility
Ensure that the GPT you’re using is compatible with displaying star rating reviews. Some GPTs may have limitations on the types of reviews they can display.
10. Review Code Structure and Customizations
Thoroughly examine your HTML, CSS, and JavaScript code for any errors or customizations that may be affecting the display of reviews. This may include checking for incorrect element IDs, missing CSS classes, or inappropriate styling.
| Issue | Description | Troubleshooting Tips |
|---|---|---|
| Reviews not displaying | The reviews are not appearing on the website. | – Check review status (approved, pending, rejected) – Verify GPT ID – Use correct syntax – Check for JavaScript errors |
| Star ratings not displaying | The star ratings are not appearing for the reviews. | – Check GPT compatibility – Review code structure and customizations – Clear browser cache – Check for network issues |
| Reviews display incorrectly | The reviews are displaying incorrectly, such as overlapping or appearing in the wrong order. | – Disable ad blockers – Check for CSS styling issues – Review custom JavaScript code – Contact GPT support |
How to Display a Star-Rating Review for Custom GPTs
To display a star-rating review for a custom GPT, you can use the following steps:
- Create a custom GPT using the Google Publisher Tag Manager.
- In the “Advanced settings” tab, select the “Star rating” option for the “Review type” setting.
- Click “Save” to create the custom GPT.
- Copy the GPT code and paste it into your website code.
- Place the GPT code in the location where you want the star-rating review to appear.
Once you have completed these steps, the star-rating review will be displayed on your website.
People Also Ask
How do I get a star rating for my custom GPT?
To get a star rating for your custom GPT, you can use the following steps:
- Create a custom GPT using the Google Publisher Tag Manager.
- In the “Advanced settings” tab, select the “Star rating” option for the “Review type” setting.
- Click “Save” to create the custom GPT.
- Copy the GPT code and paste it into your website code.
- Place the GPT code in the location where you want the star-rating review to appear.
- Click on the star-rating review to open the review form.
- Enter your review and click “Submit”.
Once you have submitted your review, it will be displayed on your website.
How do I edit a star rating for my custom GPT?
To edit a star rating for your custom GPT, you can use the following steps:
- Click on the star-rating review to open the review form.
- Click on the “Edit” button.
- Make your changes to the review.
- Click “Submit” to save your changes.
Once you have saved your changes, the star rating for your custom GPT will be updated.
How do I delete a star rating for my custom GPT?
To delete a star rating for your custom GPT, you can use the following steps:
- Click on the star-rating review to open the review form.
- Click on the “Delete” button.
- Click “OK” to confirm that you want to delete the review.
Once you have deleted the review, it will no longer be displayed on your website.
