Maintaining Structured Data
Audience: Technical - Light
Technical depth: ★★★☆☆
After you have live structured data, you should look at the Google Search Console periodically to monitor your site for structured data issues.
For more, see:
Monitoring structured data with Search Console (Google Webmaster Central Blog)
Google’s Search Console Help Center
Finding structured data on your PDPs
PDPs can have JSON-LD, microdata, both, or neither.
Locate JSON-LD in your PDP
Steps:
Open your PDP in a web browser.
Open your browser’s developer tools to view the page source.
Search for
ld+json
and check for relevance by looking at the value of the@type
key.Emplifi aggregate rating content includes:
"@type":"AggregateRating"
.
Locate microdata in your PDP
Steps:
Open your PDP in a web browser.
Open your browser’s developer tools to view the page source.
Search for
itemscope
and look at the value of theitemtype
attribute.Emplifi aggregate rating content has an
itemtype
value ofschema.org/AggregateRating
. You'll also seeitemprop="aggregateRating"
.Product content has an
itemtype
value ofschema.org/Product
.
Tools for troubleshooting
Google's Structured Data Testing Tool - Calls out errors and warnings for a URL or source code.
Rich Results Test - Identifies whether a page is eligible for relevant rich results in Google Search. For more, read the Google Search Console Help article on rich result status reports.
Checking your site
To test your site’s product detail pages using Google's Structured Data Testing Tool:
Visit a product detail page of your site that has review content.
Open your browser’s developer tools to view the page source.
Right-click the
<html>
node and select Copy > Copy Element (or similar).Click CODE SNIPPET, paste the page source, and then click RUN TEST.
When the results come back, look on the right side of the screen for any errors.
If you see errors, you may need to dig deeper into your markup to resolve structured data issues.
Error messages
These are the most common error messages related to aggregate reviews that appear in Google's Structured Data Testing Tool.
Thing is not a known valid target type for the itemReviewed property
Possible explanations:
The product page doesn’t have any structured data. Emplifi is using microdata, and therefore has no context for the rating and review data.
Solution: Add product microdata, and nest the review data under your product data.
The product page and the Emplifi review data both use microdata. But the review isn’t nested under a reviewable item.
Solution: Nest the review data under your product data.
The product data and the Emplifi review data use different structured data formats—one uses JSON-LD and the other uses microdata. Therefore, the structured data testing tool is unable to identify the product to associate the review with.
Solution: Ask your Emplifi Customer Success Manager to set your Emplifi aggregate rating structured data to the same format you’re using for product data.
Learn more:
Combining Emplifi microdata with your microdata in Working with Structured Data.
One of offers or review or aggregateRating should be provided
Possible explanations:
The product page doesn’t have any structured data. Emplifi is using microdata, and therefore has no context for the rating and review data.
Solution: Add product microdata, and nest the review data under your product data.
The product page and the Emplifi review data both use microdata. But the review isn’t nested under a reviewable item.
Solution: Nest the review data under your product data.
The product data and the Emplifi review data use different structured data formats—one uses JSON-LD and the other uses microdata. Therefore, the structured data testing tool is unable to identify the product to associate the review with.
Solution: Ask your Emplifi Customer Success Manager to set your Emplifi aggregate rating structured data to the same format you’re using for product data.
The product JSON-LD and the aggregate rating JSON-LD are not connected.
Solution: Connect your JSON-LD to Emplifi's JSON-LD with the
@id
key. To learn more, see Combining Emplifi JSON-LD with your JSON-LD in Working with Structured Data.
Learn more:
Combining Emplifi microdata with your microdata in Working with Structured Data.