​
Event Overview

The Product rated event is vital for understanding customer satisfaction and gathering social proof. You can trigger “Thank you for reviewing” or “We are sorry you had a bad experience” flows based on the rating.

​
Use Cases

  • Thank you messages for reviews
  • Review published notifications
  • Reward distribution for reviews
  • Low rating customer service outreach
  • UGC collection for marketing

​
Event Attributes

FieldTypeDescription
product_idstringUnique product identifier
product_namestringDisplay name of product
product_urlstringDirect link to product page
product_image_urlstringProduct image URL
skustringStock Keeping Unit
variant_idstringSpecific variant ID
variant_namestringVariant description
brandstringProduct brand
categorystringProduct category path
product_typestringType of product
pricenumberProduct price
currencystringCurrency code
rating_valuenumberNumeric rating (e.g., 4.5)
rating_scaleintegerMax rating scale (typically 5)
rating_idstringUnique rating identifier
review_titlestringTitle of review
review_textstringFull review content
review_idstringUnique review identifier
review_statusstringApproval status
has_imagesbooleanReview includes images
images_countintegerNumber of images
has_videobooleanReview includes video
order_idstringAssociated order ID
purchase_datestring (ISO 8601)Purchase date
verified_purchasebooleanVerified buyer indicator
rating_sourcestringWhere rating submitted
is_first_reviewbooleanFirst review by customer
Review Status Values:
  • published - Live and visible
  • pending - Awaiting approval
  • rejected - Rejected by moderator

​
Payload Example

{
  "attributes": {
    "product_id": "PROD-123",
    "product_name": "Leather Boots",
    "product_url": "https://example.com/products/leather-boots",
    "product_image_url": "https://example.com/images/boots.jpg",
    "sku": "BT-001",
    "variant_id": "VAR-BLACK-10",
    "variant_name": "Black - Size 10",
    "brand": "CocoonStyle",
    "category": "Footwear > Boots",
    "product_type": "Apparel",
    "price": 89.99,
    "currency": "USD",
    "rating_value": 5,
    "rating_scale": 5,
    "rating_id": "RATE-001",
    "review_title": "Great quality!",
    "review_text": "Absolutely love these! Best purchase ever.",
    "review_id": "REV-987",
    "review_status": "published",
    "has_images": true,
    "images_count": 2,
    "has_video": false,
    "order_id": "ORD-12345",
    "purchase_date": "2026-01-20T10:00:00+05:30",
    "verified_purchase": true,
    "rating_source": "product_page",
    "is_first_review": true
  }
}