Custom Properties - Tracking the value of a text field

On this page, we will learn how to set up the tracking of your installer's text fields' value using Installer Analytics.

First, we'll need an Advanced Installer project. You can open your existing project or create a new one. You can always follow a tutorial like this one if you're new to Advanced Installer.

Second, we need to identify the text field that we want to track. Let's say that we want to track the location where the users install your application.

  • We need to go to the 'Dialogs' view
    Custom Properties - Dialogs View
    Dialogs View
  • We need to open the 'FolderDlg' since that is the dialog that contains our field
    Custom Properties - Folder Dialog
    Dialogs View - Folder Dialog
  • We need to click on the field in order to identify its associated property
    Custom Properties - Install Path Field
    Dialogs View - Install Path Field
  • In our case, the field is linked to the APPDIR property
    Custom Properties - Install Path Field Property
    Dialogs View - Install Path Field Property

Third, we'll need to enable the Installer Analytics tracking for that project. If you're unfamiliar with this step, you can follow this link to guide you step by step.

Fourth, and this is the most crucial part, we need to add the property associated with the field into the Installer Analytics view of your project. In our case, the property is APPDIR. To do so, we need to:

  1. Navigate to the Installer Analytics view from your Advanced Installer project
    Custom Properties - Installer Analytics View
    Installer Analytics View
  2. In the 'Report Installation Data', you'll see the Custom Properties table
    Custom Properties - Table
    Custom Properties Table
  3. Press 'Add' in order to open the 'Select a Property' picker
    Custom Properties - Property Picker
    Select a Property picker
  4. Enter 'APPDIR' and press 'OK'
    Custom Properties - APPDIR
    APPDIR property
    Custom Properties - Added APPDIR
    Added APPDIR property

Fourth, we need to save, build the project, and finally release the installer to your customers. Once these have been done, your clients will start installing your product, and Installer Analytics WebApp will show the tracking data.

Custom Properties - APPDIR in WebApp
APPDIR property reported in the WebApp

Note: You can also test the tracking yourself before releasing it to ensure that everything was configured correctly. If you plan to do so, please use the Only Filtered IPs option, as your IP might be already placed in the exclusion list from the App Settings view in the 'IP Filter' section.

docsPlease note that you can use this method for any field, be it an Advanced Installer predefined one as the one with the 'APPDIR' property or any other custom added field. As long as you identify its associated property, you can track it using the above method.