Article sections

    Installation

    To install our Shopify application, you need to do the following:

    1. Go to the Shopify app store and search for our app “Omniconvert Explore” or access the following link: https://apps.shopify.com/explore
    2. Click on Install
    3. You should now be on your store’s admin panel
    4. Click on “Install app”
    5. Login or create an account
    6. You should now be in Explore at the following page: https://web.omniconvert.com/shopify/

    The Explore app has now been installed, and you should see the following page:

    Confirm / verify installation

    You can confirm that the app is installed by doing the following in Shopify:

    1. Go to the admin portal of your store, e.g. https://admin.shopify.com/store/yourstore/
    2. Click on “Settings”, e.g.https://admin.shopify.com/store/yourstore/settings/general
    3. Click on “Apps and Sales channels”, e.g. https://admin.shopify.com/store/yourstore/settings/apps?tab=installed
    4. Verify that our app is in the list of installed apps, e.g. “Omniconvert Explore”

    1. General Tracking Code

    Depending on the compatibility of your Theme, whether it is a Theme 2.0 or an older Theme, you’d either be redirected to the App Embeds section of your Theme Editor or you’ll be prompted to install the tracking script manually.

    Installing our app embed

    The App Embed will install the General Tracking Code to the entire Shopify Website.

    To install our tracking code on the entire website you need to enable our app embed.

    After installing our Shopify App, click on the red button “Enable the App Block in Shopify”, which you should see on the page you arrive after installing our Shopify application (see screenshot).

    After clicking the red button, you’ll be redirected to the “App embeds” section of your Theme editor (see screenshot).

    Do the following:

    1. Click on the slider button to enable the App embed. You know it is enabled if the white button is to the right.
    2. Insert your website’s unique code from the “Installation successful” page in Explore, e.g. b9b8c2c
    3. Click on “Save” at the top right

    2. Installing the conversion tracking script on the Cart

    Check your theme files list, to see if you have the following file in Sections/cart-template.liquid.

    If you do not have it, you can skip this step.

    If you have it, follow the instruction below.

    In the theme files list, edit the template in Sections/cart-template.liquid and insert the following code right after the <form> tag:

    <!-- omniconvert start -->
    <input id="mktz_custom" name="attributes[mktz_custom]" type="hidden" value="" />
    <!-- omniconvert end -->
    <!-- Omniconvert Start -->
    <script>
    document.onreadystatechange = function () {
        if (document.readyState == 'complete') {
            var variations = _mktz.getSeenVariations();
            var visitor = _mktz.getVisitor();
            if (variations && visitor) {
                var experimentData = {
                    'uid': visitor.uid,
                    'session': visitor.session_id,
                    'last_variation': variations.join('|')
                };
    
                mktz_$('#mktz_custom').val(JSON.stringify(experimentData));
            }
        }
    };
    </script>
    <!-- Omniconvert End -->
    

    3.1 Conversion tracking code on the “Thank you” page (with Additional Scripts)

    This is used for the legacy method of adding scripts to the Shopify checkout page with the Additional Scripts box. If you wish to add pixels (for the new Checkout Extensibility system) for please skip this section and follow the instructions from Step 3.2.

    The Thank You page appears after a purchase has been completed, e.g. the checkout completed stage. At this point we know a purchase has been successfully made and we need to insert a script to properly capture your sales goal for conversion tracking purposes.

    Do the following:

    1. Go to https://web.omniconvert.com/website/code and copy the tracking code
    2. Go to the Settings page in the Admin panel of your store, e.g. https://admin.shopify.com/store/omni-app-onboarding-store/settings/general
    3. Go to the Checkout page, e.g. https://admin.shopify.com/store/omni-app-onboarding-store/settings/checkout
    4. Scroll down until you find the “Additional Scripts” section

    At this step, you have to pay attention if you have 2 Additional scripts boxes.

    Some users have only one and some users have both of them.

    If you have 2 Additional scripts boxes, please insert the 2 pieces of codes in both boxes.

    If you have only one Additional scripts box, please insert the 2 pieces of codes in that one box.

    Very important: Please place those 2 pieces of code at the beginning of the Additional scripts box.

    5. Paste the tracking code from https://web.omniconvert.com/website/code

    6. Copy and paste the following code right below the code from step 5:

    {%% if attributes.mktz_custom %%} 
    <!-- start conversion goal --> 
    <script>     
        var _mktz = _mktz || [];     
        var mktzCustom = JSON.parse('{{ attributes.mktz_custom }}'.replace(/&quot;/g, '"'));     
        mktzCustom.transaction = '{{ checkout.id }}';
        mktzCustom.orderId = '{{ checkout.order_id }}'; 
        _mktz._Goal('sale', '{{ total_price | money_without_currency }}', mktzCustom); 
    </script> 
    <!-- end conversion goal -->
    {%% else %%}
    <script>
        var mktzCustom = { 'orderId': '{{ checkout.order_id }}' };
        var _mktz = _mktz || [];
        _mktz.push(['_Goal','sale','{{ order.total_price | money_without_currency }}', {transaction:'{{ checkout.order_id }}'}]);
    </script>
    {%% endif %%}
    

    3. Press the “Save” button

    3.2 Conversion tracking code on the “Thank you” page (with pixels for Checkout Extensibility framework)

    Go to Settings -> Customer events in the admin dashboard of your store and click on Add Custom Pixel button. Enter a name that identifies this pixel in the prompt that pops up. It can be something like: “Omniconvert Explore Pixel”.

    Copy the following code and paste it into your pixel and replace {YOUR_ID} with your website’s unique identifier from the Explore Dashboard.

    You can find your {YOUR_ID}  in the General tracking code.

    https://web.omniconvert.com/website/code

    window._mktz=window._mktz||[];
    const script = document.createElement('script');
    script.setAttribute('src', '//cdn.omniconvert.com/js/{YOUR_ID}.js');
    document.head.appendChild(script);
    analytics.subscribe("checkout_completed", (event) => {
        _mktz.push(['_Goal','sale',event.data?.checkout?.totalPrice?.amount, {transaction:event.data?.checkout?.order?.id}]);
    });
    

    Then you need to make sure you press the Save button first then the Connect button at the bottom of the page. The pixel needs to be connected, otherwise your sale events won’t be sent to Explore.

    Checking that the script is properly installed

    Go to https://web.omniconvert.com/website/code in Explore and click on “Check now”, visible inside the yellow banner, in order to check the tracking script after you execute the above mentioned steps.

    Upgrading your plan

    After the app has been installed, you can upgrade or downgrade your subscription to update the limits on your account:

    1. Go to Billing: https://web.omniconvert.com/account/billing
    2. Select the plan you wish to upgrade to. This should take you to the Shopify billing page
    3. Approve the subscription by clicking on “Approve”, which should take you back to Omniconvert’s billing page

    Uninstalling our application

    To uninstall our application from your store, do the following:

    1. In the admin portal of your store go to Settings -> Apps and Sales channels
    2. Find our app and click on “Uninstall”
    3. Upon confirmation, click on “Uninstall” again

    Was this post helpful?