Skip to content

Offer Types

Marten Sievers edited this page Feb 2, 2021 · 3 revisions

Incito supports the following different types of offerings:

Single Product Offering

A single product offering is composed of one product only. Therefore, the offers title, description, price etc. are all identical to the individual product.

Special requirements

  • There are no special data requirements for this type of offering.

Multi-Product Offering

Multi-product offerings are composed of several products that are grouped by a shared group_id. As the offer represents multiple products, the title, description, price etc. are combined and represent all items in the offer. Therefore, typical multi-product offering contain price ranges and multiple product images.

Special reqirements

  • group_id: Multi-product offerings require the presence of a unique group_id on each product within the offering.

Product-Variation Offering

Minimum reqirements

  • group_id: Product-variation offerings require the presence of a unique group_id on each product within the offering.
  • is_variant: Every variant within the offer needs a boolean value indicating that it's a variation product.
  • color, size, etc: Every product in a variation offering needs to contain information about the specific feature in which it varies from the other (if exists the main item) products.

NOTE: If all products within a variant offer are marked as is_variant, Incito will show all products as they appear equally important, whereas Incito will only show the main item if 4 out of 5 items are marked as is_variant, indicating that they are a variation of the 5th product.

Best practices

  • Don't mix up group_id and id attributes. Use the id attribute to uniquely identify a single product, and use group_id to group together several products as a group.
  • Don't submit is_variant if your product is not a variant. If your product is similar to other products, but not specifically a variant, don't submit is_variant. Some examples of products that are not variants include assorted items (a suit consisting of a jacket and pants) or any other set of dissimilar items that are sold together (a set of bath accessories).
  • Don't use is_variant for unsupported variants. If your product varies by an unsupported attribute (such as car make and model), or if your product is a build-to-order custom good with a larger number of variants (more than 30), then don't use is_variant to indicate your variants.

Supported variant attributes

  • color
  • gender
  • size
  • size_system
  • material

Example:

items: [
    {
       id: 'AB23C',
       title: 'Galaxy S20 FE',
       color: 'Black',
       group_id: '447BDG',
       is_variant: true
    },
    {
       id: 'AB23D',
       title: 'Galaxy S20 FE',
       color: 'Red',
       group_id: '447BDG',
       is_variant: true
    }
]

Bundle Offering

Collection Offering

Support coming soon...