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”

    Tracking

    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

    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, if you have a compatible theme, you’ll be redirected to the “App embeds” section of your Theme editor (see screenshot).

    If you do not have a compatible theme please follow the instructions provided to install the tracking script manually on the cart and Thank You Page.

    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

    Installing the conversion tracking script on the Cart

    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 -->

    Installing the conversion tracking script on the Thank You page

    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

    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

    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?