1. Wicked Help Center
  2. SETUP
  3. Order Systems and Shopping Carts

How to Integrate Shopify with Wicked Reports

Everything to know about the Shopify to Wicked Reports integration.

Table of Contents

  1. Why people integrate Shopify & Wicked Reports
  2. How to integrate Shopify with Wicked Reports
  3. What's Next? (Historical orders, Tracking, and Data updates)
  4. Orders Happening Outside Your Shopify Store?
  5. Upsell Orders and Software
  6. Subscription Attribution and Reporting
  7. ReCharge Churn Logic
  8. Product Attribution and Reporting
  9. Cohort Reporting
  10. Gross vs Net Revenue Reporting
  11. Testing & Troubleshooting
  12. FAQ's

Why people integrate Shopify & Wicked Reports 

  • Looking to get ROI on Google & Facebook ad spend
  • Leads take time to buy from your CRM and want to connect customer lifetime value from Shopify revenue back to ad spend
  • High value subscription customers and you’d like the recurring purchase to track back to the top and middle of the funnel ad clicks
  • Ad Platform conversion tracking is taking credit for email abandoned cart campaigns that are actually converting the sales
  • Pixel conversion is inaccurate, missing subscription conversions, inaccurate ROI, or taking credit for other channel’s conversions.

    How to integrate Shopify

    The Shopify setup process requires you to 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:
      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. Go to your Wicked Reports menu option Setup->Authorizations

      how to integrate shopify with wicked reports
    13. Click the Connect button for Shopify
        how to integrate shopify with wicked reports

    14. Enter your Shopify URL and the Admin API Token you just copied then select Authorize.
      Tip: How do I get my Shopify URL?

    15. After authorizing your Shopify account, return to your Wicked Reports account the next day after 9a ET to confirm your order data is present in the account.

    Please follow the steps below to get the Shopify URL of your Shopify Store.

    image-Aug-01-2023-07-37-10-1771-PM

    Note: You can only have 1 Shopify store per Wicked Reports account.  If you have a 2nd Shopify store to integrate, you will need to use Zapier to send the order and also send a click.

    ⚠️ ****************************************************** ⚠️ 

    Using Shopify Plus?  READ THIS 

    Shopify is deprecating their checkout.liquid theme (summer 2024).  This means Shopify Plus users will eventually need to upgrade to Checkout Extensibility.  To ensure proper tracking after this upgrade, you will need to create a Custom Pixel in your Shopify Plus store and install the custom code provided by Wicked Reports for checkout page tracking.

    If you have not upgraded to Checkout Extensibility, you do not need to take this action. Be aware that when do upgrade or the checkout.liquid is deprecated, you will need to go through these steps.

    If you are a Shopify Plus user and have already switched from the liquid.checkout to Checkout Extensibility, please contact support@wickedreports.com for the custom code. Then, follow these steps to add it as a Custom Pixel.

    => In your Shopify Plus store, Go to "Settings"

    Select "Customer Events"

    Click "Add custom pixel"

    Give the Pixel a name and click "Add Pixel"

    Add the provided code to the Pixel and click "Save"

    Click the "Connect" button to connect the pixel to your store

    ⚠️ ****************************************************** ⚠️ 

     

    What's Next?

    • Historical Orders
      Wicked Reports will retrieve your entire Shopify order history for cohort and customer lifetime value reporting.
    • Order Tracking
      All incoming clicks directly to your Shopify store URLs will be automatically tracked. No need to deploy the Wicked Reports tracking code on your store - it's auto-deployed.
      Note: If you create checkout pages outside of your Shopify store, you will need to place our tracking code on those pages.
    • When will I see my data?
      Each morning, at about 12 pm UTC, Wicked Reports updates its database. This is when we retrieve the previous day's Shopify orders, attribute them back to clicks, leads, and ad spend, and update your reports.

    Orders Happening Outside Your Shopify Store?

    If you also have orders happening outside of the ones appearing in your Shopify store each day, you can authorize another order source from the Setup->Authorizations menu.

    Only authorize additional order sources that have unique orders not already found in your Shopify store.  If you use Stripe to process your Shopify orders, you do NOT need to authorize Stripe with Wicked Reports, only Shopify.

    Upsell Orders and Software

    Wicked Reports successfully works with both CartHook and Zipify's One Click Upsell. If you have a different upsell software, please discuss it with your Customer Success Rep. to ensure Wicked Reports will work successfully with it.

    Subscription Attribution and Reporting

    Wicked Reports has native integrations with both ReCharge and Chargify so that your Shopify subscription sales can be properly attributed.  It is very important to detect and attribute subscription conversions and customers correctly - this can be a huge edge for your media buying!

    Follow the simple integration wizards for either ReCharge or Chargify and Wicked will pull in all historical subscription data, and pull in all new and recurring subscription billings each morning for the previous day.

    Using ReCharge for Subscriptions?

    ReCharge will use the same information used when setting up Wicked Reports with your Shopify Store.  It will ask you to provide the URL of your Shop and the Admin API Token you created in the earlier steps.  

    You do NOT need to create a new Shopify Custom App for ReCharge.  You will use the same app created for the Shopify integration above.

    ReCharge Churn Logic:

    1. Each morning when Wicked pulls orders from Shopify we check it for recharge tag.
    2. If it's detected, we fill in subscription id for order using product sku name + email of contact.
    3. If next month we don't see order with the same subscription id , it's considered a churn.

    Product Attribution and Reporting

    Wicked Reports reports off of the product names that are in your Shopify store. You can validate this by going to the Wicked Report's product report.

    Note: You 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.

    Cohort Reporting

    Approximately 1 day after you have integrated Shopify and your CRM data (Klaviyo, ActiveCampaign, HubSpot, Drip, Infusionsoft, Ontraport, Mailchimp, OmniSend, etc) with Wicked Reports, you will have access to powerful cohort customer lifetime value reporting.  You can take advantage of these reports before a single click is tracked or attributed!

    Wicked connects the CRM lead information with the historical Shopify sales and revenue data so you can see time to 1st purchase, accumulated customer lifetime value by month, and time to break-even based on cost per lead and cost to acquire the customer.

    Click here for our Complete Guide to Cohort Reporting.

    Historical Tracking Data

    Some of our clients already have tracking (or, attribution) data stored in their CRM from past effort's to track and attribute customer lifetime value back to ad spend.  If you have this data, you can send it to Wicked Reports.  We will then attribute your custom tracking data to Shopify sales & revenue.

    Gross vs Net Revenue Reporting

    Wicked's Gross Shopify revenue = Shopify Gross order amount + shipping + tax

    Wicked's Net Shopify Revenue  = Shopify Gross order amount - refunds - discounts + shipping + tax

    Note:  Discounts will show up in the Customer LTV report as "partially refunded" status.

    Testing & Troubleshooting

    The Shopify Wicked Reports integration generally works without issue. 

    Note: Wicked Reports automatically adds our tracking code to your Shopify store but there are a couple ways to optimize the tracking code if you feel some conversions are being missed:

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

    2. Do not use lazyload for Wicked Reports script in your shopify store

    • Shopify Plus accounts can put our tracking code on the order form itself.
    • Other Shopify non-Plus accounts will still track as long as the customer makes it to the post purchase thank you page.
    • Product Page is redirecting and stripping tracking parameters: An issue we sometimes see is when visiting specific product pages in a Shopify store, the page redirects and strips all tracking parameters.   The result is that Ads don't appear to be getting conversions when in reality the URLs are just having their tracking stripped and Wicked Reports can't tell they were clicked.
      • Common Cause:  A product in the Shopify store has variants and a variant is auto-selected for the customer. 
      • This typically happen if you use a custom theme
      • The theme you are using may allow you to turn off the auto-selection of the variant
      • You may need a developer or possibly Shopify support to help alter the theme so variants are not auto-selected.

    How to test the tracking of a Shopify order

    Shopify Plus customers can use the Wicked Reports tracking validation tool. 

    1. Go to Setup-> Tracking Validation
      how to integrate shopify with wicked reports
    2. Click on "Manually Validate URL" and then select the Sales Tracking option. Paste in your URL and start test
      how to integrate shopify with wicked reports
    3. After making the test purchase and reaching the thank you page, come back to Wicked Reports and click End Test.

    How to Validate Wicked Report order and revenue data matches your store

    Wicked Reports order count and revenue amount will usually match your shopping cart order system numbers.

    If the numbers are off slightly, here are possible causes:

    • Time zone differences between your source system and Wicked Reports (EST).
    • Confirm you are looking at gross or net revenue in both systems.
    • Orders that are entered with back-dates, edited days later, or deleted days later - Wicked misses those, we pull a day's orders one-time only.

    To validate and reconcile orders, we recommend starting with 1 day and using this process:  My revenue doesn't match what I'm seeing in my shopping cart
    It's the exact process our Customer Success team uses.

    FAQs:

    1. 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.
    2. Can I choose to only 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.