WingifyGuides

Set Up the Wingify Shopify App

This article covers the following: * Install the Wingify App for Integration in Shopify * Configure the Wingify App + Connect Your Store to Wingify + Install the Wingify SmartCode on Your Website + Enable and Register Standard Shopify Events in Wingify + Configure Events to be Exported to Wingify + Wingify Cookie Consent Settings + Advanced Code Option (Optional) * Shopify’s Standard Events Imported Into Wingify

The Wingify Shopify app seamlessly integrates your Shopify account with Wingify, securely transferring Shopify’s standard events. It simplifies checkout tracking by supporting checkout extensibility using pixels for data transfer.

LIMITATIONS: 

  • This app does not cater to Insights Goals and Funnels for Non Data Platform accounts.
  • Owing to Shopify's security-based limitations, the Wingify SmartCode will not be placed on the Checkout, Post Purchase, and Order Status pages. Therefore, you cannot include these pages in any of your Wingify campaigns.

#Install the Wingify App for Integration in Shopify

  1. Click on this link to access Shopify’s Wingify app for integration.

  2. Click the Install button.

  3. On the Install app page for Shopify’s Wingify app that appears, review the access information required for Wingify to facilitate the integration. If you wish to proceed, click the Install button.

    Note: The mentioned scope of PII in the screen is a standard requirement from Shopify. Wingify does not store any PII information on our server.

#Configure the Wingify App

Perform the following steps to prepare the app for connecting your Shopify store to your Wingify account:

  1. Connect your Shopify store to your Wingify account.
  2. Install the Wingify SmartCode and enable Shopify event tracking.

#Connect Your Store to Wingify

  1. On the Wingify app page, enter your Wingify Account ID in the VWO (Wingify) Account ID field.
  2. Click Connect Store.
  3. Once the connection is established, proceed to install the Wingify SmartCode.

#Install the Wingify SmartCode on Your Website

Perform the following steps directly if you have not already installed the Wingify SmartCode on your website (your Shopify online store). You can skip to this section if you have already installed the SmartCode. However, we recommend manually removing the code and performing the following steps:

  1. On the app's page, ensure that your store is connected to your Wingify account.
  2. On the Activate SmartCode page, select the preferred code loading method, configure the load timeout, and optionally enable a custom tracking domain. Click Save changes.
  3. Click Activate SmartCode.

This installs the Wingify SmartCode on all your website pages except the Checkout, Post Purchase, and Order Status pages.

#Enable and Register Standard Shopify Events in Wingify

Note: For Shopify event tracking to work correctly, ensure:

  • You have installed the Wingify SmartCode on your website.

  • At least one test campaign is actively running in your Wingify account on the Shopify domain where you want to complete the integration setup and verify the event registration.

  • The UUID cookie is present in the visitor's browser. The cookie name depends on when your account was created:

    Account created Cookie name
    Before June 14, 2026 _vwo_uuid
    On/After June 14, 2026 _wingify_uuid

To use Shopify's standard events to run your campaigns in Wingify, you can simply integrate your Wingify account with the app to start streaming them. These events can be used in tracking metrics and target visitors  for your campaigns

  1. On the app’s page, verify that your store is connected to your Wingify account and that the Wingify SmartCode is active.

  2. Click Activate Tracking in the Send your standard events from Shopify to VWO (Wingify) section**.**

    After you activate tracking, standard Shopify events start flowing into your Wingify account when users begin performing those events on your site.
    For example, when someone adds a product to their cart, completes a purchase, or views a product, the corresponding event (such as shopify.add_to_cart or shopify.purchase) appears automatically in the Unregistered Events section (Data Platform > Events > UNREGISTERED EVENTS) of your Wingify dashboard. You need to register these events to use them to target your campaigns.

  3. To register these Shopify events, navigate to Data Platform > Events > UNREGISTERED EVENTS.

  4. Select a particular event (for example, shopify.purchase).

  5. Click Register Event.

  6. In the Register Event form**,** review the Event Name and modify it if required to make it user-friendly.

  7. Keep the API Name as is unless you have a specific reason to change it.

  8. Add a Description to specify what the event does.

  9. Click Create.
    The event is now registered and appears under the MY EVENTS section.

  10. Repeat the registration process for the remaining events.
    Once you have registered all the Shopify events, you can create metrics based on them 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.

#Configure Events to be Exported to Wingify

Depending on your requirements, you can send all of the available standard events or a select number from your Shopify account to Wingify. By default, all of these events are selected. If needed, you can restrict the sharing of unnecessary events.

To do so, select Yes, I’d like to configure events according to my event preferences. This displays all the events in the export bundle. Simply click on the Turn off button to deselect an event to be exported to Wingify.

In this step, you must specify the cookie consent configuration details based on your preference. Wingify uses cookies to track visitor interactions and improve user experience. Wingify tracks all visitors or only those who provide explicit consent for specific cookie categories based on the selected cookie consent settings.

Cookie Consent Settings

Wingify provides two main options for cookie consent:

  • Not Required: If selected, Wingify tracks all visitors without requiring their explicit consent.
  • Consent Required: If selected, Wingify tracks only those visitors who have consented to specific cookie categories.

#Advanced Code Option (Optional)

The Advanced Code Option enables you to customize standard Shopify events by defining custom logic. For more information, refer to the detailed article on customizing standard Shopify events.

#Shopify’s Standard Events Imported Into Wingify

The following are Shopify’s standard events that will be imported into Wingify, along with their properties:

#Page Viewed

This event is mapped to Shopify’s page_viewed event.
Wingify Event API Name: shopify.pageViewed

#Product Viewed

This event is mapped to Shopify’s product_viewed event.
Wingify Event API Name: shopify.productViewed

Payload:

Property API Name Description
variantId Variant ID of the viewed product
price Price of the product
currency Currency of the product price
productId Product ID
productTitle Product Title
productUrl Product URL
productVendor Product Vendor
productType Product Type

#Product Added to Cart

This event is mapped to Shopify’s product_added_to_cart event.
Wingify Event API Name: shopify.productAddedToCart

Payload:

Property API Name Description
variantId Variant ID of the viewed product
totalAmount Cost of added items
currency Currency of the product price
productId Product ID
productTitle Product Title
productUrl Product URL
productVendor Product Vendor
productType Product Type
quantity Product Quantity

#Product Removed From Cart

This event is mapped to Shopify’s product_removed_from_cart event.
Wingify Event API Name: shopify.productRemovedFromCart

Payload:

Wingify Property API Name Description
totalAmount Cost of added items
currency Currency of the product price
productId Product ID
productTitle Product Title
productUrl Product URL
productVendor Product Vendor
productType Product Type
quantity Product Quantity

#Cart Viewed

This event is mapped to Shopify’s cart_viewed event.
Wingify Event API Name: shopify.cartViewed

Payload:

Property API Name Description
totalAmount Cost of entire cart
currency Currency of the product price
quantity Total item quantity

#Checkout Started

This event is mapped to Shopify’s checkout_started event.
Wingify Event API Name: shopify.checkoutStarted

Payload:

Property API Name Description
totalAmount Total Cart value, including tax
currency Currency of the product price
totalTax Total item quantity

#Checkout Completed

This event is mapped to Shopify’s checkout_completed event.
Wingify Event API Name: shopify.purchase

Payload:

Property API Name Description
totalPrice Total Cart value, including tax in local currency
shippingPrice Shipping price for the transaction in local currency
currencyCode Local currency of the transaction
totalTax Total amount of tax on the order in local currency
totalDiscount Total discount on the order in local currency
productId CSV of line item product IDs
productVariant CSV of line item variant IDs
productSku CSV of line item product SKUs
productPrice CSV of line item prices in store currency
productQuantity CSV of line item quantity
productCurrency Store currency in which the product prices are denoted
orderId ID of the order

#Alert Displayed

This event is mapped to Shopify’s alert_displayed event.
Wingify Event API Name: shopify.alertDisplayed

Payload:

Property API Name Description
message A message describing the issue caused. e.g.: "Enter a valid gift card"
type A classification of the error type. Example: "INPUT_INVALID", "INPUT_REQUIRED", "PAYMENT_ERROR"
value The input provided by the user that caused the alert.

#Checkout Address Info Submitted

This event is mapped to Shopify’s checkout_address_info_submitted event.
Wingify Event API Name: shopify.checkoutAddressInfoSubmitted.

#Checkout Contact Information Submitted

This event is mapped to Shopify’s checkout_contact_info_submitted event.
Wingify Event API Name: shopify.checkoutContactInfoSubmitted

Property API Name Description
emailMarketingConsent: Indicates whether the user has opted in to receive marketing emails.
smsMarketingConsent: Indicates whether the user has agreed to receive marketing messages via SMS

#Checkout Shipping Info Submitted

This event is mapped to Shopify’s checkout_shipping_info_submitted event.
Wingify Event API Name: shopify.checkoutShippingInfoSubmitted

#Collection Viewed

This event is mapped to Shopify’s collection_viewed event.
Wingify Event API Name: shopify.collectionViewed

Payload:

Property API Name Description
collectionId Collection ID
collectionTitle Collection title
productTitles CSV of line item's product titles
productPrices CSV of line items of prices
productCurrencies CSV of line items of currencies
productVariantIds CSV of line items of variant IDs
productSkus CSV of line items of SKUs
productUrls CSV of line items of URLs
productVendors CSV of line items of vendors

#Payment Information Submitted

This event is mapped to payment_info_submitted event.
Wingify Event API Name: shopify.paymentInfoSubmitted

Payload:

Property API Name Description
totalAmount Total price amount
currencyCode Currency code
totalTax Total tax amount
shippingPrice Shipping price amount
shippingCurrency Shipping currency code
discountCode Discount code
discountType Discount type
discountValue Discount value
productIds CSV of line items of product IDs
productTitles CSV of line items of product titles
variantIds CSV of line items of variant IDs
quantities CSV of line items of quantities
prices CSV of line items of prices
currencies CSV of line items of currencies

#Search Submitted

This event is mapped to search_submitted event.
Wingify Event API Name: shopify.searchSubmitted

Payload:

Property API Name Description
searchQuery Search query
firstProductId First product ID
firstProductTitle First product title
firstProductUrl First product URL
firstProductVendor First product vendor
firstProductType First product type
productIds CSV of line items  of product IDs
productTitles CSV of line items  of product titles
productVariantIds CSV of line items  of variant IDs
productSkus CSV of line items  of SKUs
productUrls CSV of line items  of URLs
productVendors CSV of line items  of vendors
productTypes CSV of line items  of types
productPrices CSV of line items  of prices
productCurrencies CSV of line items  of currencies

Info: In addition to standard events, Wingify lets you further tailor your data by writing custom code. For more information about creating custom events, refer to Customizing Standard Shopify Events to be Imported Into Wingify.

#Need more help?

For more information or further assistance, contact Wingify Support.