Dynamic products catalog

Synerise allows you to automatically build your product catalog based on specific <meta> tag values included in your page source.

When a page event is sent, the data it includes about OG tags is stored in a special catalog.

The name of the property is defined in the property attribute, and the value in the content attribute.

Example:

<!-- "product" is the mandatory og:type for use with dynamic products catalog -->
<meta property="og:type" content="product">

<!-- the mandatory unique product ID, the Stock Keeping Unit (SKU), must be the same as the one sent to the cart/basket -->
<meta property="product:retailer_part_no" content="112233">

<!-- a product's photo -->
<meta property="og:image" content="https://example.com/photo/product_image.jpg">

<meta property="og:title" content="product_name">
<meta property="og:site_name" content="Example Site">
<meta property="og:url" content="https://example.com/product_site.html">

<!-- multiple categories are allowed -->
<meta property="product:category" content="category1_name">
<meta property="product:category" content="category2_name">

<meta property="product:price:amount" content="1,000.00">
<meta property="product:sale_price:amount" content="800.00" />
<meta property="product:original_price:amount" content="1,000.00">

You can add custom information that you want to keep in the catalog:

<meta property="product:customName1" content="customValue1">
<meta property="product:customName2" content="customValue1">
<meta property="product:customName3" content="customValue1">

Using the inserts mechanism, you can refer to a catalog and retrieve all information contained in it.

You can find out more about og:tags on the Open Graph website.

OG tags in regular websites

A page.visit event is sent automatically every time a page is opened/refreshed.

OG tags in single-page applications

If your page is a single-page application, the SDK is initialized only once. This means that page.visit events must be sent on-demand by your implementation.

The way the event must be sent depends on how you implement OG tags in the page:

• OG tags are injected into the source of the page and available for retrieval with JS.
• OG tags are not available and must be explicitly included in the page.visit event.

Single-page with OG tags

If you inject the OG tags into the source of the page, they will be read and sent to Synerise when you call the following method:

SR.event.pageVisit()

No additional parameters are needed.

Single-page without OG tags

If the OG tags are not included in the source of the page, you must send them as an additional ogTagsattribute of the page.visit event. The attribute is a stringified JSON object.

The following example sends five OG tags with the page.visit event.

SR.event.pageVisit({
    "ogTags": JSON.stringify({
        "og:type": "product",
        "product:retailer_part_no": "87247894536",
        "og:site_name": "shoeStore",
        "og:title": "Red Sneakers LUE42",
        "product:color": "Red"
    })
})