UGC Techdocs
  • Introduction
  • Guides
    • Analytics
      • Tracking UGC on Adobe Analytics
      • Tracking Widget interactions with Google Analytics
    • Direct Uploader
      • How to add Custom Data to Direct Uploader
      • How to capture Custom Data on Direct Uploader
      • How to automatically tag data on Direct Uploader
      • How to Customize error messages on Direct Uploader
      • How to Track Direct Uploader form submissions with Google Analytics (Universal & GA 4)
    • Data Templates
      • Creating a Data Template
    • Rights via Registration
      • Capture Custom Data on Rights by Registration Form
      • Styling Rights via Registration Form
    • REST API
      • Caching REST API results for optimization
      • Posting content into Nosto via Tile API
      • Posting images into Nosto via Tile API
    • Onsite Widgets (2.0)
      • Blank Canvas
        • How to Use the Blank Canvas to Create a Twitter Count Widget
        • Creating an Auto-Scrolling Carousel using Blank Canvas
        • Creating Gallery Widget by Using the Blank Canvas Widget
        • Creating a simple Hover effect using Blank Canvas
        • Creating a Word Cloud using Blank Canvas
        • Creating Your Widget by Using the Blank Canvas
      • Bind your own Events
      • Creating a Grid Widget from Waterfall
      • Create a Q&A Widget using Data Templates
      • Displaying a Widget in a Mobile App
      • Dynamically Specify Products to Display in Widget
      • Dynamically specify what Tile to display in a Widget
      • How to add a title / subtitle to a widget
      • How to localize the load more button on widgets
      • How to overlay existing Google Map with the UGC Map Widget
      • How to use Filter and search in a Widget
      • How to change click on inline tile behaviour to redirect to PDP in a Widget
      • Styling cross-sellers on Grid and Carousel Widgets
      • How to Load External JS and CSS into Widgets
      • Profiling Widget Performance
      • Re-targeting with Widgets and Facebook Pixel
      • Render Widget filters dynamically
      • Styling Carousel Widget
      • Styling Grid Widget
      • Styling Masonry Widget
      • Styling Waterfall Widget
      • Styling Widget Expanded Tile
      • Styling Widget Shopspots
      • Using Web Fonts in Widgets
    • Digital Screens
      • Customizing Carousel Event Screen
      • Customizing Mosaic Event Screen
      • Customizing Scrollwall Event Screen
      • Customizing the Mosaic Event Screen to Have 9 Even Tiles
    • Email
      • Adding Location to an Email Tile
      • Styling the Email Widget
    • Integrations
      • DoubleClick
        • UGC Ads with Nosto and Google DoubleClick
      • Zapier
        • Consuming UGC Webhooks via Zapier
      • Mailchimp
        • Bring Social Content into a Mailchimp Campaign
    • Webhooks
      • Trigger notifications when content is in the moderation queue
  • Widgets
  • API Docs
    • JavaScript API
      • Widgets
        • Introduction
        • API Reference for Content Widgets
        • API Reference for Blank Canvas
        • API Reference for Map Widget
      • Digital Screens
        • Introduction
        • API Reference
    • Content API
      • Reference
    • REST API
      • Reference
        • Filters API
        • Moderation Views API
        • Tags API
        • Terms API
        • Tiles API
        • Users API
        • Widgets API
        • Automation Rules API
        • REST API Reference Widgets style and config
      • Best Practices
    • Webhooks
  • Enterprise Tools
    • Automation Rules
      • Triggers
      • Actions
      • Samples
    • Data Templates
    • User Access Control (UAC)
    • Single Sign On (SSO)
    • Enterprise Admin User Interface (EAUI)
    • Zapier
  • Commerce Tools
    • Product Feeds
    • Widget Implementation
    • Reporting
    • Integrations
      • Google Tag Manager
      • Magento
      • SalesForce Commerce Cloud
      • Shopify
      • Shopify Add To Cart
        • Global Variant Mapping for Add to Cart
        • Customise Add to Cart Widget Experience
  • Analytics
    • Google Analytics 4
      • Getting Started
      • Widgets Events
      • E-commerce Events
      • Email Events
  • Terms of Use
Powered by GitBook
On this page
  • Product Feed Settings
  • Feed Format
  • Providing Product Feed
  • Required Elements
  • Optional Elements
  • Validating a Feed
  • Update Frequency
  • Locales / Markets Configuration
  • Grouping Products across Locales
  • Locale Limits
  • Setting up your Feed

Was this helpful?

  1. Commerce Tools

Product Feeds

PreviousCommerce ToolsNextWidget Implementation

Last updated 11 months ago

Was this helpful?

This article is for Nosto UGC-only accounts, if you have a Nosto CXP account please refer to this .

Nosto's UGC offers the ability for Customers to create and update Product Tags within their Stack in an automated manner with our Social Commerce feature.

The feature can poll an XML Product Feed periodically, updating values such as Price, Description, Availability, and even supporting variances in Language or Locale.

To find out more about Configuring your Product Feed and UGC requirements, please read the guide below:

Product Feed Settings

Feed Format

Nosto's UGC Product Feed feature works with XML feeds which are based on Google's Product Merchant Feed type and Facebook's Product Catalogue Feed type.

Providing Product Feed

Nosto's UGC currently only supports providing a Product Feed from a publicly accessible URL.

Required Elements

The following elements are required to be included in your Product Feed for Nosto's UGC to be able to successfully synchronize the two systems:

<id> - String: Between 1 - 50 Characters. 
<title> - String: Between 1 - 150 Characters 
<description> - String: Between 1 - 1250 Characters 
<link> - URL: Between 1 - 250 Characters 
<image_link> - URL: Between 1 - 250 Characters 
<availability> - Options: 'in stock', 'out of stock', 'preorder' 
<price> - String: Between 3 - 20 Characters

Optional Elements

Nosto's UGC can accept a range of additional fields in your Product Feed and append this to the Product Tag within your Stack. For the most common additional Fields, Nosto's UGC expects them to be in the following format:

<condition> - Options: 'new', 'refurbished', 'used' 
<shipping> - SubElements: 'country', 'service', 'price' 
<expiration_date> - dateTime 
<brand> - String: Between 1 - 70 Characters 
<gtin> - String: Between 1 - 50 Characters 
<mpn> - String: Between 1 - 50 Characters 
<product_category> - String  Between 1 - 250 Characters 
<product_type> - String: Between 1 - 250 Characters 
<additional_image_type> - String: Between 1 - 250 Characters 
<gender> - Options: 'Male', 'Female', 'Unisex' 
<age_group> - Options: 'Newborn', 'Infant', 'Toddler', 'Kids', 'Adult' 
<color> - String: Between 1 - 25 Characters 
<size> - String: Between 1 - 25 Characters 
<item_group_id> - String: Between 1 - 50 Characters 
<sale_price> - String: Between 3 - 20 Characters 
<sale_price_start_date> - dateTime 
<sale_price_end_date> - dateTime

Validating a Feed

Update Frequency

Nosto's UGC offers the ability to Update / Synchronise your Product Feeds based on the following schedules:

  • Daily

  • Weekly

  • Manual

Locales / Markets Configuration

Grouping Products across Locales

Nosto's UGC offers the ability to store variance information for different locales (ie. USA / CAN-FR / CAN-EN) within a single Product Tag, allowing customers to show different information (ie. Name, Description, Price, URL) via UGC Widgets.

For Nosto's UGC to group/link these variances from different feeds, the same external product ID must be used across each of the connected feeds.

To configure widgets to show the correct variance information the field <data-tag-group> - String: Between 1 - 50 Characters should be added to the Embed code of the Widget. The field needs to be populated with the relevant Product Group configured in Settings > Product Feeds.

Find below an example Embed Code used to deploy a widget that should display product information for a feed with Product Group Name = CAN-FR:

<!-- Nosto's UGC Widget Embed Code (start) --> 
<script> 
    var stackWidgetAssetPath = '//widgetapp.stackla.com/'; 
    var stackWidgetDomain = 'widgetapp.stackla.com'; var stackWidgetCustomData = {}; 
</script> 
<div class="stackla-widget" 
     data-ct="" 
     data-hash="xxxxxxx" 
     data-id="81494" 
     data-title="Carousel MMS Test" data-ttl="60" 
     data-tag-group="CAN-FR" 
     style="width: 100%; overflow: hidden;"
></div> 
<script type="text/javascript"> (function (d, id) { var t, el = d.scripts[d.scripts.length - 1].previousElementSibling; if (el) el.dataset.initTimestamp = (new Date()).getTime(); if (d.getElementById(id)) return; t = d.createElement('script'); t.src = '//widgetapp.stackla.com/media/js/widget/fluid-embed.js'; t.id = id; (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(t); }(document, 'stackla-widget-js')); 
</script> <!-- Nosto's UGC Widget Embed Code (end) -->

If the field <data-tag-group> is not included in the Embed code the product will default to its primary variance information.

Locale Limits

Nosto's UGC does not enforce any limits around the number of different locale variances that can be stored on a single Product Tag.

Setting up your Feed

To set up your Feed, you will need to go to UGC Settings > Product Feed and select Add Product Feed.

Here, you will be presented with the opportunity to define:

  • Product Group Name: This is where you define the ID you wish to use for your various locales/markets (ie. USA, CAN-FR, CAN-EN)

  • Connection Type: URL or SFTP

  • SFTP Details: Host, Port, Username, Password

  • Product Feed URL / Path: URL / Path for specific Feed

  • Excluded Product Behaviour: This is where you define how UGC should handle products that exist in UGC but are excluded from the product feed.

    • Skip Status Update (default option): When this option is selected, the status of all the products that are in UGC but are not in the product feed at any given point is not updated.

    • Mark as Out-of-Stock: When this option is selected, the status of all the products that are in UGC but are not in the product feed at any given point is updated to Out-of-Stock.

  • Update Frequency: How often UGC should poll the feed to look for changes.

Nosto's UGC offers an XSD which Customers can use to Validate their Feed Structure or Build their Feed. This XSD is available .

here
article
Product Feed Settings
Locales / Markets Configuration
Setting up your Product Feed
Back to Top