Documentation Center

Upgrading smarttarget_conf.xml if you are upgrading from SmartTarget 2011 SP2

The smarttarget_conf.xml file has changed between SmartTarget 2011 SP2 and Experience Optimization 8. Use a migration tool to migrate the file and then, if you are upgrading from SmartTarget 2011 SP2, also manually configure a number of sections in the file.

Procedure

  1. Back up the smarttarget_conf.xml configuration file in your configuration location; for example, create a copy of the file called smarttarget_conf_old.xml.
  2. Open a command prompt.
  3. Access the Experience Optimization installation media.
  4. Access the Migration\ directory.
  5. Run the configuration_upgrade.jar using the following command:
    java -jar configuration_upgrade.jar "/PATH/smarttarget_conf.xml"
    where PATH specifies the location to your smarttarget_conf.xml file.

    The tool creates a smarttarget_conf.xml.upgraded file containing old settings migrated to a new file.

  6. Open smarttarget_conf.xml.upgraded in a text editor and check the migrated settings.
  7. In the <IndexServer> section, change the value of the <Location> child element. This value has changed (Experience Optimization deployment now makes use of the Fredhopper Deployment Agent):
    The following is an example of the old smarttarget_conf.xml setting:
    <Location>c:/fredhopper/instance01/FAS/data/xml/incoming/batch/</Location>
    The following is an example of the new smarttarget_conf.xml setting:
    <Location>c:/fredhopper/indexer/data/fas-xml-incremental/catalog01</Location>
  8. Also in the <IndexServer> section, set the value of the <InstanceName> child element to the name of the Fredhopper Index Server.
  9. In the <SmartTarget><TimeZoneOffset> section of the smarttarget_conf.xml configuration file, enter the offset:
    <TimeZoneOffset>0</TimeZoneOffset>
    For example:
    <TimeZoneOffset>Description
    -7The Content Manager system is in a time zone 7 hours earlier than the Content Delivery system.
    -7:45The Content Manager system is in a time zone 7 hours and 45 minutes earlier than the Content Delivery system.
    +5The Content Manager system is in a time zone 5 hours later than the Content Delivery system.
    +5:30The Content Manager system is in a time zone 5 hours and 30 minutes later than the Content Delivery system.
  10. In the <Analytics> section, enter details of your Google Analytics account:
    <!--  Analytics  -->
      <Analytics implementationClass="com.tridion.smarttarget.analytics.google.GoogleAnalyticsManager" timeoutMilliseconds="5000" trackingRedirectUrl="/redirect/">
        <ServiceAccountEmailAddress/>
        <PrivatekeyPath/>
        <AccountId/>
        <TrackingId/>
        <ViewId/>
        <CustomDimensions>
        <ExperimentId>dimension1</ExperimentId>
        <InstanceId>dimension2</InstanceId>
        <PublicationId>dimension3</PublicationId>
        <PageId>dimension4</PageId>
        <Region>dimension5</Region>
        <ComponentId>dimension6</ComponentId>
        <ComponentTemplateId>dimension7</ComponentTemplateId>
        <ChosenVariant>dimension8</ChosenVariant>
        </CustomDimensions>
      </Analytics>
    The <Analytics> element has the following properties:
    PropertyDescription
    implementationClassThe class that implements the analytics provider.
    trackingRedirectUrlA relative URL to your Web site redirects folder, by default "/redirect/".
    timeoutMillisecondsThe time in milliseconds to wait to retrieve the Experiment from the analytics provider before timing out.
    The <Analytics> element has the following child elements:
    ServiceAccountEmailAddress
    The email account created when you created a Project in the Google Console Developer.
    PrivatekeyPath
    The path to the location of the P12 key generated when you created a Project in the Google Console Developer, for C:/Google/MyProject RS-8235a2fedac7.p12.
    AccountId
    The Account ID created when you set up Google Analytics.
    TrackingId
    The Tracking ID created when you set up Google Analytics.
    ViewId
    The View ID created when you set up Google Analytics.
    CustomDimensions
    The custom dimensions created when you set up Google Analytics to bring Content Manager data into the platform:
    ElementValue
    ExperimentIddimension1
    InstanceIddimension2
    PublicationIddimension3
    PageIddimension4
    Regiondimension5
    ComponentIddimension6
    ComponentTemplateIddimension7
    ChosenVariantdimension8
  11. Save your smarttarget_conf.xml.upgraded file as smarttarget_conf.xml.