Getting Started with Product Sync

Product Sync provides the ability to import, delete, and update content into your content library by linking to your Google product feed via a simple UI. Sailthru also offers two other approaches for importing customer products or content into the content library: the Content API and Javascript Spider.

Google product feed files are the primary data source that e-commerce websites use to display their products on Google. These feeds are maintained by our customers and are their own source of truth. Any updates in their feed file will be reflected in the Sailthru database or content library. For more information, see Google’s help.

This page will guide you on:

  1. Creating a source
  2. Editing a source
  3. Deleting a source
  4. How tags are created
  5. Adding custom tags
  6. Using Content API and Product Sync

Creating a Source

Using the Content navigation bar, click on Product Sync. It will redirect you to a new page which shows all the Google product feeds that have been uploaded recently.

After the name and URL for the feed, there are three columns give more information about your feed.

  • The Status column represents the current state of the uploaded GPF.
  • The Last Refresh column displays the last time a source had been re-imported or refreshed.
  • The Options column allows you to either configure or delete a source.

Note: The name and source URL fields are mandatory fields to create a new source.

  1. Click on the NEW SOURCE button on the top right corner.
  2. Add a unique name for your source in the Name field. Using a different name for each source will help distinguish sources from each other.
  3. Add the source URL for your GPF files in the Source URL field. This can be in XML or TSV format.
  4. Add any optional tags in the Tags for this sync field. This field allows users to define the tags that are added to each individual product from the source. If you are managing multiple sources, it will help to distinguish them from each other.
    • Example: Uploading two winter catalogs, clearance and new styles. Styles from each catalog (jackets, scarves, gloves, etc.) can be differentiated with tags.
    • Example: Recommending products based on currency, language, or region. With tags, customers in North America will only be recommended products in English and USD, while customers in Germany will only be recommended products in German and EUR.
  5. Once a new source has been created, it is immediately processed by one of the back-end services which starts the import process.
    • The source will automatically refresh every hour to check for updates or modifications, so you don’t have to add a new source each time.
  6. You will be redirected to the index page which displays the status of the source. An icon shows the status:
    • Hourglass – the source is being processed.
    • Green tick mark – the source was successfully uploaded or refreshed.
    • Alert – the source URL could not be located or an import error occurred. Hovering over the alert symbol displays the cause of the error and a suggested solution.

  7. Navigate to the Content Library page to see the contents uploaded by your source.

Editing a Source

If you accidentally entered the incorrect information for your source or simply want to update the fields, you can edit your existing source.

  1. Click the Edit button in the Options column.
  2. You will be directed to a new page showing the existing information for your source.
  3. Enter the new values for your source.
    • All form fields are editable. Changing the source URL or tag fields prompts a new import process.
  4. Click the Save button to save your changes.

Deleting a Source

When you delete a source, the content previously imported from the source will remain in your content library marked as expired. You can permanently remove them through the Content API.

  1. Click the Delete button of the source you want to remove.
  2. A pop up a dialog box will show to confirm your action.
    • Click Delete to delete a source.
    • Click Cancel to go back.

  3. After you click Delete, the source should disappear from the list.

How Tags Are Created

Each product in your GPF has product attributes which we process and group into tags. Tags are any attributes that describe the product which helps with categorization and easy location. Some example product attributes that we map to tags are:

  • Google product category
  • Condition
  • Color, size, and pattern
  • Gender and age group
  • Brand
  • Product type
  • Shipping options

It is important to note that not all content items will have these tags, as they are totally dependent on your Google product feed file.

Adding Custom Tags

Note: This step is completely optional.

By adding more tags in your products, Sailthru’s Personalization Engine will be able to better track and measure individual user interests.

  1. Using the tool or the application that you use to generate your Google product feed, add a new key field called sailthru_tags
  2. Enter the additional tags you want to add for the product in the value field
    • Each tag must use hyphens instead of spaces.
    • If multiple tags are used, each tag must be separated by a comma.
  3. Your generated Google product feed file should create a field similar to the example below.

XML Examples

<?xml version="1.0" encoding="UTF-8"?> 
<rss version="2.0">
 <channel xmlns:g="http://base.google.com/ns/1.0">
  <title><![CDATA[Google Shopping Feed for  https://www.myshoppingwebsite.com/.]]></title>
  <link>https://www.myshoppingwebsite.com/</link>
<item>
 <g:id><![CDATA[ST0000000000000000]]></g:id>
 <title><![CDATA[Some awesome product]]></title>
 <link><![CDATA[https://www.myshoppingwebsite.com/link-to-product]]></link>
 <g:price><![CDATA[11.2GBP]]></g:price>
 <description><![CDATA[Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.]]></description>
<g:google_product_category><![CDATA[3618]]></g:google_product_category>
 <sailthru_tags><![CDATA[tag,custom-tag-with-dashes,single-dash]]></sailthru_tags>
</item>
</channel>
</rss>

TSV Example


id     title   description   google_product_category   sailthru_tags
000    bag     awesome bag      1347                   pricey,bag-tag,custom-bag
001    train   awesome train    2012                   expensive,custom-train
002    car     awesome car      2134                   luxury,custom-car

Content API and Product Sync

Updates to Content API (such as, content_update and delete) are processed by a job which are not instantaneous, and its total processing time is unknown. Product Sync makes an automatic hourly schedule to check for updates to your Google product feed.

If you decide to use both the Content API and Product Sync to import your items into Sailthru, you might run into inconsistency issues with your data. This is because we don’t know the exact time Content API job and Product Sync will finish updating. Thus, whichever service gets to finish last, gets to overwrite the existing data, and update the content items.

We don’t recommend using both the Content API and Product Sync for importing your content to Sailthru. Please use either one to avoid inconsistencies with your data.

Top