How to Integrate Shopify with Wicked Reports

This document is for Shopify users who want to learn how to integrate Shopify with Wicked Reports

Table of Contents

1. Introduction To Shopify Integration
   1. Steps to Integrating Your Shopify Store
   2. Steps to Manually Add Tracking To Your Checkout Process
   3. Steps to Complete Your Subscription Setup*
   4. Steps to Validate Your Integration
2. What's Next?
3. Troubleshooting
4. FAQ

Introduction To Shopify Integration

Why Should I Integrate Shopify with Wicked Reports?

• You want Wicked Reports to have all the necessary order details to provide attribution.
• Shopify is your "source of truth" with all the orders Wicked Reports needs to attribute.
• You're combining Shopify and multiple other segmented order management systems to get all the necessary order data into Wicked Reports

What is the Shopify Setup Process?

The Shopify setup process is as follows:

1. Integrate Your Shopify Store
2. Manually Add Tracking To Your Checkout Process
3. Complete Your Subscription Setup*
4. Validate Your Integration

Once you've completed all four steps, your Shopify integration will be completely and reliably set up to successfully track and attribute data. Let's begin.

Steps to Integrating Your Shopify Store

Shopify requires that you create a "Custom App" inside your Shopify Store.  You will then provide us the API Key from that "Custom App" inside Wicked Reports. It's simpler than it sounds. You can watch this video below to see how you do it, or you can read the steps below the video.

1. Go to your Shopify store. Then, click the Apps menu
   
2. Select, App and Sales Channel Settings
   
3. Click the Develop Apps for Your Store button
   
4. Click, Create an App
   
5. Give your app a name (we recommend: Wicked Reports Integration). Leave the App Developer with the default name and click, Create app
   
6. Click, Configure Admin API scopes
   
7. Select the checkbox for the following permissions:
   Note: If you're missing one of these permissions, please contact Shopify Support to ensure you have the correct Admin permissions.
   
   1. read_customers
   2. read_orders
   3. read_products
   4. write_script_tags
   5. read_script_tags
   6. read_content
8. Click Save at the bottom
9. At the top, click the Install App button. Then, click Install on the popup window
   
10. Click the API Credentials tab. Then, click Reveal Token Once.
    
11. Copy the Admin API access token. It starts with "shpat_".  You will use this token in your Wicked Reports account.
12. Now, find and take note of your Shopify URL. You will use this URL in your Wicked Reports account.

13. Now that you have your API Key and Shopify URL, you'll want to log in to your Wicked Reports account. Once logged in, navigate to the Authorizations Page.
    Setup->Authorizations.

    

14. On the Wicked Reports Authorizations Page, click the Connect button for Shopify
     

15. Insert your Shopify URL and the Shopify Admin API Token, then select Authorize.
    

Great! Well done. With that being completed, our tracking script will be automatically added to your store and you'll see orders flowing into your Wicked Reports account by tomorrow morning.

Please continue to the next step to progress through your Shopify Setup Process.

Steps to Manually Add Tracking To Your Checkout Process

Adding our custom tracking code, on your Shopify Checkout Page, is crucial for attribution. However, Shopify does not currently allow us to update your Checkout automatically. Rather, it requires a manual process to add the custom tracking code.

• To install the custom tracking code, you’ll need to create a Custom Pixel and install the Custom Tracking Code onto your Checkout Page. This will enable us to properly track Checkout opt-in submissions.
• Please follow this guide for more details.

Once completed, your Checkout process will be fully configured for effective tracking. Continue to the next step to progress through your Shopify Setup Process.

Steps to Complete Your Subscription Setup*

• Native
  If you're using a Native Shopify APP for subscriptions, then no additional setup step is required. Your subscriptions will automatically track using Shopify's variant_ID. 
• Recharge
  If you're using Recharge for subscriptions, then additional setup steps are required. Please read here to learn How To Integrate Recharge for Shopify.
  
• Alternative Platform
  If you're using an alternative third-party platform to manage your subscriptions, then please reach out to our support team. We'll help you identify if any additional setup steps are required.

Once completed, your subscription setup will be fully configured. Continue to the next step to progress through your Shopify Setup Process.

Steps to Validate Your Integration

Wicked Reports Gross Revenue amount will typically match your Shopify Gross Revenue completing your integration. Verifying is important because it ensures your integration is set up and functioning properly. When verifying, we expect the data to be within a 20% margin due to these common causes:

• Time zone differences between your source system and Wicked Reports (EST).
• Not comparing Gross to Gross and/or differences in how these values are calculated.
• You have orders that are entered with back-dates, edited days later, or deleted days later.

To quickly validate your revenue, wait one day after the integration is authorized. After,

1. Login to your Wicked Reports Account
2. Go to the Funnel Vision Report
3. In your filters, Select a 7 day date range
4. In your attribution settings, select Gross Revenue 
5. Compare your accounts summary metric "Total Revenue" to Shopify's Gross Revenue

If the comparison is within 20%, then your system is correctly integrated and your Shopify Setup Process is completed! If your comparison has over a 20% discrepancy, then please reference the troubleshooting section below before moving forward. 

What's Next?

• Historical Orders
  Wicked Reports will now automatically retrieve your entire Shopify order history for cohort and customer lifetime value reporting.
• When will I see my data?
  Each morning, at about 12:00 pm UTC, Wicked Reports updates its database. This is when we will retrieve the previous day's Shopify orders, attribute them back to clicks, leads, and ad spend, and update your reports.

Troubleshooting

• Are you having difficulty trusting your Shopify Integration?
• Do you feel like something is off or missing?
• Are you experiencing one of these issues?
  
  • My Gross revenue is different from what's in Shopify Dashboard.
    
    • Primarily, differences in Shopify's Gross Revenue come from a difference in the way our systems calculate Net Revenue.
    • That being said, if you're not confident in the accuracy of your data within Wicked Reports, then run through this Revenue Validation Test.
      • This test is designed to compare Shopify's Gross spreadsheet data with Wicked Reports Gross spreadsheet data. It's highly effective at ensuring the Shopify/Wicked integration data is accurate.

• • My Net Revenue is different from what's in Shopify's Dashboard.
    • Primarily, differences in Shopify's Net Revenue come from a difference in the way our systems calculate Net Revenue.
    • Secondarily, Shopify's Net Revenue will show refunds for past orders in current reports (the date the refunds came in). However, Wicked Reports shows refunds for past orders in past reports (the date those orders were originally created.)
    • That being said, if you're not confident in the accuracy of your data within Wicked Reports, then run through this Revenue Validation Test.
      • This test is designed to compare Shopify's Gross spreadsheet data with Wicked Reports Gross spreadsheet data. It's highly effective at ensuring the Shopify/Wicked integration data is accurate. With this accuracy confirmed, you can rest easy knowing the differences between the two platforms is simply the way we calculate Net.

• • I have attributed leads and sales, but less than what Shopify attributes.
    • If so, run through the Tracking Validation Routine.
    • The Tracking Validation routine is a series of tests designed to validate your tracking setup; locate issues and bring your tracking up to the highest quality standard. If you're currently experiencing a tracking issue, then this routine is designed to find it.

If you're still experiencing one of these issues after running through the tests, or if you're facing any other issues, then please contact our customer support team and we'll help get things squared away!

FAQs:

1. How can I optimize my Shopify Tracking performance?
   

   1. You can manually move the Wicked Reports tracking code directly before the </body> tag in the theme template.

   2. You can turn off lazyload for the Wicked Reports script in your Shopify Account
2. How do I track a non-Shopify Checkout Page?
   If you have a checkout page that allows our tracking script to be directly added to it or through GTM, then that's exactly what you should do. Otherwise, you'll need to set up a trackable Thank-You Page. Reach out to support if you'd like assistance.
3. I have orders coming into stores that aren't in Shopify. What should I do?
   1. If you notice orders from sources outside your Shopify store, ensure accurate tracking by authorizing additional order sources through the Setup->Authorizations menu.
   2. Only authorize sources that generate unique orders not already present in your Shopify store. If you exclusively use Stripe for processing Shopify orders, there's no need to authorize it separately; simply authorize Shopify for comprehensive tracking.
      
4. Can I filter/block orders from coming into Wicked via Shopify Tag?
   Yes. If you would like to do this, then please open a support ticket or email support@wickedreports.com with the tag(s) you'd like to filter with. We will then have our development team activate this for you.
   Note: If you filter by tags, you're Shopify dashboard revenue will no longer align with the revenue in Wicked Reports.
5. Can I choose only to send in select orders via Shopify Tag?
   Yes. If you would like to do this, then please open a support ticket or email support@wickedreports.com with the order tag(s) you'd like to have sent to Wicked. We will then have our development team activate this for you.
   Note: If you only send in select orders by tags, you're Shopify dashboard revenue will no longer align with the revenue in Wicked Reports.
6. Will Wicked Reports report on the product information in my Shopify account?
   

   Yes, we report off the product names in your Shopify store. Note: For this to work, you'll need to create products in Shopify and then have your Shopify checkout use those products as line items of the order. If you do not use product names, the product attribution and product reporting will not equal your daily sales

7. Does Wicked Reports support Up-Sell Software with Shopify?
   Yes, Wicked Reports seamlessly integrates with both CartHook and Zipify's One Click Upsell, ensuring accurate tracking and reporting of upsell orders. If you utilize a different upsell software, then please reach out to support@wickedreports.com for additional details.
8. Does Wicked Report work with my Subscription Software?
   Please read Steps To Complete Your Subscription Setup.
9. How do I get my historical data attributed?
   By default, this data will be attributed as Pre-Wicked. However, if you have tracking (or, attribution) data stored in their CRM from your past efforts, you can send it to Wicked Reports.  We will then attribute your custom tracking data to Shopify sales & revenue. You can learn more here. 
10. Why does my Shopify Dashboard Net Revenue look so different than Wicked Reports?
    
    
11. How does Wicked Reports report the breakdown of Gross & Net for Shopify Sales compared to Shopify? 
    Wicked's Dashboard Formula for Shopify:
    1. Gross Revenue = Shopify's Gross Revenue + shipping + tax 
    2. Net Revenue  = Shopify's Gross Revenue - refunds - discounts + shipping + tax
    Shopify's Dashboard Formula:

    1. Gross Revenue = Product Price x Quantity Sold (before any deductions are applied)

    2. Net Revenue = Gross Revenue - Discounts - Returns/Refunds