Custom Properties - Tracking the state of a checkbox

On this page, we're going to learn how to set up the tracking of your installer's checkbox(es) state 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 checkbox that we want to track. Let's say that we want to track if the users who install the application choose to associate your application with specific file extensions.

  • We need to go to the 'Files and Folders' view and make sure to have our application's executable file added (in case of a new project)
    Custom Properties - Files and Folders View with EXE
    Files and Folders View with EXE
  • We need to go to the 'File Associations' view and add the extensions that our application supports; in our case, we'll use .ext and .samp
    Custom Properties - File Associations View
    File Associations View
  • We need to go to check the "Place extension in a separate feature" checkbox and enable the "Show in FileAssociationsDlg dialog" for both extensions to add them to a predefined dialog automatically
    Custom Properties - Configured File Associations View
    Configured File Associations View
  • We need to go to the 'Dialogs' view and select the 'FileAssociationsDlg' dialog
    Custom Properties - Dialogs View
    Dialogs View
  • We need to click on each of the checkboxes in order to identify their associated properties; in our case, the checkboxes are linked to the EXT_CHECKBOX and SAMP_CHECKBOX properties
    Custom Properties - .ext Checkbox
    Dialogs View - .ext Checkbox Property
    Custom Properties - .samp Checkbox
    Dialogs View - .samp Checkbox 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 properties associated with the checkboxes into the Installer Analytics view of our project. In our case, the properties are EXT_CHECKBOX and SAMP_CHECKBOX. 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' section, 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 'EXT_CHECKBOX' and press 'OK'
    Custom Properties - EXT_CHECKBOX
    EXT_CHECKBOX property
  5. Enter 'SAMP_CHECKBOX' and press 'OK'
    Custom Properties - SAMP_CHECKBOX
    SAMP_CHECKBOX property
  6. When installing, it should look like this
    Custom Properties - EXT_CHECKBOX and SAMP_CHECKBOX in Installer
    EXT_CHECKBOX and SAMP_CHECKBOX checkboxes in Installer

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 - EXT_CHECKBOX and SAMP_CHECKBOX in WebApp
EXT_CHECKBOX and SAMP_CHECKBOX properties 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 checkbox, be it an Advanced Installer predefined one or any other custom added checkbox. As long as you identify its associated property, you can track it using the method above.

docsPlease also note that VIEWREADME and RUNAPPLICATION predefined properties cannot be tracked at the moment since the values of the defined tracked properties are reported before their value is known. If you need such a feature, please get in touch with us.