What is Syncing Recommended Product Items?

These are the values Perfitt reads from your product page. Decide which items to pass and write them in the Synced Items & Sync Method tab of the installation request form. How each is read is decided in Sync methods, and the form is listed under Prerequisites. Items are read only on product pages (PRODUCT type).

1Product page

Values your product page already has.

productIdbrandmodelNogendercustomerIdproductNameimage

2Perfitt script reads them

You decide where each value is read from.

CSS SelectorJSON-LDwindow variableURL queryBrowser storageFixed value

See reading methods

3Perfitt finds the product

Looks it up in the Perfitt product DB by brand and modelNo. Products not in the DB are sent for registration automatically.

4Button and recommendation

The Perfitt button appears on the product page, and customers who measure get a size recommendation.

Synced items

Available features depend on which items you sync. Decide them with your Perfitt contact.

Item	Required	Description
`productId`	Required	The value that identifies a product within your site. It is the key that links to Perfitt products; without it, the button does not appear.
`brand`	Conditionally required	The product's official English brand name (or manufacturer). - Passed together with `modelNo`, Perfitt finds the product in its database and recommends right away; products not in the database are automatically submitted for registration. - Single-brand stores set it as a fixed value.
`modelNo`	Conditionally required	The manufacturer's unique model number for the product. Used together with `brand`.
`gender`	Recommended	Which gender the shoe is made for. Pass `f` (women) or `m` (men); it is taken into account when recommending.
`customerId`	Conditionally required	A value that identifies your member. You decide whether to use an auto-generated numeric ID, an email or a nickname; it is collected only while signed in. - Not required for the feature itself, but needed to match orders and returns of Perfitt users. How to confirm purchases - When synced, a returning member who signs in again gets a recommendation from their earlier measurement right away.
`productName`	Recommended	The product name as shown on your site. Used wherever product information is shown, such as the recommendation result screen.
`image`	Recommended	URL of the main product image. Shown on the measurement and recommendation result screens.
`productNo`	Optional	The product management number you use internally. Used to find products in the partners admin.

How to read the Required column

Required: without it, the button does not appear.

Conditionally required: brand and modelNo work when passed together. customerId is needed to match orders of Perfitt users.

Recommended · Optional: everything works without them, but they are used on result screens and for management.

All values are strings.