Integration Guides
      Back to home
      1. Knowledge Base
      2. Integrating Your Site
      3. Integration Guides

      Integration Guide: Launching your First Shipping Test

      Learn how to integrate your Shopify store with Intelligems for a Shipping Test using Rate Carriers.

      In this article:

      ❗To activate Intelligems Rate Carrier out of the box, your store needs to be on the Advanced Shopify or Plus plan. If you're on the Shopify plan or lower, then you will need to reach out to Shopify Support to enable third-party carrier-calculated shipping - see more on that here. Additionally, please note that as of January 1st, 2023, Shopify will be no longer support this feature for Shopify Basic plans.

      Prerequisites: Download the Intelligems App and approve billing.

      If you have not already done so, please download the Intelligems app from the Shopify app store and approve billing in the Settings section in the app.

      ❗If you have chosen to have Intelligems complete the integration, many of these steps will be done on your behalf. Feel free to jump over to this article for an overview of the onboarding process and next steps.

      Step 1: Add Intelligems JavaScript.

      Add Intelligems JavaScript as a source into your theme.liquid file.

      <head>
        ...
        <script src="https://cdn.intelligems.io/<your_customer_id>.js"></script>
        ...
      </head>

      You can find your individual script tag on the settings page in the Intelligems App. 

      Screen Shot 2022-12-06 at 12.07.20 PM

      Step 2: Set up your test.

      If you have not already done so, the next step in the integration is to set up your first Shipping Test. Check out our guide on doing this here. This doesn't have to be exactly what you plan on testing - Don't worry - it won't be going live right away and you can always make edits before launching it! 

      Step 3: Add Cart Progress Bar.

      We highly recommend that you use the Intelligems Cart Progress bar during a test as it will reflect the correct amounts for each test group, but it can also be used to replace your current cart progress bar even without a test running.

      Setup​

      1. Paste:
        <ig-shipping-progress-container></ig-shipping-progress-container>
        into your store's theme at the location you wish the progress bar to render. Make sure to remove or comment out your current progress bar.
      2. Intelligems uses classes to access the cart subtotal. In the Intelligems App, go to the Settings and scroll to the Progress Bar Settings section. Press Edit, and under the Cart section, replace .igSubtotal with the class corresponding to your cart's subtotal. If the cart subtotal has no nearby classes, add igSubtotal as a class.

      Customization​

      You can customize the Intelligems Cart Progress Bar in the Progress Bar modal located in the Settings page - see screenshot to the left. If you are looking for additional customization, please email us at support@intelligems.io.

      Using the Progress Bar Without A Test​

      Under the Threshold section, use 'Default Threshold' to set the free shipping threshold when there are no live experiments. This allows you to continue using the Intelligems Cart Progress Bar even when you are not running a test. For example, if you set the Default Threshold to $25, the Cart Progress Bar will display free shipping over $25 when there are no tests running. To hide this progress bar when no test is live, set the default threshold to 0.

       

      Integrating With Rebuy​

      1. Create a Rebuy custom smart cart template. Follow this article for instructions.
      2. Edit the template to replace the Rebuy progress bar with the Intelligems progress bar. See Step 1 under Setup above.
      3. Add the igSubtotal class to the subtotal. See Step 2 under Setup above.

      Step 4: QA your integration.

      After you have completed all previous integration steps, go through your store using Preview Mode in the Integration Widget (see more on how to start preview mode here) and make sure everything looks correct. Follow our QA checklist here!

      Step 5: Publish your theme changes and start your first test.

      Once you have verified Intelligems is fully integrated, you can publish your theme changes (if you haven't already) and start your test from the Intelligems App! Check out our step-by-step guide on starting your test here. 

      What happens next?

      Now that you've started your first test, here are some things to do next.