*If you have any questions on the information in this article please don't hesitate to contact our Support team at firstname.lastname@example.org
Article Context currently enables publishers to gain unique insights into your content based on Author Name, Published Date and Category. Via our Analytics platform you can view metrics such as Engaged Page Views, % Exit and % New Visits in relation to these variables.
To find these reports, go to Reporting > Big Data Analytics Beta inside your Ezoic dashboard. Once inside Big Data Analytics go to “Content”:
Ezoic gathers this data from different html tags.
JSON-LD is the first script tag pulled from the html - and generally has author and published date information.
JSON-LD is an industry standard and more information can be found here: Json-ld. A very good resource is https://jsonld.com/ which has examples for the different json-ld formats for Articles, Blog Posts, etc.
This is an example of Article ld+json script tag you can use on your site.
And this is an example of a Blog Post ld+json script tag you can use on your site.
From the JSON-LD, we will extract the "author". Please note the different "author" structures between the Blog Post and Article examples above - we can either gather the information if the author is listed as a string ("author": "Patrick Coombe") or we find the "name" element of the author object:
What if there is no Json-ld?
We will also search other meta tags and html to get author information. The next standard used is the Open Graph protocol http://ogp.me/ to add metadata.
- This is an example from Open Graph for profile metadata for the author:
Author meta tag:
Author Sailthru metatags https://getstarted.sailthru.com/site/personalization-engine/meta-tags/
- The Author hyperlink rel=”author” indicates that a link is pointing to information about the author of a page or article. Link text will be used as the author name. In the example below, John Doe is recorded as the author.
- Reports can also be pulled by username. Please see this link for more information from Open Graph: https://developers.facebook.com/docs/reference/opengraph/object-type/article/ Note: username is usually a single name (first and last all lowercase like above example). Unfortunately, this can also come back as a full url like http://www.facebook.com/john.doe which will be stored as the author. This metatag is the last data we check for a site.
- Here is an example of a Profile username from Open Graph https://developers.facebook.com/docs/reference/opengraph/object-type/profile/
If there is no Json-ld we will also search other meta tags and html to get “published date” information.
- The Open Graph protocol http://ogp.me/ can be used to add metadata for article publish_time (check out this link for more info: https://developers.facebook.com/docs/reference/opengraph/object-type/article/)
This is an example using Open Graph for article publish_time:
- Published date can be found using meta tag date, for example:
- Here is an example from Sailthru for metatags https://getstarted.sailthru.com/site/personalization-engine/meta-tags/
If there is no Json-ld we also search other meta tags and html to get the “Category” information.
- The next standard used is the Open Graph protocol http://ogp.me/ to add metadata for each article section (more info here: https://developers.facebook.com/docs/reference/opengraph/object-type/article/). This is an example taken from Open Graph for article section:
- Whilst the following is an example using meta tags: