|
In this article, you’ll learn about: |
The Shopify VWO app seamlessly integrates your Shopify account with VWO, securely transferring Shopify’s standard events. It simplifies checkout tracking by supporting checkout extensibility using pixels for data transfer.
Setting up the app is so hassle-free and just a few clicks away.
- This app does not cater to Insights Goals and Funnels.
- Owing to Shopify's security-based limitations, the VWO SmartCode will not be placed on the Checkout, Post Purchase, and Order Status pages. Therefore, you cannot include these pages in any of your VWO campaigns.
Step 1: Access the VWO App for Integration in Shopify
- Click on this link to access Shopify’s VWO app for integration.
- Click the Install button.
-
On the Install app page for Shopify’s VWO app that appears, review the access information required for VWO 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. VWO does not store any PII information on our server.
Step 2: Install the VWO App
Overall, you only need to do two simple things to prepare the app for connecting your VWO account with Shopify:
Install the VWO SmartCode on Your Website
Perform the following steps directly if you have not already installed the VWO SmartCode on your website (your online store on Shopify). 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, click on the link to the Shopify Editor provided in your website's Install VWO SmartCode section. This opens the Shopify Editor on a separate tab. In the VWO Account ID field, enter your VWO account ID.
- To experiment with new Shopify themes, turn on the Enable Theme Testing toggle. This step automatically embeds the VWO SmartCode in your new theme and allows you to conduct a Split URL Test in your VWO account.
- Click Save at the top right corner.
This installs the VWO SmartCode on all your website pages except the Checkout, Post Purchase, and Order Status pages.
Enable Sending Standard Shopify Events to VWO
To use Shopify's standard events to run your campaigns in VWO, you can simply integrate your VWO account with the app to start streaming them. These events can be used in tracking metrics and targeting visitors for your campaigns
-
On the app’s page, click on the Enable Tracking button in the Send your standard events from Shopify to VWO.
-
On the VWO Account ID field that appears, enter your VWO account ID.
-
Click Activate Tracking.
After you activate tracking, standard Shopify events start flowing into your VWO account when users begin to perform 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 VWO 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.
This completes your registration. After you register an event, it appears under the MY EVENTS section. - Repeat Steps 4 and 5 for the rest events.
Once you have registered all the events, you can create metrics based on these Shopify 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 VWO and skew your reports.
Step 3: Configure Events to be Exported to VWO
Depending on your requirements, you can send all of the available standard events or a select number from your Shopify account to VWO. 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 VWO.
Step 4: VWO Cookie Consent Settings
In this step, you must specify the cookie consent configuration details based on your preference. VWO uses cookies to track visitor interactions and improve user experience. VWO tracks all visitors or only those who provide explicit consent for specific cookie categories based on the selected cookie consent settings.
Cookie Consent Settings
VWO provides two main options for cookie consent:
- Not Required: If selected, VWO tracks all visitors without requiring their explicit consent.
- Consent Required: If selected, VWO tracks visitors who have consented to specific cookie categories.
Step 5 (Optional): Advanced Code Option
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 VWO
The following are Shopify’s standard events that will be imported into VWO, along with their properties:
Page Viewed
This event is mapped to Shopify’s page_viewed event.
VWO Event API Name: shopify.pageViewed
Product Viewed
This event is mapped to Shopify’s product_viewed event.
VWO 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.
VWO 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.
VWO Event API Name: shopify.productRemovedFromCart
Payload:
| VWO 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.
VWO 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.
VWO 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.
VWO 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.
VWO 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.
VWO Event API Name: shopify.checkoutAddressInfoSubmitted.
Checkout Contact Information Submitted
This event is mapped to Shopify’s checkout_contact_info_submitted event.
VWO 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.
VWO Event API Name: shopify.checkoutShippingInfoSubmitted
Collection Viewed
This event is mapped to Shopify’s collection_viewed event.
VWO 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.
VWO 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.
VWO 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 |