Configuration options

There are quite some configuration options within the uMarketingSuite. Most of these settings are stored in the configuration file of the uMarketingSuite. For uMarketingSuite 1.x, this configuration file can be found in /config/uMarketingSuite/umarketingsuite.config. For uMarketingSuite 2.x we have adopted the new standard for .NET Core applications, in which we make use of the appsettings.json (and environment variable support). For uMarketingSuite 2.x the structure of the file will be the same as below, but in JSON instead of XML.

If you open this file with your favourite texteditor you've all kinds of options that you can set. If you afterwards save the file you should touch the web.config (which restarts your website!) in order to make sure these new settings are used.

The configuration file will look this:

<Configuration>
  <Settings>
    <DatabaseConnectionStringName>umbracoDbDSN</DatabaseConnectionStringName>
    <Enabled>true</Enabled>
  </Settings>
  <Analytics>
    <VisitorCookie>
      <ExpirationInDays>365</ExpirationInDays>
      <CookieName>uMarketingSuiteAnalyticsVisitorId</CookieName>
      <IncludeSubdomains>false</IncludeSubdomains>
    </VisitorCookie>
    <DataCollection>
      <AnonymizeIPAddress>true</AnonymizeIPAddress>
      <ServersideTrackingEnabled>true</ServersideTrackingEnabled>
      <FlushRateInRecords>100</FlushRateInRecords>
      <FlushIntervalInSeconds>30</FlushIntervalInSeconds>
      <InternalSiteSearch>
        <AutomaticSearchTracking>true</AutomaticSearchTracking>
        <SearchTermParameters>
          <SearchTermParameter>q</SearchTermParameter>
        </SearchTermParameters>
        <SearchBoxParameters />
        <CategoryParameters />
      </InternalSiteSearch>
    </DataCollection>
    <DataStorage>
      <DeleteRawDataAfterDays>5</DeleteRawDataAfterDays>
    </DataStorage>
    <DataProcessing>
      <IntervalInRecords>100</IntervalInRecords>
      <IntervalInSeconds>30</IntervalInSeconds>
      <SessionLengthInMinutes>30</SessionLengthInMinutes>
      <AnonymizeDataAfterDays>730</AnonymizeDataAfterDays>
      <DeleteDataAfterDays>1460</DeleteDataAfterDays>
      <IsProcessingServer>true</IsProcessingServer>
    </DataProcessing>
    <DataCleanup>
      <StartAfterSeconds>300</StartAfterSeconds>
      <IntervalInSeconds>1800</IntervalInSeconds>
      <NumberOfRows>1000</NumberOfRows>
    </DataCleanup>
  </Analytics>
  <ABTesting>
    <MinimumPercentageForAdviceWithPredictedRuntime>25</MinimumPercentageForAdviceWithPredictedRuntime>
    <MinumumPercentageMacroGoalWarning>10</MinumumPercentageMacroGoalWarning>
    <ShareDataLevel>Minimum</ShareDataLevel>
  </ABTesting>
  <Profiles>
    <Potential>
      <ActiveThresholdInDays>30</ActiveThresholdInDays>
      <EngagedThresholdInSeconds>300</EngagedThresholdInSeconds>
      <EngagedThresholdNumberOfSessions>3</EngagedThresholdNumberOfSessions>
    </Potential>
    <Identification>
      <Name>{{name}}</Name>
      <Abbreviation>{{name[0]}}</Abbreviation>
      <ImagePropertyAlias>avatar</ImagePropertyAlias>
    </Identification>
  </Profiles>
  <Reporting>
    <DataGenerationEnabled>true</DataGenerationEnabled>
    <DataGenerationTime>04:00:00</DataGenerationTime>
  </Reporting>
</Configuration>

All these settings are also visualized in the uMarketingSuite. This overview can be found in the section 'Marketing' => Settings => Configuration

You cannot change any of the settings over here and that is by design. To use the new settings the website must be restarted (by touching the web.config) and that is not something that we wanted to make possible via the Umbraco backoffice.

All settings

Section 'Settings'

Section 'Analytics'

Section 'A/B Testing'

Section 'Profiles'

Section 'Reporting'