This article covers the following:
- Overview
- Create an Automated Workflow in HubSpot
- Create a Manual Workflow in HubSpot
- Import HubSpot Lists Into Wingify
Overview
The Wingify-HubSpot integration allows you to import your HubSpot visitor lists into Wingify to precisely target audiences in your campaigns. This helps ensure your tests focus on relevant visitor segments, leading to more meaningful insights.
After you create an Import Lists from HubSpot connection in Wingify, you can import HubSpot visitor lists for precise targeting in your Wingify campaigns. Refer to Integrate Wingify With HubSpot to set up the connection.
However, due to HubSpot’s restrictions on accessing unique visitor IDs, Wingify offers a simple workaround:
- Create an event in HubSpot that Wingify can use to generate a unique UUID each time the event is triggered.
- Copy the event’s tracking ID and paste it into the Event Internal Name field on the HubSpot integration page in Wingify.
- Set up a workflow in HubSpot to assign the generated Wingify UUID to the corresponding visitor who triggered the event.
To import visitor data from HubSpot, you can choose from two methods:
- Create an automated workflow in HubSpot for imports.
- Create a manual HubSpot workflow.
Create an Automated Workflow in HubSpot
To streamline the integration process, Wingify offers an automation feature that eliminates the need to manually configure Custom Events and Workflows in HubSpot. This not only saves time but also reduces the risk of setup errors.
To enable automated workflow creation:
- When creating the Import Lists from HubSpot connection, toggle on Enable automated data sync.
- Click Authenticate Wingify on HubSpot to grant the necessary permissions.
- Enter a name in the Connection Name field and click Create Connection.
Once completed, Wingify automatically:
- Creates the required Custom Event and Workflow in your HubSpot account.
- Populates the Event Internal Name field with the associated tracking ID.
After this setup, proceed to Importing HubSpot Lists into Wingify.
Note: This automated setup requires additional permissions in your HubSpot account to create and manage events and workflows. If you prefer not to grant these permissions, you can manually configure the Custom Event and Workflow by following the steps provided in the next section.
Create a Manual Workflow in HubSpot
You can manually create the required custom event and workflow in HubSpot. This manual process enables Wingify to assign a unique UUID to each visitor who triggers the event, which can later be used for targeting and tracking in your Wingify campaigns.
Create a Custom Event in HubSpot
To create a custom event that allows Wingify to assign a UUID to a visitor:
- Go to your HubSpot dashboard.
- Navigate to Data Management > Custom Events > Create an event. In the modal that appears, select Send via API.
- On the event creation page, fill in the DETAILS section:
- Event name: VWO UUID
- Description: Briefly describe the purpose of the event
- Associated Object: Select Contacts
- In the PROPERTIES section, select the Custom string property, enter the property name as VWO UUID, and click Done.
- Click Done.
- In the TRACKING ID section, click Copy to copy the tracking ID and click Done
Paste the copied Tracking ID into the Event Internal Name field when creating the Import Lists from HubSpot connection in Wingify. Refer to Integrate Wingify With HubSpot for steps. At this point, any contact that triggers this event will receive a unique UUID from Wingify.
Create a Workflow in HubSpot
Now, create a workflow that attaches the generated UUID to the corresponding contact.
Part A: Set Up the Trigger
- Navigate to Automations → Workflows → Create workflow → From scratch.
- Choose a contact-based blank workflow, then click Next.
- On the workflow canvas, click Set up triggers.
- In the left panel, select When an event occurs under Enrollment.
- Click the box under the Group 1 filter to define your criteria.
- On the Add criteria panel that appears, select Wingify UUID under Custom events and click Done under Group 1.
- Define the filter criteria for contacts by clicking on the Add criteria button under the And contacts meet the following filter criteria section.
- On the Add criteria panel, go to Form Submissions > Select a form > Any form submission and click Done on the filter criteria section on the left pane.
- Click Save. Now, the left pane disappears, and the trigger has been added to the workflow.
- Click the trigger again, go to Re-enrollment, and enable Allow contacts to re-enroll after completing the workflow.
- Click Save.
Part B: Configure the Event Property
- On the workflow chart, click the + icon to add an action.
- From the left panel, select CRM > Set property value
- Configure the Target object as Contact (Current object).
- Under Property set to, select Create a new contact property
- In the Create a new contact property panel, configure the values as follows and click Next:
- Group → Contact information
- Label → Provide a name for the property.
- Under the Field type dropdown, select Single-line text, and click Next.
- Retain the default selection under Property visibility, and click Create. Now, the property is created.
- Now, you have to set the property's value. On the left pane, the Property to set field is configured to the property name.
- Click the text field labeled with your property name.
- In the Insert data panel that appears, configure as follows and click Save:
- View properties or action outputs from > VWO UUID
- Text Properties > vwo_uuid
- Click Review and publish.
- On the Review Workflow panel that appears, review the configurations and click the Turn on workflow button to publish the workflow.
With the workflow now active in HubSpot, Wingify will automatically associate a unique UUID with each contact who submits the form. This visitor data can then be imported into Wingify, allowing you to accurately track and target these contacts in your Wingify campaigns.
Import HubSpot Lists Into Wingify
To import your HubSpot visitor lists into Wingify:
- Go to Configurations > Integrations > HubSpot.
- Under Active Connections, find the Import Lists from HubSpot connection and click Manage Lists.
- In the Lists added to target visitors in Wingify panel, click Add list.
The panel displays your Attributes list quota usage and a list of imported lists showing List Name, Last Synced On, and Sync Status. To sync all lists, click Sync all. To sync an individual list, click the three-dot menu (⋮) > Sync next to the respective list
After you click Add list, Wingify starts to sync your HubSpot list. The initial sync may take up to 24 hours. List syncing continues automatically every 24 hours from the last sync.
Note:
- The number of lists you can add depends on your account’s Attributes List quota.
- Only data with the VWO UUID in its properties will be synced to Wingify. This means that data is added gradually. As visitors revisit the website, the VWO UUID will flow to HubSpot and be associated with the contacts. Once this association is established, the data will be able to be pulled into Wingify.
Target Your Wingify Campaign Using HubSpot Lists
You can leverage your HubSpot visitor lists to precisely target audiences in your Wingify A/B test campaigns. For example, if you want to test a new webpage layout on users who have previously engaged with your email campaigns, targeting this specific list allows you to measure how engaged users respond to the changes.
To set up HubSpot-based targeting in your Wingify campaign:
- Go to Web Experimentation in the dashboard, select your Wingify campaign and then the Configuration tab.
- On the Configuration page, go to Targeting. Under Segments, select Custom Segment.
- In the first dropdown, select HubSpot List.
- In the final dropdown, choose the specific HubSpot list you want to target.
- Click Save Segment to apply the targeting criteria. In the popup that appears, enter a name in the Segment Name field. Optionally add a description, and click Save
- Click Apply to apply the segment to the campaign.
Need more help?
For further assistance or more information, contact Wingify Support.