Articles in this section

Setting up your Product Feed

Avatar
Publitas Support
  • Updated
Available_in.png Gold Enterprise


To enable the Product Feed integration you can import all product details into your account's editor using an XML or TSV product data feed. Before submitting a feed, we highly recommend running through the specifications below to ensure your feed is properly formatted.

In this article:

 

Supported hosting formats

Publitas imports the product data directly from the external address the feed is hosted on.

mceclip0.png

The following feed URL types are supported for linking your feed to Publitas:

  • HTTP, for example: http://hosting.domain.com/feed.tsv
  • HTTPS, for example: https://hosting.domain.com/feed.tsv
  • FTP, for example: ftp://hosting.domain.com/folder/publitas_product_feed.tsv
  • SFTP, for example: sftp://user:password@hosting.domain.com/folder/publitas_product_feed.tsv

Besides the supported protocols, please also consider the following aspect in order to import your feed successfully:

  • No user-agent restrictions should be set.
  • Traffic from the EU should not be blocked.
  • The feed URL does not redirect traffic in any way.
  • When using SFTP, make sure the password only contains URL safe characters (so no reserved characters, like & or *). If required, we can set up an SFTP location for you. For more information, contact support@publitas.com.
  • Push the latest feed to the same location, under the same file name to avoid the feed URL changing after each update.

If you are using Lengow or Channable as your feed management tool, you can select Publitas as a channel to generate a feed URL for your online publications.

 

UTF-8 Encoding

The content of the feed needs to be UTF-8 encoded. This also means that special characters will have to be converted to their UTF-8 counterpart. For example. the ampersand & needs to be converted to &

Click here to find a list of special characters and their UTF-8 entities.

 

Using an XML feed

Find the full overview and details of the supported XML attributes in Supported Feed Attributes

  • Apply the RSS 2.0 formatting and UTF-8 encoding

  • You can also enclose content in CDATA in which case, special characters do not have to be encoded. For example:

      Without CDATA: <g:title>Bed &amp; Breakfast</g:title>
      Enclosed in CDATA: <g:title><![CDATA[Bed & Breakfast]]></g:title>

  • Here is a link to a working XML Product Feed
Example of the RSS 2.0 formatting in an XML feed:
 
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <item>
     <g:id><![CDATA[A12345]]></g:id>
     <title><![CDATA[Product title]]></title>
     <description><![CDATA[Product description]]></description>
     <g:price><![CDATA[1999.00 EUR]]></g:price>
     <g:sale_price><![CDATA[1499.00 EUR]]></g:sale_price>
     <link><![CDATA[https://www.example.com/product.html]]></link>
     <g:availability><![CDATA[in stock/out of stock/preorder]]></g:availability>
     <g:image_link><![CDATA[https://www.example.com/image1.jpg]]></g:image_link>
     <g:additional_image_link><![CDATA[https://www.example.com/image2.jpg]]></g:additional_image_link>
     <g:additional_image_link><![CDATA[https://www.example.com/image3.jpg]]></g:additional_image_link>
     <g:additional_image_link><![CDATA[https://www.example.com/image4.jpg]]></g:additional_image_link>
     <g:additional_image_link><![CDATA[https://www.example.com/image5.jpg]]></g:additional_image_link>
     <g:additional_image_link><![CDATA[https://www.example.com/image6.jpg]]></g:additional_image_link>
    </item>
  </channel>
</rss>

 

Using a TSV feed

Find the full overview and details of the supported TSV attributes in Supported Feed Attributes

  • This format requires a tab-delimited text file (.tsv or .txt) hosted on an external service according to the following specification.
  • The first line (or first row) contains the attributes names using lower case letters only.
  • All other lines contain the specific values for the separate products.
  • The attributes and the product details are separated by a tab (avoid using tabs for reasons other than separating the individual values).
  • Combine up to 5 additional images under the additional image link attribute, by separating the different URLs with a comma (no space).
  • If automatic updates is not a requirement (yet), you can use Google Sheets to create and host a TSV feed. This process works with tab separated values (TSV), comma separated values (CSV), Excel files or by pasting all product data in Google Sheets directly.
  • Here is a link to a working TSV Product Feed

 

Using HTML to apply styling to descriptions

Using HTML the content of the description attribute can be styled. For this, the following HTML methods are supported:

  • <h1> = Heading 1
  • <h2> = Heading 2
  • <h3> = Heading 3
  • <p> = Paragraph
  • <small> = Smaller text
  • <a> = Hyperlink
  • <ul> = Unordered list (bullets)
  • <li> = List (numerals)
  • <b> = Bold text
  • <em> = Emphasised text (italics)
  • <strong> = Important text (more distinct than bold & italics)
  • <sup> = Superscripted text
  • <sub> = Subscripted text
  • <u> = Some text that is unarticulated % styled differently from normal text (eg. underline, but distinct from a hyperlink)
  • <br> = Single line break (doesn't need styling)
  • image = Add an image: <div><img src="IMAGE_URL" alt="ALT_TITLE" width="###" height="###" /></div>

All other HTML is sanitized to avoid conflicts with embed page css or risk breaking the modal window.

Example:
mceclip0.png

NOTE: HTML cannot be used to style product titles. If HTML is present it will be converted to plaintext:

Screenshot_2019-02-22_at_11.37.34.png

 

Troubleshooting your product feed

Are you having issues importing your product feed successfully? Check out Troubleshooting your product feed or contact our Support team at support@publitas.com

Related articles