What: The VTEX connection allows you to enrich BlueConic profiles with data from VTEX customers and vice versa. This connection supports scheduled batch import.
Why: By importing data from VTEX to BlueConic, you can re-engage customers who have abandoned their shopping carts or left your site before completing their purchases. Use this connection to share first-party customer and order data from VTEX to your BlueConic profiles to better retarget customers data.
Configuring a VTEX Connection
Setting up the connection
In the setup tab of the connection, configure the following options to connect your VTEX account to your BlueConic tenant:
Account name - Enter the name of your VTEX account.
Application key - Generate an external system application key in your VTEX account. Application keys allow external systems to access your account and can only be created by users who have certain VTEX roles.
Application token - Enter your VTEX application token. Application tokens are available via the VTEX IO context and are associated with different permissions.
Importing data into BlueConic
To set up your import goal, configure the following:
Process your data before import
Optionally add one or more data processors that can perform various functions, such as transformation, filtering, manipulation, and more.Link identifiers between VTEX and BlueConic
Select identifiers between VTEX customers and BlueConic profiles. Check the "Allow creation of new profiles in BlueConic" option to enable the creation of new BlueConic profiles if an existing match is not found.Optional: Map VTEX data to BlueConic
Map the additional VTEX fields you want to import into BlueConic to the corresponding BlueConic profile properties.
Optional: Import Timeline events into BlueConic
You can choose to import customer event data to BlueConic using either prebuilt event types, or by creating a custom Timeline event type. You can map order details in the left column with order event properties, event date/time, and the event ID. Use the Add mapping button if you want to extend the mapping for each event to include additional, nested event details. If there are many event properties to be mapped, BlueConic detects these and offers the option to "Add all event properties to import."
Run the connection
Running the connection
At the top of Set up and run, turn the connection on and be sure to Save your settings. Then scroll to the settings in the Run history section. To start the import and export manually, click the Run now button. To schedule the import and export for a future date, click the Settings icon and select how to schedule the import by choosing an option from the drop-down list.
See Scheduling connections for more information on running connections.
Connection status
Once you've set up and saved your connection, the icon at the top of the window reflects the status of the connection. An arrow runs between VTEX to BlueConic, signifying the direction of the data import. When the arrow is green, the connection is ready to be used.
Privacy management
Connections can be added to Objectives, allowing for privacy management of the information that is being picked up. A connection will only process the profiles of visitors who have consented to at least one of the objectives that the connection is linked to.