Product Feeds

In Integrations / Product Feeds, we can configure our product feeds. We can have different assistants pointing to different product feeds so they will use different products.

Multiple feeds are only available in selected plans.

For example, when only one feed is configured, the view will be similar to this one:

We see the name of the feed, the source (Shopify in this case), if it is configured daily, and the last fetch time. We also see some buttons to configure the feed , edit its products , and fetch them .

Fetching the products

We can click on the button to fetch products from the feed and import them in Pickzen. This action will also update your assistants configured to use this feed.

Changing the feed name

Click on thebutton and enter the name by clicking on its current title:

Importing variants

If the feed allows variants, you can import the variants as products. Click on thebutton and check Import variants:

Daily sync

We can configure a daily time to update the feed of products from the feed. Click on thebutton, check Fetch products daily and select the assistants you want to be daily updated:

Showing results in Shopify

It is possible to show the recommended products in the Shopify store itself instead of the Pickzen results page. For it, you have to create a Shopify Liquid template that will be displayed as a part of the online Shopify store's theme. Pickzen will redirect to that page passing the following parameters that the Liquid template can use to render the results:

%header% Customized text by quiz.
%pzids% List of recommended product IDs separated by comma.
%pzhandles% List of recommended product handles separated by comma.
%pzselections% User response IDs separated by comma.
%pzslots% Slot titles separated by comma.
%pzuseid% User session execution ID to be used in API requests.

The technology behind this functionality is Shopify App proxy. Refer to Shopify documentation to know more.

The results Liquid template is defined in the Advanced section. Click on thebutton and open the Advanced section:

As an example, you can enter this template:

In this example, we are transforming the pzhandles parameter in an array on which we iterate to render each product through the product-item snippet.

Once defined the results template, we need to configure the Assistant to redirect to Shopify. Simply, enter into the end slide settings and enable Show results in Shopify:

We can optionally set a customized text that can be shown in the template through the header parameter, for example:

Try to minimize or avoid if possible the header text passed to the template because the information available to pass to the liquid template, including the recommended products, is limited.

Editing the products

Products fetched from the feed can be edited by clicking on the edit products icon. A panel with the current products in Pickzen is displayed:

Here you can add new products, delete products or edit them. In order to edit a product click on the pencil icon next to the product when hovered:

Once clicked the product editor will be displayed:

Here you can edit the product properties and attributes.

The fields you can modify are:

• ID: The unique identifier of the product.

• SKU: Stock-keeping unit.

• Name: The name of the product that will be displayed in the recommendations.

• Vendor: The vendor of the product.

• Price: The price of the product without the currency. The currency has to be defined in general settings.

• Boost: The boost is used to sort the recommended products. If you want a product to be recommended first, give it a greater boost. The default boost for all products is 1.0.

• URL: The external URL of the product is where the user can see more information when the recommended product is clicked.

• Image: The URL with the image of the product.

• Description: The text with a description of the product. This description can be shown along with the recommendations.

Once you have edited your products, click on the Update feed button to save the changes:

Updating the feed only updates the products in Pickzen. Your store products will never be updated.

Keep in mind that the next time you fetch the products from the feed, your changes will be overwritten with the actual feed product values. In order to avoid this, you need to pin the fields that you don't want to be overwritten:

Products that you create manually will always be deleted the next time products are fetched from the feed unless the feed includes those product IDs.