Product feed

In order to be able to recommend products, Synerise AI needs to know what products you are selling. You need to provide this information as an XML file written in the RSS or Atom standard.

The product feed should be built according to Google Merchant Center Help recommendations. Synerise supports the tags described there.

Two namespaces must be defined in the XML Prologue:

"xmlns:g="http://base.google.com/ns/1.0" xmlns:c="http://base.google.com/cns/1.0"

All tags that are defined by Google Merchant Center Help must be preceded with a g: prefix. The only tags that do not use the prefix are:

  • <title>
  • <description>
  • <name>
  • <link>
  • your custom tags that are not defined by Google Merchant Center Help

Obligatory tags:

<g:id>
<title>
<g:availability>
<g:product_type>
<g:price>
<link>
<g:image_link>
Tip: The more tags you include, the more precise our personalizations and recommendations will be.

Make sure that you don’t have any typos or missing prefixes in the tags (some prefixes are obligatory). Otherwise, these tags will be recognized as custom tags, not the specific attribute that they were supposed to be.

If you suspect that the following symbols: <, >, or & might appear within a tag, use the CDATA format.

Warning: It is important to keep a consistent product ID in page view events, transactional events and in the product feed. Otherwise, the recommendation frame will not display at all or the system will not register the purchase and/or it won’t be counted towards revenue.

Examples

RSS standard

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0" xmlns:c="http://base.google.com/cns/1.0">
    <channel>
        <title>Your Website</title>
        <link>http://www.example.com</link>
        <description>About your website</description>
        <item>

            <!-- The following attributes are always required -->
            <g:id>CLO-29473856-2</g:id>
            <title><![CDATA[Roma Cotton Rich Bootcut Jeans - Size 8 Tall]]></title>
            <g:availability><![CDATA[in stock]]></g:availability>
            <g:product_type><![CDATA[Women's Clothing ? Jeans > Bootcut Jeans]]></g:product_type>
            <g:price>59.50 USD</g:price>
            <link><![CDATA[http://www.example.com/clothing/women/Roma-Cotton-Bootcut-Jeans/?extid=CLO-29473856]]></link>
            <g:image_link><![CDATA[http://images.example.com/CLO-29473856-front.jpg]]></g:image_link>

            <!-- The following demonstrates the use of the 'sale price' attribute -->
            <g:sale_price>29.20 USD</g:sale_price>

            <!-- The following attributes are not required for this item, but supplying them is recommended if applicable -->
            <g:item_group_id>CLO-29473856</g:item_group_id>
            <name><![CDATA[Roma Cotton Rich Bootcut Jeans]]></name>
            <g:online_only>yes</g:online_only>
            <description><![CDATA[A smart pair of bootcut jeans in stretch cotton.]]></description>
            <g:condition>new</g:condition>
            <g:size>30</g:size>
            <g:quantity>10</g:quantity>
            <g:color><![CDATA[Navy]]></g:color>
            <g:shipping_weight>1 kg</g:shipping_weight>
            <g:manufacturer><![CDATA[Wonderful Jean]]></g:manufacturer>
            <g:brand><![CDATA[MS]]></g:brand>
            <g:mpn>B003J5F5EY</g:mpn>
            <g:gtin>5060155240282</g:gtin>
            <g:google_product_category>Women's Clothing > Jeans > Bootcut Jeans</g:google_product_category>
            <g:gender>Female</g:gender>
            <g:material><![CDATA[Jeans]]></g:material>

            <!-- The following demonstrates the use of the custom attributes -->
            <c:age_group><![CDATA[Adult]]></c:age_group>
        </item>
        <item>...</item>
        <item>...</item>
</channel>
</rss>

Atom standard

<?xml version="1.0" encoding="utf-8"?>
<feed xmlns:g="http://base.google.com/ns/1.0" xmlns:c="http://base.google.com/cns/1.0">
    <title>Your Website</title>
    <link rel="self" href="http://www.example.com" />
    <updated>2018-01-01CET10:10:30</updated>
    <entry>

        <!-- The following attributes are always required -->
        <g:id>CLO-29473856-2</g:id>
        <title><![CDATA[Roma Cotton Rich Bootcut Jeans - Size 8 Tall]]></title>
        <g:availability><![CDATA[out of stock]]></g:availability>
        <g:product_type><![CDATA[Women's Clothing ? Jeans > Bootcut Jeans]]></g:product_type>
        <g:price>59.50 USD</g:price>
        <link><![CDATA[http://www.example.com/clothing/women/Roma-Cotton-Bootcut-Jeans/?extid=CLO-29473856]]></link>
        <g:image_link><![CDATA[http://images.example.com/CLO-29473856-front.jpg]]></g:image_link>

        <!-- The following demonstrates the use of the 'sale price' attribute -->
        <g:sale_price>29.20 USD</g:sale_price>

        <!-- The following attributes are not required for this item, but supplying them is recommended if applicable -->
        <g:item_group_id>CLO-29473856</g:item_group_id>
        <name><![CDATA[Roma Cotton Rich Bootcut Jeans]]></name>
        <g:online_only>yes</g:online_only>
        <description><![CDATA[A smart pair of bootcut jeans in stretch cotton.]]></description>
        <g:condition>new</g:condition>
        <g:size>30</g:size>
        <g:quantity>10</g:quantity>
        <g:color><![CDATA[Navy]]></g:color>
        <g:shipping_weight>1 kg</g:shipping_weight>
        <g:manufacturer><![CDATA[Wonderful Jean]]></g:manufacturer>
        <g:brand><![CDATA[MS]]></g:brand>
        <g:mpn>B003J5F5EY</g:mpn>
        <g:gtin>5060155240282</g:gtin>
        <g:google_product_category>Women's Clothing &gt; Jeans &gt; Bootcut Jeans</g:google_product_category>
        <g:gender>Female</g:gender>
        <g:material><![CDATA[Jeans]]></g:material>
        <g:additional_image_link>http://images.example.com/CLO-29473856-side.jpg</g:additional_image_link>
        <g:additional_image_link>http://images.example.com/CLO-29473856-back.jpg</g:additional_image_link>
        <g:shipping>
            <g:country>US</g:country>
            <g:service>Standard Free Shipping</g:service>
            <g:price>0 USD</g:price>
        </g:shipping>

        <!-- The following demonstrates the use of the custom attributes -->
        <c:age_group><![CDATA[Adult]]></c:age_group>
    </entry>
    <entry>...</entry>
    <entry>...</entry>
</feed>
Note: If you use the xmlns:c prologue, you can add your own custom attributes to the product feed. In that case, additional parameters must be inserted in tags with the prefix c:.
...
<c:custom_tagName1>...</c:custom_tagName1>
<c:custom_tagName2>...</c:custom_tagName2>
...