Panduan AggregateRating Schema
cara implement AggregateRating schema markup untuk star ratings di hasil pencarian, apa schema.org/AggregateRating covers vs. apa Google memerlukan untuk review snippets, dan eligibility dan spam policies.
Bahasa
1 sinyal bukti di halaman ini
- Alat aktif terkaitSchema Markup Validator
AggregateRating schema (schema.org/AggregateRating) marks up average dari banyak ratings atau reviews dari sebuah item, sebagai opposed untuk Review, yang marks up satu person's opinion. ini adalah biasanya nested di dalam sebuah parent jenis's aggregateRating property (Product, LocalBusiness, Recipe, dan others), yang adalah mengapa ini dapat skip itemReviewed — tetapi Google juga accepts sebuah non-nested AggregateRating itu names itemReviewed secara langsung; either cara item menjadi rated perlu sebuah name. Google's diperlukan properties untuk star rich hasil adalah ratingValue, setidaknya satu dari ratingCount atau reviewCount, dan itemReviewed (unless nested); bestRating dan worstRating adalah recommended. eligibility aturan orang mendapatkan wrong: self-serving ratings adalah ineligible untuk star fitur secara khusus pada LocalBusiness dan Organization jenis — sebuah business rating itself — tetapi Product, Recipe, Movie, dan sebagian besar lainnya didukung jenis tetap eligible untuk genuine ratings. ratingCount (semua ratings, star-hanya disertakan) dan reviewCount (orang siapa left sebuah review, dengan atau tanpa sebuah rating) adalah berbeda angka. Valid markup hanya earns star-rating eligibility, tidak peringkat, dan fake ratings dapat trigger sebuah manual tindakan.
TL;DR — AggregateRating adalah code Anda tambahkan untuk sebuah halaman itu says “itu average rating dari ini hal adalah 4.6 stars, out dari ini banyak ratings.” (terjemahan) “ average rating dari ini hal adalah 4,6 stars, out dari ini banyak ratings.” ini adalah apa powers ⭐ star snippet Anda see di bawah beberapa hasil pencarian. sebagian besar dari time Anda nest ini di dalam markup untuk whatever’s menjadi rated (sebuah product, sebuah recipe, sebuah business) — Google juga memungkinkan sebuah standalone versi itu names rated item secara langsung, tetapi nesting adalah umum pattern. dan Anda dapat’t hanya rate Anda own business dan expect stars — Google blocks itu.
Apa AggregateRating schema adalah
Ketika sebuah halaman menampilkan sesuatu like “4.6 ★ (218 ratings)” (terjemahan) “4,6 ★ (218 ratings)”, sebuah human membaca ini di sebuah glance. sebuah mesin pencari sees plain text dan memiliki untuk guess apa itu angka berarti. AggregateRating spells ini out di code, menggunakan shared schema.org vocabulary: ini labels average score, bagaimana banyak ratings ini adalah berdasarkan, dan scale.
Evidence for this claim Schema.org AggregateRating represents a rating based on a collection of ratings or reviews and is attached to the item being rated. Scope: Schema.org vocabulary; Google feature eligibility depends on the host type and documented requirements. Confidence: high · Verified: Schema.org: AggregateRatingkey kata adalah aggregate — ini adalah average dari banyak ratings. itu’s berbeda dari Review schema, yang marks up satu person’s ditulis opinion. sebagian besar halaman itu memiliki keduanya gunakan them together: satu AggregateRating untuk overall average, plus sebuah handful dari individual Reviews.
ini adalah hampir selalu ditulis sebagai JSON-LD — sebuah kecil block dari code itu sits di halaman tanpa mengubah bagaimana halaman looks.
Mengapa ini adalah worth melakukan
payoff adalah star-rating rich snippet: itu gold stars dan sebuah rating count di bawah sebuah penelusuran hasil. sebuah listing dengan stars stands out dan dapat earn lebih clicks. untuk mendapatkan ini, Google perlu sebuah sedikit pieces:
ratingValue— average score, like4.6.- setidaknya satu count — either
ratingCount(bagaimana banyak ratings total) ataureviewCount(bagaimana banyak orang left sebuah review, dengan atau tanpa sebuah star rating). Anda perlu satu dari them. itemReviewed— apa menjadi rated. jika Anda nest AggregateRating di dalam product/recipe/dan seterusnya., ini adalah covered oleh itu nesting dan Anda dapat skip ini — tetapi either cara, hal menjadi rated perlu sebuah name.
Secara opsional, bestRating dan worstRating deskripsikan scale (Google assumes 1–5 jika
Anda leave them off).
hal sebagian besar orang mendapatkan wrong
Anda dapat’t tambahkan AggregateRating untuk Anda own business dan mendapatkan stars. jika Anda jalankan sebuah
local business atau sebuah company situs dan mark up “our customers rate us 4.9 stars,” (terjemahan) “kami customers rate us 4,9 stars,”
Google akan tidak tampilkan itu stars. ini panggilan ini self-serving — sebuah business
rating itself — dan ini adalah blocked untuk LocalBusiness dan Organization markup
secara khusus.
tetapi — dan ini adalah bagian itu trips everyone up — ini adalah tidak sebuah blanket “Anda tidak dapat rate Anda own stuff” (terjemahan) “Anda dapat’t rate Anda own stuff” aturan. sebuah online shop dapat legitimately tampilkan star ratings pada -nya own product halaman. block adalah tentang sebuah business rating itself sebagai sebuah business, tidak sebuah store menunjukkan genuine customer ratings dari products ini sells.
Dua lebih beginner traps:
- Anda selalu perlu sebuah count, tidak hanya sebuah average. sebuah bare “4.6 stars” (terjemahan) “4,6 stars” dengan Tidak angka dari ratings behind ini tidak cukup.
- Ratings memiliki untuk menjadi nyata. Faking atau buying ratings tidak hanya terhadap aturan — ini dapat mendapatkan Anda halaman hit dengan sebuah manual penalty itu menghapus rich hasil.
ingin tepat diperlukan properties, ratingCount vs. reviewCount pembedaan,
penuh self-serving-reviews cakupan, dan cara perbaiki umum Search Console errors?
Switch untuk Advanced tab.
TL;DR —
AggregateRatingadalah biasanya nested di dalam sebuah parent jenis’saggregateRatingproperty (Product,LocalBusiness,Recipe,Book,Course,Event,Movie,SoftwareApplication, dan others), yang adalah mengapa nested contoh omititemReviewed— tetapi Google’s spec juga mendukung sebuah non-nestedAggregateRatingitu namesitemReviewedsecara langsung. Either cara, item menjadi rated perlu sebuah name. Google’s diperlukan properties untuk star rich hasil adalahratingValue, setidaknya satu dariratingCount/reviewCount, danitemReviewedketika tidak nested;bestRating/worstRatingadalah recommended (essential untuk non-1–5 scales). eligibility aturan untuk mendapatkan persis right: self-serving ratings adalah ineligible untuk star fitur secara khusus padaLocalBusiness/Organization— sebuah business rating itself — sementaraProduct,Recipe,Movie, dan sebagian besar lainnya didukung jenis stay eligible untuk genuine ratings.ratingCount(semua ratings, star-hanya disertakan) danreviewCount(orang siapa left sebuah review, dengan atau tanpa sebuah rating) adalah berbeda angka. Valid markup earns star eligibility, tidak peringkat, dan fabricated ratings dapat trigger sebuah structured-data manual tindakan. ini topic adalah cross-listed di bawah data terstruktur dan di bawah ecommerce SEO karena ratings markup adalah sebuah recurring ecommerce audit item.
AggregateRating vs. Review — pembedaan semuanya hinges pada
sebagian besar pesaing guides blur ini dua jenis ke satu flat requirements list. mereka’re distinct:
Reviewmarks up satu reviewer’s opinion dari sebuah item — sebuah single person, sebuah singlereviewRating, sebuah body dari review text.AggregateRatingmarks up statistical average dari banyak ratings —ratingValueplus sebuah count.
banyak nyata implementations gunakan keduanya together, nested di dalam yang sama parent jenis: sebuah
aggregateRating untuk overall score dan sebuah array dari review objects untuk
individual opinions. Google’s guidance berjalan satu direction, tidak keduanya: jika Anda’re
sudah marking up multiple individual reviews, tambahkan sebuah aggregate rating alongside
them. itu tidak berarti sebuah AggregateRating pada -nya own perlu dibuat-buat Review
objects untuk go dengan ini — sebuah halaman dengan hanya sebuah aggregate dan Tidak individual reviews adalah
sebuah wajar, menyelesaikan implementation. jika Anda hanya remember satu hal: Review = satu
opinion, AggregateRating = average dari banyak. untuk single-reviewer side, see
Review schema sibling.
Nested vs. non-nested — dua valid cara untuk attach ini
AggregateRating memiliki Tidak independent meaning pada -nya own halaman, tetapi ini tidak strictly
“nest it or nothing” (terjemahan) “nest ini atau tidak ada apa pun” either. Google mendukung dua shapes:
- Nested ( umum pattern) —
AggregateRatingsits di dalam lainnya jenis’saggregateRatingproperty (Product,LocalBusiness,Recipe, dan rest dari didukung list di bawah). Karena parent jenis sudah identifies item, sebuah nestedAggregateRatingomitsitemReviewed— tetapi parent item masih perlu sebuahname. - Non-nested —
AggregateRatingdapat juga stand pada -nya own, disediakan ini suppliesitemReviewednaming hal menjadi rated. ini adalah lebih sedikit umum dalam praktik tetapi ini adalah sebuah terdokumentasi, valid path, tidak sebuah workaround.
Either shape perlu reviewed item’s name di suatu tempat — pada parent ketika nested,
di dalam itemReviewed ketika tidak. host jenis Google mendukung untuk review/star
rich hasil adalah sebuah finite list: Book, Course, Event, LocalBusiness, Movie, Product,
Recipe, Software App, plus additional didukung nesting jenis
(CreativeWorkSeason, CreativeWorkSeries, Episode, Game, MediaObject,
MusicPlaylist, MusicRecording, dan Organization).
practical consequence: putting aggregateRating pada sebuah unsupported jenis
tidak akan render stars bahkan jika markup validates cleanly. Validation dan
rich-hasil eligibility adalah dua berbeda bars.
diperlukan dan recommended properties
Google’s spec (stricter daripada bare schema.org) untuk star rich hasil.
itemReviewed baris bergantung pada yang shape Anda’re menggunakan:
| Property | Status | Apa ini adalah |
|---|---|---|
itemReviewed | diperlukan jika non-nested; omit jika nested | item menjadi rated. Nested di dalam sebuah parent jenis, ini adalah implied oleh nesting dan parent’s own name — set ini explicitly hanya ketika AggregateRating stands alone |
ratingValue | diperlukan | average score, e.g. 4.6 |
ratingCount atau reviewCount | Satu diperlukan | Sample size behind average |
bestRating | Recommended | Top dari scale (defaults untuk 5) |
worstRating | Recommended | Bottom dari scale (defaults untuk 1) |
Dua formatting aturan dari schema.org’s own usage notes itu penyebab avoidable
validation failures: gunakan nyata digit characters (0–9), tidak look-alike Unicode
symbols, dan gunakan period sebagai decimal separator, tidak sebuah comma. "4,6" adalah sebuah
umum mistake di locales itu gunakan comma decimals.
ratingCount vs. reviewCount — sebuah nyata pembedaan
banyak guides gunakan ini interchangeably, atau shrink reviewCount down untuk hanya “written
reviews.” (terjemahan) “ditulis
reviews.” Google’s saat ini property definitions adalah lebih spesifik:
ratingCount— total angka dari ratings, including star-hanya submissions dengan Tidak accompanying review text.reviewCount— angka dari orang siapa disediakan sebuah review, dengan atau tanpa sebuah accompanying rating. ini tidak strictly “written reviews only” (terjemahan) “ditulis reviews hanya” — ini adalah keyed untuk orang siapa reviewed, apakah atau tidak mereka juga left sebuah numeric rating.
dalam praktik, pada sebagian besar rating/review platforms ini masih land sebagai berbeda angka,
karena tidak everyone siapa leaves sebuah star rating menulis sebuah review dan tidak everyone siapa
menulis sebuah review attaches sebuah star. sebuah store mungkin tampilkan 4,6 stars dari sebuah
ratingCount dari 1 200, di mana 340 orang (reviewCount) sebenarnya left review
text. Map definitions di atas onto namun Anda own platform separates “rated” (terjemahan) “rated” dari
“reviewed” (terjemahan) “reviewed” alih-alih assuming situs’s rating/review split matches ini contoh
persis. Google memerlukan setidaknya satu dari dua properties; supply satu itu
matches apa Anda platform sebenarnya tracks, dan jangan inflate either untuk sebuah angka Anda
halaman dapat’t mendukung.
bestRating / worstRating — sertakan them off default scale
Google assumes sebuah 1–5 scale ketika ini adalah absent. jika Anda rate pada 1–10, out dari 100,
atau apa pun non-default range, Anda harus set bestRating/worstRating atau Google dapat
misread scale — sebuah 9.2 pada sebuah 10-poin scale, left unqualified, mendapatkan interpreted
sebagai 9,2 out dari 5, yang adalah nonsensical.
self-serving reviews aturan — scoped precisely
ini adalah single sebagian besar-mangled poin di topic, so I’ll state ini persis.
Google’s wording: “Jika itu entity itu menjadi reviewed controls itu reviews tentang
itself, mereka halaman itu gunakan LocalBusiness atau any other jenis dari Organization
structured data adalah ineligible untuk star review feature.” (terjemahan) “jika entity itu’s menjadi reviewed controls reviews tentang
itself, mereka halaman itu gunakan LocalBusiness atau apa pun lainnya jenis dari Organization
data terstruktur adalah ineligible untuk star review fitur.” Baca cakupan dengan hati-hati —
ini names LocalBusiness dan Organization (dan mereka subtypes). ini adalah tentang
sebuah business rating itself sebagai sebuah business. Evidence for this claim Google requires ratings represented in structured data to be visible to users and prohibits misleading or fabricated review markup. Scope: Google Search structured-data and review snippet policies; violations can remove feature eligibility. Confidence: high · Verified: Google: Review snippet structured data
ini melakukan tidak apply untuk Product. sebuah webshop dapat legitimately tampilkan star ratings pada
-nya own product halaman — itu’s average dari genuine customer ratings dari sebuah
product ini sells, tidak business rating itself. Recipe, Movie, Book,
SoftwareApplication, dan rest dari didukung list stay eligible too, subject
untuk ratings menjadi genuine.
ini aturan dates untuk sebuah September 2019 Google policy perubahan (“Membuat Review Rich
Hasil lebih helpful” (terjemahan) “membuat Review Rich
hasil lebih helpful”), yang introduced “self-serving” (terjemahan) “self-serving” framing — including
reviews dari Anda own business embedded secara langsung atau pulled di melalui sebuah ketiga-party
widget. (I’m paraphrasing reasoning dari itu announcement alih-alih quoting ini;
saat ini, citable statement dari aturan adalah Review snippet documentation quoted
di atas.) upshot: sebuah ketiga-party review widget pada Anda own LocalBusiness/
Organization halaman adalah masih self-serving dan masih ineligible untuk stars.
Organization adalah persis mengapa Organization schema sibling adalah relevant di sini —
ini adalah satu dari dua host jenis di mana self-hosted ratings tidak akan earn stars.
Genuine ratings hanya — spam dan manual-tindakan policy
Dua flat aturan dari Google’s guidance:
- jangan aggregate dari lainnya situs. Google: “jangan aggregate reviews atau ratings dari other websites.” (terjemahan) “jangan aggregate reviews atau ratings dari lainnya situs web.” Scraping ratings dari elsewhere ke Anda own markup adalah out.
- Ratings harus menjadi dari pengguna nyata. Google’s structured-data policies frame genuine ratings sebagai enforced, tidak aspirational — -nya recipe-spesifik contoh notes itu “reviews or ratings not by actual users may result in manual action.” (terjemahan) “reviews atau ratings tidak oleh sebenarnya pengguna dapat hasil di manual tindakan.” itu principle generalizes untuk reviews policy di seluruh jenis.
sebuah structured-data manual tindakan untuk misleading atau fake ratings menghapus rich-hasil eligibility untuk halaman. ini adalah enforced, tidak theoretical. juga membuat review konten genuinely present pada halaman — Google expects marked-up ratings untuk menjadi readily tersedia untuk pengguna pada yang sama halaman, tentang sebuah spesifik item, tidak sebuah category atau sebuah list.
Di mana AggregateRating sits di wider picture
Like semua data terstruktur, AggregateRating memengaruhi rich-hasil eligibility, tidak
peringkat — lebih luas Schema Markup dan data terstruktur hubs membuat itu case
di penuh, so I tidak akan re-litigate ini di sini. aggregateRating adalah sebuah recommended property
pada Product (paling umum dunia nyata host) dan pada ProductGroup untuk
variant-tingkat rating rollups — keduanya natural berikutnya membaca. gunakan JSON-LD; ini adalah
Google’s recommended format dan satu setiap contoh di ini artikel menggunakan.
Bing dan lainnya mesin: schema.org adalah sebuah joint Google/Microsoft/Yahoo/Yandex
vocabulary, dan Bing’s umum structured-data documentation mengonfirmasi ini membaca
schema.org/JSON-LD markup. Apa tidak saat ini verifiable terhadap pertama-party
Microsoft documentation adalah sebuah jenis-spesifik claim dari parity dengan Google’s
AggregateRating requirements — Bing publishes Tidak comparable per-jenis
diperlukan/recommended breakdown dan Tidak self-serving-reviews policy documentation
cara Google melakukan, dan -nya rich-hasil surface untuk ratings adalah lebih sempit dan lebih sedikit
terdokumentasi. jangan assume Bing’s eligibility aturan mirror Google’s poin-untuk-poin;
treat ini sebagai sebuah open pertanyaan alih-alih sebuah confirmed satu until Bing publishes -nya
own AggregateRating-spesifik guidance.
AI summary
sebuah condensed take pada Advanced versi:
- Apa ini adalah:
schema.org/AggregateRatingmarkup (biasanya JSON-LD) untuk average dari banyak ratings/reviews dari sebuah item — sebagai opposed untukReview, yang adalah satu reviewer’s opinion. banyak halaman gunakan keduanya together; Google menanyakan untuk sebuah aggregate ketika Anda’re sudah marking up multiple individual reviews, tidak reverse. - Nested atau non-nested:
AggregateRatingadalah biasanya nested di sebuah parent jenis’saggregateRatingproperty (Product,LocalBusiness,Recipe,Book,Course,Event,Movie,SoftwareApplication, dan others), yang adalah mengapa nested contoh skipitemReviewed— tetapi Google juga mendukung sebuah non-nestedAggregateRatingitu namesitemReviewedsecara langsung. Either cara rated item perlu sebuah name. - diperlukan untuk star rich hasil:
ratingValue, setidaknya satu dariratingCount/reviewCount, danitemReviewedketika tidak nested. Recommended:bestRating/worstRating(essential off default 1–5 scale). ratingCountvs.reviewCount:ratingCount= semua ratings incl. star-hanya;reviewCount= orang siapa left sebuah review, dengan atau tanpa sebuah rating. berbeda angka; Anda perlu satu.- Self-serving aturan ( key confusion), scoped precisely: self-serving ratings
adalah ineligible untuk star fitur hanya pada
LocalBusiness/Organization— sebuah business rating itself — introduced Sept 2019.Product,Recipe,Movie, dan seterusnya. stay eligible untuk genuine ratings. sebuah ketiga-party widget dari Anda own business reviews adalah masih self-serving. - didukung host jenis adalah finite: Book, Course, Event, LocalBusiness, Movie, Product, Recipe, Software App, plus additional nesting jenis. pada sebuah unsupported jenis, stars tidak akan render bahkan jika markup validates.
- Genuine ratings hanya: “jangan aggregate reviews atau ratings dari other websites,” (terjemahan) “jangan aggregate reviews atau ratings dari lainnya situs web,” dan fake/incentivized ratings dapat trigger sebuah structured-data manual tindakan itu menghapus rich-hasil eligibility.
- Formatting: nyata digits (0–9), period decimal separator (tidak comma).
- Eligibility ≠ peringkat: valid markup hanya membuat halaman eligible untuk stars; ini adalah tidak sebuah peringkat factor. Bing consumes yang sama vocabulary tetapi memiliki Tidak comparable eligibility documentation.
Dokumentasi resmi
Utama-sumber documentation untuk AggregateRating.
schema.org ( vocabulary)
- AggregateRating jenis — baseline jenis definition, property list (
itemReviewed,ratingCount,reviewCount, inheritedratingValue/bestRating/worstRating), dan digit/decimal-separator usage notes.
Google — eligibility dan requirements side
- Review snippet (Review, AggregateRating) data terstruktur — authoritative spec: diperlukan properties, didukung host-jenis list, self-serving-reviews cakupan (LocalBusiness/Organization), dan “don’t aggregate from other websites” (terjemahan) “jangan aggregate dari lainnya situs web” aturan.
- umum data terstruktur Guidelines — spam policies, manual-tindakan language, dan genuine-ratings requirement.
- membuat Review Rich hasil lebih helpful (Sept 2019) — origin dari self-serving-reviews policy. Cited untuk “when/why it changed” (terjemahan) “ketika/mengapa ini changed” context.
- Rich hasil Test — validate markup dan periksa star-rating eligibility.
Bing / Microsoft
- Marking up Anda situs dengan data terstruktur — Bing’s umum structured-data mendukung (schema.org, JSON-LD).
Quotes dari sumber
pada—record statements dari schema.org dan Google. Di mana sebuah sumber halaman exposes text, tautan adalah sebuah deep tautan itu jumps untuk quoted passage.
schema.org — jenis definition
- “The average rating based on multiple ratings or reviews.” (terjemahan) “ average rating berdasarkan multiple ratings atau reviews.” Jump untuk quote
Google docs — marking up sebuah aggregate
- “Make sure to mark up an aggregate evaluation of an item by many people with schema.org/AggregateRating.” (terjemahan) “pastikan untuk mark up sebuah aggregate evaluation dari sebuah item oleh banyak orang dengan schema.org/AggregateRating.” Jump untuk quote
Google docs — self-serving reviews aturan (scoped untuk LocalBusiness/Organization)
- “If the entity that’s being reviewed controls the reviews about itself, their pages that use LocalBusiness or any other type of Organization structured data are ineligible for star review feature.” (terjemahan) “jika entity itu’s menjadi reviewed controls reviews tentang itself, mereka halaman itu gunakan LocalBusiness atau apa pun lainnya jenis dari Organization data terstruktur adalah ineligible untuk star review fitur.” Jump untuk quote
Google docs — jangan aggregate dari lainnya situs
- “Don’t aggregate reviews or ratings from other websites.” (terjemahan) “jangan aggregate reviews atau ratings dari lainnya situs web.” Jump untuk quote
Google — data terstruktur policies (deceive/mislead, manual tindakan)
- “Don’t use structured data to deceive or mislead users. Don’t impersonate any person or organization.” (terjemahan) “jangan gunakan data terstruktur untuk deceive atau mislead pengguna. jangan impersonate apa pun person atau organization.” Jump untuk quote
- pada genuine ratings (recipe-spesifik contoh, generalizable untuk reviews policy): “reviews or ratings not by actual users may result in manual action.” (terjemahan) “reviews atau ratings tidak oleh sebenarnya pengguna dapat hasil di manual tindakan.” umum data terstruktur Guidelines
AggregateRating vs. Review — yang melakukan I perlu?
berfungsi down pertanyaan:
1. adalah Anda marking up satu person’s opinion, atau average dari banyak?
- Satu reviewer’s opinion (sebuah single rating + review text) → Anda ingin Review schema, tidak AggregateRating.
- average di seluruh banyak ratings → AggregateRating. Continue.
- Keduanya (sebuah overall score dan individual opinions) → gunakan keduanya, nested together
di yang sama parent jenis: satu
aggregateRatingplus sebuah array darireviewobjects.
2. adalah Anda nesting ini, atau standing ini alone?
- Nesting di dalam
Product(atauProductGroup),Recipe,Movie,Book,Course,Event, atauSoftwareApplication→ didukung host; genuine ratings adalah biasanya eligible untuk stars, dan Anda dapat omititemReviewedsince parent sudah names item. Continue. - sebuah
LocalBusinessatauOrganizationrating itself → berhenti. Self-serving ratings di sini adalah ineligible untuk star fitur. jangan expect stars bahkan jika markup validates. - Tidak nesting di semua → itu’s fine too, sebagai panjang sebagai
AggregateRatingsuppliesitemReviewednaming rated item secara langsung. - beberapa lainnya parent jenis tidak pada Google’s didukung list → markup dapat validate, tetapi stars tidak akan render — ini adalah sebuah unsupported host.
3. melakukan Anda memiliki diperlukan properties?
- Konfirmasi
ratingValuedan setidaknya satu dariratingCount/reviewCount. jika Anda’re tidak nesting, juga setitemReviewed— either cara, rated item perlu sebuah name. Missing count adalah #1 failure. - Off sebuah 1–5 scale? tambahkan
bestRating/worstRatingatau Google dapat misread ini.
4. adalah ratings genuine dan pada-halaman?
- nyata, pengguna-sourced, tentang ini spesifik item, dan terlihat pada yang sama halaman → baik.
- Aggregated dari lainnya situs, fabricated, atau incentivized → jangan — ini risks sebuah structured-data manual tindakan, tidak hanya sebuah missing snippet.
aturan dari thumb: Review adalah satu opinion; AggregateRating adalah average dari banyak. Product-dan-friends dapat tampilkan genuine stars; sebuah business rating itself cannot.
AggregateRating myths dan mistakes untuk hindari
Myth: “I can add AggregateRating to my Organization/LocalBusiness schema and get
stars like a product does.” (terjemahan) “I dapat tambahkan AggregateRating untuk my Organization/LocalBusiness schema dan mendapatkan
stars like sebuah product melakukan.”
Tidak. Google explicitly excludes self-serving ratings pada LocalBusiness/Organization
dari star review fitur — “pages that use LocalBusiness or any other type of
Organization structured data are ineligible for star review feature” (terjemahan) “halaman itu gunakan LocalBusiness atau apa pun lainnya jenis dari
Organization data terstruktur adalah ineligible untuk star review fitur” ketika entity
controls reviews tentang itself. ini memiliki telah case since September 2019 policy
perubahan. sebuah business rating itself tidak mendapatkan stars; sebuah store rating -nya products
masih dapat.
Myth: “AggregateRating and Review are the same thing.” (terjemahan) “AggregateRating dan Review adalah yang sama hal.”
Review marks up satu reviewer’s opinion; AggregateRating marks up average
dari banyak. Distinct jenis, distinct diperlukan properties. banyak halaman gunakan keduanya,
nested together — tetapi mereka tidak interchangeable, dan menggunakan sebuah aggregate tidak
obligate Anda untuk invent individual Review objects untuk go dengan ini.
Mitos: “I only need ratingValue — the count doesn’t matter.” (terjemahan) “Saya hanya perlu ratingValue; jumlahnya tidak penting.”
Google memerlukan setidaknya satu dari ratingCount atau reviewCount alongside
ratingValue. sebuah bare average dengan Tidak sample size behind ini tidak eligible.
Mitos: “ratingCount and reviewCount are the same number.” (terjemahan) “ratingCount dan reviewCount adalah angka yang sama.”
mereka’re berbeda. ratingCount mencakup star-hanya submissions dengan Tidak review
text; reviewCount adalah angka dari orang siapa left sebuah review, dengan atau tanpa
sebuah rating attached — ini tidak strictly limited untuk “written reviews.” (terjemahan) “ditulis reviews.” sebuah halaman dapat memiliki
1 200 ratings tetapi hanya 340 orang siapa left sebuah review. Supply satu Anda platform
sebenarnya tracks — jangan inflate either.
Myth: “A third-party review widget on my business page automatically qualifies for
stars.” (terjemahan) “sebuah ketiga-party review widget pada my business halaman secara otomatis qualifies untuk
stars.”
jika widget displays reviews tentang Anda own business/organization — bahkan sourced
dari sebuah ketiga-party platform — ini adalah masih self-serving dan ineligible untuk
LocalBusiness/Organization star display.
Myth: “Fake or incentivized 5-star ratings just risk the snippet not showing.” (terjemahan) “Fake atau incentivized 5-star ratings hanya risk snippet tidak menunjukkan.” Google frames genuine-ratings-hanya sebagai enforced — fabricated ratings dapat trigger sebuah structured-data manual tindakan itu menghapus rich-hasil eligibility untuk halaman, tidak merely sebuah suppressed snippet.
Myth: “AggregateRating schema improves rankings.” (terjemahan) “AggregateRating schema improves rankings.” Like semua schema markup, ini memengaruhi rich-hasil eligibility, tidak peringkat — ini earns star-rating eligibility, tidak position. ( data terstruktur hub membuat ini case di penuh.)
Mistake: aggregating ratings dari lainnya situs web. Google’s guidance adalah sebuah flat “Don’t aggregate reviews or ratings from other websites.” (terjemahan) “jangan aggregate reviews atau ratings dari lainnya situs web.” gunakan hanya ratings Anda own halaman genuinely collected.
Mistake: malformed ratingValue. gunakan nyata digits dan sebuah period decimal
separator (4.6, tidak 4,6 atau look-alike Unicode). Comma decimals adalah sebuah umum,
avoidable validation failure.
Mistake: aggregateRating pada sebuah unsupported host jenis. Standing AggregateRating
alone dengan itemReviewed adalah valid, dan nesting ini di sebuah didukung jenis adalah umum
pattern — tetapi either cara, item jenis memiliki untuk menjadi pada Google’s didukung list. Put ini
pada sebuah unsupported jenis dan ini dapat validate tetapi tidak akan render stars.
Bersih vs. rusak AggregateRating JSON-LD
sebuah bersih, nested aggregate rating
AggregateRating correctly nested di dalam sebuah Product, dengan sebuah valid average, sebuah count,
dan scale spelled out — plus sebuah single review alongside ini ( umum
dunia nyata pattern):
{
"@context": "https://schema.org/",
"@type": "Product",
"name": "Trailhead 30L Hiking Backpack",
"image": "https://example.com/img/backpack.jpg",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.6",
"bestRating": "5",
"worstRating": "1",
"ratingCount": "1200",
"reviewCount": "340"
},
"review": [
{
"@type": "Review",
"author": { "@type": "Person", "name": "James Smith" },
"reviewRating": {
"@type": "Rating",
"ratingValue": "5",
"bestRating": "5"
},
"reviewBody": "Comfortable on long days, great ventilation."
}
]
}Note ratingCount (1 200 total ratings) dan reviewCount (340 orang siapa left sebuah
review) adalah berbeda angka — sebagai mereka biasanya adalah di reality.
non-nested form
Nesting adalah umum pattern, tetapi AggregateRating tidak memiliki untuk sit di dalam sebuah
Product (atau apa pun lainnya host) di semua. ini dapat stand alone, sebagai panjang sebagai ini supplies
itemReviewed naming rated item — ini adalah sebuah terdokumentasi, valid shape, tidak sebuah
workaround:
{
"@context": "https://schema.org/",
"@type": "AggregateRating",
"itemReviewed": {
"@type": "Product",
"name": "Trailhead 30L Hiking Backpack"
},
"ratingValue": "4.6",
"bestRating": "5",
"worstRating": "1",
"ratingCount": "1200",
"reviewCount": "340"
}sama properties, sama eligibility aturan — satu-satunya perbedaan adalah di mana itemReviewed
lives. Nested, ini adalah implied oleh parent dan biasanya omitted; non-nested, ini memiliki untuk
menjadi spelled out.
yang sama aggregate, rusak
setiap line flagged di bawah adalah sebuah nyata, umum validation failure:
{
"@context": "https://schema.org/",
"@type": "Product",
"name": "Trailhead 30L Hiking Backpack",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4,6"
}
}apa wrong:
- Tidak
ratingCountataureviewCount— produces classic “Either ‘ratingCount’ atau ‘reviewCount’ seharusnya menjadi specified” (terjemahan) “Either ‘ratingCount’ atau ‘reviewCount’ seharusnya menjadi specified” error. sebuah aggregate perlu sebuah sample size. ratingValue: "4,6"— sebuah comma decimal separator. gunakan period:"4.6".- Tidak
bestRating/worstRating— tolerable di 1–5, tetapi omit them off sebuah non-default scale dan Google misreads ini.
dan mistake itu validates tetapi masih menampilkan Tidak stars: putting ini tepat
aggregateRating pada sebuah LocalBusiness atau Organization rating itself — ini adalah
self-serving dan ineligible untuk star fitur regardless dari bersih markup.
umum Search Console / Rich hasil Test errors → memperbaiki
| Error string | mungkin penyebab | Perbaiki |
|---|---|---|
Either 'ratingCount' or 'reviewCount' should be specified | Tidak count supplied | tambahkan ratingCount atau reviewCount |
Missing field 'ratingValue' | Average omitted | tambahkan ratingValue (nyata digits, period decimal) |
Missing field 'itemReviewed' | Tidak jelas item menjadi rated | Nest di dalam sebuah didukung host, atau set itemReviewed |
The best rating value must be greater than the worst rating value | bestRating <= worstRating | Set sebuah valid scale, e.g. worstRating: 1, bestRating: 5 |
| Stars validate tetapi tidak pernah tampilkan | Self-serving pada LocalBusiness/Organization, atau sebuah unsupported host jenis | Move untuk sebuah didukung item jenis; sebuah business dapat’t rate itself |
alat untuk membangun dan memeriksa AggregateRating markup
My Schema Markup Validator adalah di mana I’d mulai setelah Anda’ve
ditulis JSON-LD. Paste block (atau sebuah penuh halaman) dan ini berjalan severity-tiered
memeriksa terhadap schema.org’s AggregateRating vocabulary dan Google’s rich-hasil
requirements — ini catches count-missing error, comma-decimal mistake, dan
bestRating/worstRating scale masalah described di atas, dan hands back sebuah corrected,
copy-pasteable JSON-LD block.
My Rich-hasil Eligibility Checker jawaban sebuah
berbeda pertanyaan: tidak “adalah ini valid JSON-LD” (terjemahan) “adalah ini valid JSON-LD” tetapi “does this specific page qualify
for Google’s star rich result.” (terjemahan) “melakukan ini spesifik halaman qualify
untuk Google’s star rich hasil.” Paste JSON-LD, sebuah HTML halaman, atau fetch sebuah langsung URL, dan
ini menampilkan, per jenis, yang diperlukan fields (itemReviewed, ratingValue,
ratingCount/reviewCount) adalah present versus missing, plus yang recommended fields
(bestRating, worstRating) Anda’re leaving off default scale.
jika Anda’re starting dari sebuah blank halaman alih-alih memperbaiki existing markup, my
Schema Markup Generator memiliki sebuah focused form untuk membangun
aggregateRating nested di dalam Product (atau apa pun dari lainnya didukung host jenis)
tanpa hand-writing JSON-LD, dan ini flags apakah setiap property adalah
Google-diperlukan, Google-recommended, atau schema.org-hanya sebagai Anda fill ini di.
Setelah markup melewati itu dua memeriksa, jalankan halaman melalui Google’s own Rich hasil Test — ini adalah alat Google sebenarnya menggunakan untuk decide eligibility, so ini adalah akhir kata sebelum Anda ship.
umum AggregateRating masalah dan cara perbaiki them
markup validates bersih, tetapi Tidak stars ever tampilkan di hasil pencarian
paling mungkin penyebab adalah self-serving-reviews aturan: aggregateRating adalah
nested di dalam LocalBusiness atau Organization, dan business adalah rating itself.
Google excludes itu combination dari star fitur entirely, regardless dari bagaimana
bersih JSON-LD adalah. periksa parent jenis pertama — jika ini adalah LocalBusiness atau
Organization, move rating conversation untuk genuine product-tingkat reviews alih-alih,
since sebuah business dapat’t earn stars oleh rating itself tetapi sebuah store dapat rate -nya products.
kedua-sebagian besar-mungkin penyebab adalah sebuah unsupported host jenis — aggregateRating nested di
sebuah jenis di luar Google’s didukung list (Book, Course, Event, LocalBusiness, Movie,
Product, Recipe, SoftwareApplication, dan lebih kecil additional list) akan validate
tetapi tidak pernah render stars.
Rich hasil Test atau Search Console flags “Either ‘ratingCount’ or ‘reviewCount’ should be specified” (terjemahan) “Either ‘ratingCount’ atau ‘reviewCount’ seharusnya menjadi specified”
aggregateRating object adalah missing sebuah sample-size property. ratingValue alone
tidak cukup — Google memerlukan setidaknya satu dari ratingCount atau reviewCount
alongside ini. tambahkan whichever satu matches apa Anda platform sebenarnya tracks (total
ratings including star-hanya submissions, atau angka dari orang siapa left sebuah review)
dan re-test.
ratingValue fails validation bahkan though angka looks right
periksa untuk sebuah comma decimal separator ("4,6" alih-alih "4.6") atau sebuah look-alike
Unicode digit alih-alih sebuah nyata 0–9 character — keduanya adalah umum penyebab di locales
itu format decimals dengan commas, dan keduanya adalah invisible-looking mistakes until sebuah
validator flags them.
Validator error: “Itu best rating value harus menjadi greater daripada itu worst rating value” (terjemahan) “ best rating nilai harus menjadi greater daripada worst rating nilai”
bestRating dan worstRating adalah set backwards, atau worstRating adalah missing dan
Google’s 1–5 default tidak match Anda sebenarnya scale (sebuah 1–10 atau out-dari-100 rating left
unqualified mendapatkan misread terhadap 1–5 default). Set keduanya explicitly — misalnya
worstRating: 1, bestRating: 5 — setiap kali Anda scale tidak default.
Search Console menampilkan valid items, tetapi stars masih jangan muncul di langsung SERP
Passing validation dan Search Console reporting “valid” (terjemahan) “valid” hanya berarti halaman adalah eligible untuk star rich hasil — ini tidak jaminan Google displays ini. ini adalah yang diharapkan, tidak sebuah bug untuk chase: eligibility memengaruhi rich-hasil eligibility, tidak sebuah promise dari display atau peringkat. jika markup adalah genuinely valid dan eligible, ada tidak ada apa pun further untuk perbaiki pada markup side.
Rich hasil disappeared setelah previously menunjukkan
sebuah structured-data manual tindakan untuk fabricated atau aggregated-dari-elsewhere ratings menghapus rich-hasil eligibility untuk halaman. periksa Search Console’s Manual tindakan report pertama. jika ada Tidak manual tindakan, re-validate saat ini markup — sebuah template atau CMS perubahan dapat silently break sebuah property (sebuah missing count, sebuah rewritten scale) itu adalah previously correct.
Proving Anda AggregateRating perubahan worked
Test 1: JSON-LD syntax dan diperlukan-property validation
Test untuk jalankan: Paste diperbarui JSON-LD ke my
Schema Markup Validator, atau jalankan langsung halaman melalui
Google’s Rich hasil Test.
Yang diharapkan hasil: Tidak errors pada AggregateRating block — ratingValue present
dengan sebuah nyata digit/period-decimal nilai, dan setidaknya satu dari ratingCount atau
reviewCount present.
Failure interpretation: sebuah flagged missing property berarti property genuinely
tidak di markup Anda shipped, tidak sebuah caching atau rendering issue — re-periksa
JSON-LD sumber.
Monitoring window: Immediate — keduanya alat baca markup secara langsung, Tidak crawl tunggu.
Rollback trigger: Validation masih fails setelah sebuah direct perbaiki — revert template
perubahan dan re-diff terhadap terakhir known-baik JSON-LD.
Test 2: Rich-hasil eligibility untuk spesifik host jenis
Test untuk jalankan: My Rich-hasil Eligibility Checker
terhadap langsung URL.
Yang diharapkan hasil: halaman’s parent jenis (e.g. Product) menampilkan sebagai eligible untuk
review/star rich hasil, dengan itemReviewed correctly resolved.
Failure interpretation: jika parent jenis adalah LocalBusiness atau Organization,
“not eligible” (terjemahan) “tidak eligible” adalah yang diharapkan perilaku (self-serving aturan), tidak sebuah bug — konfirmasi host
jenis sebelum treating ini sebagai sebuah failure.
Monitoring window: Immediate.
Rollback trigger: sebuah eligible-jenis halaman (Product, Recipe, dan seterusnya.) masih menampilkan
missing-diperlukan-field errors setelah sebuah perbaiki — deploy tidak sebenarnya perbarui
markup Google sees; periksa untuk caching atau sebuah bangun langkah overwriting perubahan.
Test 3: Search Console Enhancement report reflects perbaiki
Test untuk jalankan: Search Console → relevant Enhancement report (Product snippets / Merchant listings, depending pada Anda host jenis) untuk affected URLs. Yang diharapkan hasil: halaman moves dari “Tidak valid” (terjemahan) “Tidak valid” atau “Not eligible” (terjemahan) “Tidak eligible” ke “Valid” (terjemahan) “Valid” bucket, dan report’s error count untuk itu URL drops untuk zero. Failure interpretation: masih flagged setelah Google’s recrawl berarti either perbaiki tidak ship untuk langsung halaman, atau sebuah berbeda diperlukan property adalah juga missing — re-jalankan Test 1 terhadap langsung URL, tidak sebuah staging copy. Monitoring window: sebuah sedikit days up untuk roughly sebuah week untuk Google untuk recrawl dan refresh report — Search Console data lags langsung halaman. Rollback trigger: Tidak valid-items count rises setelah sebuah template rollout alih-alih dari falling — itu’s sebuah sign perubahan broke markup pada lainnya halaman menggunakan yang sama template; pause rollout.
Test 4: star snippet sebenarnya muncul di langsung SERP
Test untuk jalankan: sebuah manual penelusuran untuk sebuah kueri di mana halaman peringkat, memeriksa apakah star rating displays di bawah listing (sebuah privat/incognito window menghindari personalization skew). Yang diharapkan hasil: Stars dan sebuah rating count muncul di bawah hasil. Failure interpretation: Absence di sini, dengan sebuah “Valid” (terjemahan) “Valid” Search Console status, tidak sebuah failure untuk perbaiki — display adalah Google’s discretion, tidak guaranteed oleh eligibility. Absence combined dengan sebuah “Not eligible” (terjemahan) “Tidak eligible” atau manual-tindakan status berarti go back untuk Test 1 atau 3. Monitoring window: Google memberikan Tidak fixed timeline untuk display; periksa periodically di atas berikut weeks alih-alih expecting ini immediately setelah validation melewati. Rollback trigger: None pada markup side — ada tidak ada apa pun untuk roll back untuk sebuah display decision Google controls. hanya revert jika Manual tindakan flags halaman.
Ongoing KPIs untuk AggregateRating markup
Metric: Valid items count (Search Console Enhancement report)
Apa ini tells Anda: bagaimana banyak dari Anda eligible halaman saat ini memiliki error-free
AggregateRating markup — coverage side dari KPI.
cara pull ini: Search Console → Enhancements → relevant report (Product snippets
/ Merchant listings) untuk Anda situs.
Benchmark / realistic range: Tidak universal target — establish Anda own baseline dari
count dari halaman itu seharusnya carry markup (Anda total eligible-jenis halaman
count), dan track valid items trending toward itu angka.
Cadence: monthly, atau immediately setelah apa pun template/CMS perubahan touching review
markup.
Metric: Tidak valid/error items count (sama report) Apa ini tells Anda: bagaimana banyak halaman memiliki rusak diperlukan properties — quality side dari KPI, terpisah dari coverage. cara pull ini: sama Enhancement report, error/tidak valid bucket. Benchmark / realistic range: satu-satunya honest target adalah zero; apa pun nonzero count adalah sebuah nyata rusak halaman, tidak statistical noise. Cadence: monthly, dan selalu setelah sebuah deploy itu touches markup template.
Metric: CTR perubahan pada halaman itu gained star eligibility Apa ini tells Anda: apakah star snippet adalah sebenarnya translating ke lebih clicks untuk halaman itu now tampilkan ini, versus eligibility side alone. cara pull ini: Search Console performa report, filtered untuk affected halaman, comparing CTR untuk weeks sebelum dan setelah markup shipped (Search Console tidak cleanly isolate “clicks specifically from a star snippet,” (terjemahan) “clicks secara khusus dari sebuah star snippet,” so ini adalah sebuah sebelum/setelah proxy, tidak sebuah tepat attribution). Benchmark / realistic range: Tidak defensible fixed uplift angka untuk cite — establish Anda own pre-rollout CTR baseline pada yang sama halaman dan watch delta, since ini bergantung heavily pada kueri, position, dan pesaing’ own rich hasil. Cadence: monthly untuk pertama quarter setelah rollout, lalu quarterly.
Metric: ratingCount/reviewCount growth di atas time
Apa ini tells Anda: apakah sample size behind Anda average adalah genuinely growing —
sebuah flat atau shrinking count pada sebuah halaman claiming sebuah active review base adalah worth
investigating sebelum ini adalah worth marking up.
cara pull ini: Anda own review platform, CMS, atau database — whatever sistem adalah
sumber kebenaran markup pulls dari.
Benchmark / realistic range: track mentah growth terhadap Anda own history; ada Tidak
external benchmark untuk “how many ratings a page should have.” (terjemahan) “bagaimana banyak ratings sebuah halaman seharusnya memiliki.”
Cadence: monthly.
Uji pemahaman Anda: AggregateRating Schema
Five quick pertanyaan pada schema.org/AggregateRating, -nya diperlukan properties, dan self-serving-reviews aturan. Pick sebuah jawaban untuk setiap, lalu periksa.
Log perubahan
Diperbarui 8 Agu 2026.
Ringkasan editorial dan detail perubahan yang tercatat.Detail perubahan
-
Catatan perubahan terperinci saat ini tersedia dalam bahasa Inggris.
Perbandingan lengkap tidak tersedia — tidak ada cuplikan sebelumnya yang diarsipkan untuk revisi ini.
Diperbarui 17 Jul 2026.
Ringkasan editorial dan detail perubahan yang tercatat.Detail perubahan
-
Catatan perubahan terperinci saat ini tersedia dalam bahasa Inggris.
Perbandingan lengkap tidak tersedia — tidak ada cuplikan sebelumnya yang diarsipkan untuk revisi ini.