This article covers the following:
- Install the Wingify App for Integration in Shopify
- Configure the Wingify App
- 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 Data360 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
- Click on this link to access Shopify’s Wingify app for integration.
- Click the Install button.
-
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:
- Connect your Shopify store to your Wingify account.
- Install the Wingify SmartCode and enable Shopify event tracking.
Connect Your Store to Wingify
- On the Wingify app page, enter your Wingify Account ID in the VWO (Wingify) Account ID field.
- Click Connect Store.
- 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:
- On the app's page, ensure that your store is connected to your Wingify account.
- 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.
- 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.
- The _wingify_uuid cookie is present in the visitor’s browser.
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
- On the app’s page, verify that your store is connected to your Wingify account and that the Wingify SmartCode is active.
-
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 360 > Events > UNREGISTERED EVENTS) of your Wingify dashboard. You need to register these events to use them to target your campaigns. - To register these Shopify events, navigate to Data 360 > Events > UNREGISTERED EVENTS.
- Select a particular event (for example, shopify.purchase).
- 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 to change it.
- Add a Description to specify what the event does.
-
Click Create.
The event is now registered and appears under the MY EVENTS section. - 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.
Wingify Cookie Consent Settings
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.