Tools for Devs!

Some help tips.





Stay on top of every update, question, request, and compliment that comes your way.

Introduction

  • These help pages are created to specifically get in more detail of how the website works and how you can benefit from our functions that we provide.
  • If you believe that what you read on these help pages is not enough or that you have any other questions, please do not hesitate to contact us.
  • How to add your website

  • 1) Make sure you have an account, you are logged in and that your plan is active.
  • 2) Go to the Websites page, click the Add Website button and a simple form will appear.
  • 3) Fill in the Name of your website, a simple identifier for you. It does not matter to us what you write in this box.
  • 4) Select the protocol that your website uses, http or https. We recommend using https and making sure your website has an SSL Certificate.
  • 5) Fill in the Website field with your website domain, subdomain or domain path. Ex: domain.com, subdomain.domain.com, domain.com/path.
  • How to install the tracking script

  • 1) Make sure you are logged in to your account, then go to your websites list that you added.
  • 2) Click on the Tracking code button and a simple modal will appear.
  • 3) Click on the Copy Pixel button or select and copy the code from the textbox area.
  • 4) Place this code in the header of your website, right before the end of the html tag.
  • 5) Click on the Verify installation tab and then click the button. If you see an alert box saying that the pixel is installed, then you finished the installation process.

  • Lightweight Tracking Script

  • PROS
  • - Extremely lightweight tracking script (< 3 kB)
  • - Very Fast.
  • - GDPR, CCPA and PECR compliant.
  • - No tracking consent is needed as it doesn't store any personal identifiable information.
  • - It doesn't use cookies nor local storage.

  • CONS
  • - You can't associate a visitor with previous visits.
  • - Heatmaps & session replays not available.
  • Advanced Tracking Mode

  • PROS
  • - Visitor History.
  • - Heatmaps & Session Replays ready.
  • - More Available Tracking Statistics.
  • - Associate Custom Parameters with Visitors.
  • CONS
  • - Needs Tracking Consent.
  • - Needs more data to be sent, depending on what modules are activated.
  • Some extra options that are available to you, you can customize how you track.

    Help Tips

    Do Not Track

    Yes, we do honor the Do Not Track (DNT) setting from browsers which support this.

    Do not track is a setting from your browser which, after you enable it, it will tell the sites that you visit that you do not want to be tracked. Unfortunately, it is not very well supported by browsers as of yet but if we receive this header setting from your browser, we are honoring it!

    What if you want to track everyone and skip the DNT setting? It is possible to do that as well if you are a website owner.

    To ignore the DNT and to also track those visitors, simply add data-ignore-dnt="true" like in the following example:

    <script async src="https://aqvil.com/pixel/12345678910111213" data-ignore-dnt="true"></script>
    Help Tips

    Goals

    First of all, you need to understand the concept of a goal. A goal is something that you want to track that the already existing analytics are not tracking—anything from a button click, downloads, specific page view, like a thank-you page after a checkout...etc.

    Pageview

    The pageview goal is the easiest to set up and the conversion of the goal will happen once a visitor reaches a certain specified page.

    A good example would be when you have a 'thank you' page after the conversion happened (newsletter, purchase, form submission...etc) where the user will land on after.

    Custom

    Custom goals will require some extra code implemented to the tracked website, which is specified when you create a new goal from the dashboard.

    A custom goal is mainly used for when you want to track a specific event that happens on your website, which can't be tracked with the pageview method.

    Some examples of where custom goals will shine are:

  • Tracking clicks on external links.
  • Tracking more advanced form submissions.
  • Tracking clicks on specific parts of your pages.
  • Here is what a javascript snippet would look like for goal tracking:

  • aqvil.analytics.goal('my-goal');

    When this code will trigger inside of your page, the goal conversion will be triggered as well on our side.

    Help Tips

    Custom parameters

    If you wish to identify your visitors via custom parameters, then here is how you can do that.

    This feature can be helpful when you have a website that has a membership system where users can log into your website. If they are logged in, you can specify their identifier (ex: email, user_id, name..etc) with our tracking code.

    Why? This becomes very helpful when trying to understand what your users are doing and what problems they encountered on your website.

    You can do this by simply adding data-custom-parameters='{JSON_PARAMETERS_HERE}' like in the following example:

    <script async src="https://aqvil.com/pixel/12345678910111213" data-custom-parameters='{"name": "John Doe", "email": "john@example.com"}'></script>

    If that extra parameter is provided then, in the Visitors page you will see the icon near the visitor which tells you that that specific user has been identified with custom parameters.

    Help Tips

    Opt-Out

    We do take privacy and your privacy seriously and we provide you and your users the ability to opt-out of any website that uses our tracking system.

    If you are a website owner that uses our tracking services then, we highly recommend you to provide the following option for your users to be able to opt-out of the tracking.

    The opt-out process is straight forward and can be done by simply accessing any website that has our tracking code installed and adding the following query parameter in your browser: ?pixel_optout=true

    So if your website is https://domain.com/ and you have our pixel tracking code installed, you and your users can opt-out of the tracking by accessing the following URL https://domain.com/?pixel_optout=true.

    By doing this, we set a local storage variable in your browser that tells our pixel tracking code to stop and do not further execute. Clearing your local storage, changing the browser or running the site in incognito will enable tracking again as the Opt-Out variable is not set anymore.


    Free for 7 Days

    Get ready to change the way you do analytics.

    No credit card required, cancel any time