Summary
A single product listing can be displayed to a backer multiple times within their survey via a string of code that is added to the collection description via the app when surveys are created. This feature is used when a backer has pledged for multiple quantities of the same item.
This article is for reference only. No additional work is generally required during setup for this feature's implementation.
On this page:
Bundles with different products
Overview
Pledge levels offering multiple quantities of the same product generally require the use of the survey template's product bundle functionality for an optimal survey experience. Using some simple, custom code added by the app after survey creation, the survey template can repeat the number of times a product is displayed in a survey collection or add a pre-defined quantity of a product to the cart. Applicable instances of this feature are:
- Bundles with variants
- Bundles without variants
Pledge levels offering an assortment of different products bundled together as one can do not require the use of the product bundle code. Possible methods for such product bundles include:
- Individual products added to a survey collection
- One product listing being used to represent multiple items
Product bundle code
The survey template's product bundle feature allows product listings to be repeated in their display or add a predefined quantity of a product to the cart. The demos below show what a product bundle survey would look like for the following hypothetical surveys:
- Demo A: A backer pledged for two pairs of wool socks and can select different sizes/colors for each pair.
- Demo B: A backers pledge includes three of the same notebook.
Demo A repeats the product listing for Wool Socks twice, giving the backer the ability to make unique selections for each pair of socks.
Demo B adds the predefined quantity of three Notebooks to the backer's cart with a single click.
Note: These demo links are not active survey links and are only meant to show the product bundle functionality.
Code implementation
The product bundle function requires a custom string of code to be added to the description of a relevant survey collection. The custom string of code uses an item's product handle (see item 4) combined with the number of times that item should be repeated within that survey.
The structure of the code added to the collection description is:
<products_qty> [product handle] + [quantity of items to be offered] </products_qty>
The following demonstrates the code used for Demo A above:
<products_qty>wool-sock-2x</products_qty>
Where wool-sock is the product handle and 2x is the number of times the product is repeated. See below for a demonstration on locating the product handle at the bottom of the product editor (see edit website SEO) then adding the product bundle code to a survey collection for Demo A.
Bundles with variants
A pledge level containing multiple quantities of a product with variants requires a backer to select different product options for each expected quantity. Since reward items can only be added to the cart once on the survey template, the product bundle code is used to repeat how many times such items are available for a backer to add to the cart.
Demo A example
- A backer has pledged for two pairs of wools socks.
- The survey template repeats the Wool Socks products twice.
- Within this survey, a backer would first be prompted to select options for Wool Socks (1/2) then automatically prompted to select options for Wool Socks (2/2).
Bundles without variants
A pledge level containing multiple quantities of a product without variants can have predefined quantities of a product added to a backers cart during their survey. Such instances use the same product bundle code as those using variants but the survey experience is different.
Demo B example
- A backer has pledged for two notebooks.
- The survey template only shows the Notebook product one time but the title is ammended to show the quantity being added.
- When a backer clicks the 'select' button, three of the Notebook product will be added to the cart.
Bundles of different products
Pledge levels offering an assortment of different products most commonly use a different product listing to represent each product on Shopify then add each product to a survey collection. However, there may be some instances when a single product listing representing multiple items is necessary. The use of this method usually depends on how the items will be prepared for fulfillment.
Example
- A pledge level offered a notebook and a pen as a reward.
- The notebook and pen are not packaged together but a single product listing is used to represent both the notebook and the pen.
- In this example, a third-party fulfillment center would have to do what's called kitting which commonly requires an additional fee.
