Integrate Wingify with PrestaShop
| This article covers the following: * Overview * Prerequisites * Configuration and Setup + Install the Module + Configure Wingify Settings + Configure E-commerce Settings * Verify Event Tracking in Wingify * PrestaShop Events Imported into Wingify * Recommended Best Practices * Troubleshooting * FAQs |
#Overview
PrestaShop is a popular open-source e-commerce platform known for its flexibility, ease of use, and a large library of customizable themes and modules. It empowers businesses of all sizes to create and manage fully functional online stores with minimal technical effort. This module streamlines the integration of Wingify with your PrestaShop store by automatically installing the Wingify SmartCode and enabling the tracking of key e-commerce events such as product views, cart additions, and purchases without requiring any manual code implementation.
Use Cases
- A/B Test Product Pages: Run experiments on product detail pages and use the automatically tracked Prestashop Product Viewed event to measure engagement or as a baseline.
- Optimize Add-to-Cart Funnel: Test changes to category pages or product listings and track Prestashop Product Added To Cart events as a primary goal.
- Improve Checkout Conversion: Run tests on cart or checkout pages and use the Prestashop Purchase event to measure final conversions and revenue impact.
- Analyze Cart Behavior: Understand user behavior by tracking Prestashop Cart Viewed and Prestashop Product Removed From Cart events.
- Personalize User Experience: Use tracked events to create segments for personalized campaigns targeting users based on their shopping behavior.
#Prerequisites:
Ensure you have:
- An active Wingify Data Platform account.
- Your Wingify Account ID.
- An active PrestaShop store and administrative access to your PrestaShop account to install and configure modules.
#Configuration and Setup
#Install the Module
- Click here to download the Wingify PrestaShop module.
- Log in to your PrestaShop account. In the admin panel, go to Improve > Modules > Module Manager.
- Click Upload a module, then drag and drop the downloaded .zip file or browse to select it. Once uploaded, click Configure.
#Configure Wingify Settings
In the PrestaShop admin panel, navigate to Improve > Modules > Module Manager.
Search for VWO and find the installed VWO module.
Click Configure next to the VWO module.
module-manager-new.png On the VWO Configuration page, locate the VWO Settings section.
Ensure the Enable VWO Integration toggle is switched to Yes.
Enter your VWO Account ID in the corresponding field.
Choose the SmartCode Loading Type. VWO recommends Asynchronous for faster page loads.
(Optional) Adjust the Settings Tolerance (ms) if needed. The default is 2000 ms. This is the maximum time Wingify waits for settings to apply.
Once you have configured SmartCode settings, click Save at the bottom right.
configure.png
#Configure E-commerce Settings
On the same VWO Configuration page, scroll down to the E-commerce Settings section.
Ensure the Enable E-commerce Tracking toggle is switched to Yes. This master switch controls all automatic e-commerce event tracking.
Under Event Tracking Options, check the boxes for the specific e-commerce events you want Wingify to track automatically:
- Product View: Tracks when a visitor views a product page.
- Add to Cart: Tracks when a product is added to the shopping cart.
- Remove from Cart: Tracks when a product is removed from the cart.
- Cart View: Tracks when a user views their shopping cart.
- Purchase: Tracks when a purchase is completed.
Once you have configured E-commerce Settings, click Save at the bottom right.
ecommerce-settings.png
#Verify Event Tracking in Wingify
After configuring and saving the settings in PrestaShop, Wingify will start tracking the selected events as users interact with your store.
- Log in to your Wingify account.
- From the main menu panel on the left, go to Data Platform > Events.
- PrestaShop events may initially appear under Unregistered Events.
- Perform the action on your PrestaShop store (for example, view product, add to cart, purchase).
- Return to the Events section in Data Platform> Events to check if the events are now visible.
- Select a particular event (for example, prestashop.productAddedToCart).
- Click Register Event.
- In the Register Event form, review the Event Name and modify it if required to make it user-friendly.
- Keep the API Name as is unless you have a specific reason for changing it.
- Add a Description to specify what the event does.
- Click Create.
This completes your registration. After you register for an event, it appears under the My Events section. - Repeat the steps for other events.
- Once you have registered all the events, you can create metrics based on these PrestaShop events to track conversions for your campaigns effectively.
Attention: Do not copy and paste the API codes of registered events onto your website. Doing so will duplicate event entries in Wingify and skew your reports.
#PrestaShop Events Imported into Wingify
The following are PrestaShop events that are imported into Wingify, along with their properties:
#Product Viewed
Wingify Event API Name: prestashop.productViewed
| Property API Name | Description |
|---|---|
| currency | The currency in which the product is priced (e.g., EUR, USD). |
| price | The price of the product at the time of viewing. |
| productCategory | The category or collection the product belongs to (e.g., men, women). |
| productId | The unique identifier for the product. |
| productSku | The stock-keeping unit used for inventory tracking of the product. |
| productTitle | The name/title of the product viewed. |
| productUrl | The complete URL of the product page being viewed. |
| variantId | The unique identifier for the specific product variant (e.g., size, color). |
#Add to Cart
Wingify Event API Name: prestashop.productAddedToCart
| Property API Name | Description |
|---|---|
| currency | The currency in which the product is priced (e.g., EUR, USD). |
| price | The price of the product at the time of viewing. |
| productCategory | The category or collection the product belongs to (e.g., men, women). |
| productId | The unique identifier for the product. |
| productSku | The stock-keeping unit used for inventory tracking of the product. |
| productTitle | The name/title of the product viewed. |
| productUrl | The complete URL of the product page being viewed. |
| quantity | The number of units of the product added to the cart. |
| variantId | The unique identifier for the specific product variant (e.g., size, color). |
#Removed from Cart
Wingify Event API Name: prestashop.productRemovedFromCart
| Property API Name | Description |
|---|---|
| currency | The currency in which the product was priced (e.g., EUR, USD). |
| productId | The unique identifier for the product. |
| productSku | The stock-keeping unit used for inventory tracking of the product. |
| productTitle | The name/title of the product removed from the cart. |
| variantId | The unique identifier for the specific product variant (e.g., size, color). |
#Cart Viewed
Wingify Event API Name: prestashop.cartViewed
| Property API Name | Description |
|---|---|
| currency | The currency in which the cart total is calculated (e.g., EUR, USD). |
| totalAmount | The total monetary value of all items in the cart. |
| totalQuantity | The total number of items in the cart. |
#Purchased
Wingify Event API Name: prestashop.purchase
| Property API Name | Description |
|---|---|
| currencyCode | The currency in which the purchase was made (e.g., EUR, USD). |
| discount | The discount amount applied to the order. |
| orderId | The unique identifier of the completed order. |
| productId | The unique identifier for the purchased product in CSV. |
| productPrice | The price of the individual product purchased in CSV. |
| productQuantity | The number of units of the product purchased in CSV. |
| productSku | The stock-keeping unit used for tracking the purchased product in CSV. |
| revenue | The total revenue generated from the purchase, including taxes and shipping. |
| shippingPrice | The cost charged for shipping. |
| totalPrice | The total price paid by the customer, including product price, tax, and shipping. |
| totalTax | The total tax amount applied to the order. |
#Recommended Best Practices
- Verify Account ID: Double-check that you have entered the correct Wingify account ID during configuration.
- Use Asynchronous Code: Keep the SmartCode Loading Type set to Asynchronous (default) for optimal website performance.
- Track Relevant Events: To avoid unnecessary data collection, enable tracking only for e-commerce events that are meaningful for your analysis and optimization goals.
- Register Events Promptly: Register the tracked events in Wingify Data Platform as soon as they appear to make them available for goal setup.
- Test Thoroughly: After the setup is complete, perform test transactions and interactions on your site to confirm all selected events are tracking correctly in Wingify Data Platform.
#Troubleshooting
| Issue | Solution |
|---|---|
| Wingify module not found in PrestaShop Module Manager. | Ensure you have uploaded/installed a version of the module that is compatible with your PrestaShop version. Check the source from which you obtained the module. |
| Wingify SmartCode is not loading on the site after configuration. | Verify the Enable VWO Integration toggle is on and the correct Wingify account ID is entered and saved. Clear your PrestaShop cache and browser cache. Check the website's source code to see if the Wingify snippet is present. |
| E-commerce events are not appearing in Wingify Data Platform. | Confirm Enable E-commerce Tracking is on in the module settings. Verify the specific event checkboxes (Product View, Add to Cart, etc.) you expect to see are checked and saved. Ensure you perform the correct actions on the live site to trigger the events. Check if the events appear under Unregistered Events in Wingify Data Platform and need registration. Use browser developer tools to check for JavaScript errors on pages where events should trigger. |
| Purchase event not tracking. | The purchase event typically tracks on the Order Confirmation/Thank You page. Ensure this page is loading correctly and the Wingify/PrestaShop setup is active on that specific page template. Verify the Purchase checkbox is enabled in the module settings. |
#FAQs
- Where do I find my Wingify Account ID?
Log in to your Wingify dashboard, navigate to Settings (gear icon) > Accounts. Your Account ID is listed there. - Does the PrestaShop module install the Wingify SmartCode, or do I need to add it separately?
The module installs the Wingify SmartCode automatically when enabled and configured with your Account ID. You do not need to add it separately. - Can I track custom events not listed in the module options (for example, newsletter sign-ups)? The module automatically tracks the predefined e-commerce events listed in its configuration. For other custom events, see Working with Events in Wingify.
- Do I need Wingify Data Platform to use this module?
Yes, the automatic e-commerce event tracking feature relies on Wingify Data Platform to receive and process the events. You need a Wingify plan that includes Data Platform.
#Need more help?
For more information or further assistance, contact Wingify Support.