Skip to content

What are the feed specifications?

Marten Sievers edited this page Feb 1, 2021 · 1 revision

Supported feed formats

Incito requires a dedicated product/campaign feed on a per publication basis. The supported formats include both JSON (.json) and XML (.xml) formats and are detected automatically and converted. An example feed of such can be found here.

Product feed specifications

Basic product data

The product information you submit using these attributes is our foundation for creating your Incito publication. Make sure everything you submit is of the quality you'd show to a customer.

Attribute Format Minimum Requirements
id Required
Your product's unique identifier

Example
A42B89

Syntax
Max 50 characters
  • Use a unique value for each product. Use the product's SKU where possible
  • The ID is used for identifying which product data to update when the feed changes
  • Use the same ID for the same product - across countries or languages where possible
title Required
Your Product's name

Example
iPhone 11 Max

Syntax
Max 30 characters
  • Accurately describe your product and match the title from you landing page
  • Don't include promotional text like free shipping, quantities, all capital letters, or gimmicky foreign cahracters.
description Required
Your product's description

Example
Made from 100% organic cotton, this classic red men's polo has a slim fit.

Syntax
Max 100 characters
  • Accurately describe your product and match the description from your landing page
  • Don't include promotional text like free shipping, all capital letters, or gimmicky foreign characters.
  • Include only information about the product. Don't include links to your store, sales information, details about competitors, other products, or accessories.
  • Use formatting (for example line breaks, lists, or italics) to format your description
link Required
Your product's landing page

Example
https://www.example.com/shop?cat=12&id=1030
  • Use your verified domain name
  • Start with http or https
  • Use an encoded URL that complies with RFC 2396 or RFC 1738. For example, a comma would be represented as "%2C%"
image Required
The URL of your product's main image

Example
https://www.example.com/image1.png

Supported types
JPEG (.jpg/.jpeg) format, PNG (.png) format
For the image URL:
  • Link to the main image of your product
  • Start with http or https
  • Use an encoded URL that complies with RFC 2396 or RFC 1738. For example, a comma would be represented as "%2C%"
  • Make sure the URL can be crawled by 3rd party services
category Required
The main product category

Example
Electronics
  • Official product category that accurately describes the type of product that is being offered
  • Don't include the entire category tree but only the most parent category value

Price & availability

These attributes define the price, unit, quantity, and visibility of your products. This information is shown to potential customers based on their existence. If you provide savings, they will automatically show up in Incito. If you provide a membership price, it will automatically replace the regular sale price.

Attribute Format Minimum Requirements
price Required
Your product's price

Example15.00 DKK

Syntax
Numeric
  • Accurately submit the product's price and currency and match with the price from your landing page
  • Don't submit a price of 0 (a price of 0 is allowed for mobile devices sold with a contract or promotional offers that should show without a price)
  • For products sold in buld quantities, bundles, or multipacks, submit the total price of the minimum purchasable quantity, bundle, or multipack
  • Include value added tax (VAT) or Goods and Services Tax (GST) in the price
per_unit Optional
The unit of your products price, if the product is sold in a bundle or multipack

Example
Piece

Supported values
Month, Piece, Set
  • Accurately submit the price units and match with the unit sold on your products landing page
membership_pricing Optional
Your product's membership price

Example
10.00 USD

Syntax
Numeric
  • Accurately submit the product's membership price, and match with the membership price from your landing page
  • Don't submit a memberhsip price of 0
  • For products sold in buld quantities, bundles, or multipacks, submit the total membership price of the minimum purchasable quantity, bundle, or multipack
  • Include value added tax (VAT) or Goods and Services Tax (GST) in the price
savings Optional
Your product's savings compared to it's regular price

Example
100.00 DKK

Syntax
Numeric
  • Accurately submit the product's savings amount, and match with the savings from your landing page
  • Don't submit a savings of 0.00 DKK
  • For products sold in bulk quantities, bundles, or multipacks, submit the total savings of the minimum purchasable quantity, bundle, or multipack