Getting started with Voyado

This guide covers the Faslet to Voyado setup needed to sync Faslet properties to existing Voyado contacts.

Once the integration is active, Faslet updates Voyado contacts with sizing data collected during the popup flow. That data can then be used in Voyado for audience building, targeting, personalization, and other contact-based marketing workflows.

Requirements

A Faslet account and a Voyado account are both required for this integration.

Overview

The setup has four parts: account connection, contact attribute setup, storefront setup, and verification. Start by connecting the Voyado account Faslet should update. Next, create the contact attributes that will store Faslet data inside Voyado. Then update the storefront so Faslet can identify the correct Voyado contact when a shopper completes the popup. Finish by verifying that the Faslet properties are arriving in Voyado as expected.

Unlike the Klaviyo integration, Voyado does not have a cookie fallback. Faslet needs the Voyado contact identifier on the storefront to know which existing contact to update.

Account connection

Start by connecting the Voyado account Faslet should update for this store.

1. Go to the Faslet App Marketplace.
2. Change All stores, at the right side of the top bar, to the store being integrated. That store's service connections will appear.
3. Find Voyado and open the integration.
4. Enter the Voyado API key and client ID for the account Faslet should update.
5. Enable staging only when Faslet should send updates to a Voyado staging environment instead of production.
6. Save the configuration.

Contact attribute setup

Before the synced data can be used in Voyado, create the contact attributes that will receive the Faslet values.

Use this setup table when creating the attributes in Voyado:

Property	Key	Type
Height	fasletProfileHeight	Number
Weight	fasletProfileWeight	Number
Fit preference	fasletProfileFitPreference	Dropdown
Latest size recommendation	fasletLastSizeRecommendation	String
Serial returner	fasletSerialReturner	Checkbox

See Voyado data reference for the field descriptions and sync behavior.

If fasletProfileFitPreference is configured as a dropdown, add these values:

• tight
• slightly-tight
• average
• slightly-loose
• loose

Storefront setup

After the account connection is in place, update the storefront so Faslet can identify the correct Voyado contact when a shopper completes the popup.

Add the current shopper's Voyado contact identifier to the Faslet widget markup:

<faslet-app ... cdp-contact-id="CURRENT_USER_VOYADO_CONTACT_ID"></faslet-app>

Faslet uses cdp-contact-id as the external identifier for Voyado. The value should be the existing Voyado contact ID for the current shopper.

If the storefront does not render <faslet-app> directly, pass the same Voyado contact ID through the integration point used to initialize Faslet.

Verify the installation

After the connection is active, the contact attributes are created, and storefront setup is in place, run a quick live check to confirm that Faslet data is reaching Voyado.

Check a single contact

Use this method to confirm that contact updates are working for an individual shopper.

1. Open the relevant contact in Voyado.
2. On the storefront, make sure the current shopper session resolves to that same Voyado contact ID.
3. Open the Faslet widget from a supported product page.
4. Complete the popup sizing flow.
5. Refresh the Voyado contact and confirm that the Faslet attributes were added or updated.

Check whether the expected values arrived

Confirm that the contact attributes match the values collected during the popup, such as height, weight, fit preference, latest size recommendation, and serial returner status.

If the shopper completes the popup again later, Faslet can update the same contact attributes with the latest known values.