Shopify

WebEngage brings you the ability to integrate with one of the largest e-commerce platforms, Shopify, to your dashboard easily and that too without the hassle of writing any code. Our one-click Shopify plugin starts tracking data within seconds.

Installation

• Make sure you are logged in to your Shopify store and have the access to install apps.
• From the WebEngage listing page on the Shopify App Store, click the ‘Add App’ button to review the app’s permissions and then click on ‘Install App’.
• Once the app is installed, you will be redirected to a page where you have to select your data center, WebEngage account and identifier type. To avoid any data sanity issues, make sure that the same identifier type is selected if you're reinstalling the app on the same store.
• You will then be redirected to the WebEngage dashboard where you will be given a link to enable “app embed” in your Shopify theme. This is a crucial step to get our SDK integrated on the website and start collecting user and event data.

• (Option Step) If you wish to enable 1-step opt-in web push in your WebEngage project, you will have to set the service worker path to "/apps/webengage/service-worker".

That's it! User and event data from your Shopify store has now started flowing into your WebEngage project.

List of tracked User Attributes

After successfully installing the Shopify plugin, the following user attributes will be tracked:
Email, Phone, Identity, Tags, City, Accepts Marketing, Has Account, Orders Count, Tax Exempt, Total Spent, customer_id, First Name, Last Name.

List of tracked Events

After successfully installing the Shopify plugin, WebEngage will start tracking the below-mentioned custom events and attributes attached to it.

Product Viewed

Attributes: ID, Price, Title, Currency, Available, Total Variants, Source, Tags, Image.

Searched Product

Attributes: Terms, Total Items, Source.

Category Viewed

Attributes: ID, Title, Image, Product Count, Source.

Added to Cart

Attributes: Title, Image, Vendor, Quantity, Product ID, Variant ID, Product Type, Variant Title, Currency, Price, Source.

Removed From Cart

Attributes: Title, Image, Vendor, Quantity, Product ID, Variant ID, Product Type, Variant Title, Currency, Price, Source.

Customer Registered

Attributes: Email, Phone, Identity, Tags, City, Accepts Marketing, Has Account, Tax Exempt, Customer ID, First Name, Last Name.

Checkout Button Clicked

Attributes: Currency, Total Items, Total Price.

Checkout Created

Attributes: Created At, Updated At, Abandoned Checkout Url, Buyer_Accepts_Marketing, Currency, Customer Accepts Marketing, Customer Created At, Customer Email, Customer First Name, Customer Id, Customer Last Name, Customer Locale, Customer Phone, Customer Updated At, Default Address City, Default Address Country, Default Address Country Code, Default Address Province, Default Address Province Code, Default Address Zip, Device Id, Email, Gateway, Location Id, Name, Phone, Shipping Address City, Shipping Address Country, Shipping Address Country Code, Shipping Address Province, Shipping Address Province Code, Shipping Address Zip, Source, Source Name, Subtotal Price, Tags, Total Price, User Id.

Checkout Updated

Attributes: Created At, Updated At, Abandoned Checkout Url, Billing Address City, Billing Address Country, Billing Address Country Code, Billing Address Province, Billing Address Province Code, Billing Address Zip, Buyer_Accepts_Marketing, Currency, Customer Accepts Marketing, Customer Created At, Customer Email, Customer First Name, Customer Id, Customer Last Name, Customer Locale, Customer Phone, Customer Updated At, Default Address City, Default Address Country, Default Address Country Code, Default Address Province, Default Address Province Code, Default Address Zip, Device Id, Email, Gateway, Location Id, Name, Phone, Shipping Address City, Shipping Address Country, Shipping Address Country Code, Shipping Address Province, Shipping Address Province Code, Shipping Address Zip, Source, Source Name, Subtotal Price, Tags, Total Price, User Id.

Order Completed

Attributes: Updated At, Created At, Updated At, Abandoned Checkout URL, Billing Address City, Billing Address Country, Billing Address Country Code, Billing Address Province, Billing Address Province Code, Billing Address Zip, Buyer_Accepts_Marketing, Currency, Customer Accepts Marketing, Customer Created At, Customer Email, Customer First Name, Customer ID, Customer Last Name, Customer Locale, Customer Phone, Customer Updated At, Default Address City, Default Address Country, Default Address Country Code, Default Address Province, Default Address Province Code, Default Address Zip, Device ID, Email, Gateway, Location ID, Name, Phone, Shipping Address City, Shipping Address Country, Shipping Address Country Code, Shipping Address Province, Shipping Address Province Code, Shipping Address Zip, Source, Source Name, Subtotal Price, Tags, Total Price, User ID, Cart Token, Checkout ID, Checkout Token, Financial Status, Gateway, Order Status URL, Order Number, Current Total Price, Current Total Tax, Current Total Discounts, Order ID.

Order created

Same attributes as Order Completed event

Order updated

Same attributes as Order Completed event

Newsletter Subscribed

Attributes: contact[email], contact[Message], contact[Name], contact[Phone Number], contact[tags], form_type

Cart Viewed

Attributes: Number of Products, Product Name, Total.

Cart Updated

Attributes: Number of Products, Product Name, Total.

How to track additional custom events

To tack additional custom events apart from those mentioned above, use the below script

function webengageOnReady(cb) {
        if (typeof webengage === undefined || typeof webengage.onReady !== "function") {
            setTimeout(function() {
                webengageOnReady(cb);
            }, 100);
        } else {
            webengage.onReady(cb)
        }
 }
webengageOnReady(function(){
// paste event tracking function here 
})

To configure event tracking function, refer this documentation

📘

Call for feedback

If you want our plugin to track some additional data or if you're facing any issues in using the plugin, please send an email to [email protected].