Changing the daily scheduled time for marketing triggers and lists

You can change the time of day that the SendMarketingTriggers scheduled job processes daily check Dialog activity triggers, and generates best-seller and top-browsed lists. By default, this happens at 2:00 AM each day. If this time is not appropriate, you can create a customized version of the wc-admin-component.xml file to specify a different time of day.

About this task

The SendMarketingTriggers job processes the following daily check triggers once a day:
  • Customer Is In Segment
  • Customer Abandons Cart
  • Customer Celebrates Birthday

If these triggers are used in Dialog activities to send emails with the Send Message action, make sure that the time of day you specify in this task is earlier than the time of day that marketing emails are scheduled to be sent in the Administration Console. To check the send time that is configured for outbound email activity accounts, see Configuring email activity accounts. Leave an hour buffer between the two times, if possible. For example, if the outbound email activity account is scheduled to send emails at 4 AM, set the daily scheduled time for marketing triggers to run no later than 3 AM.

The time of day is based on the machine where HCL Commerce Server is installed.

Procedure

  1. Open HCL Commerce Developer and switch to the Enterprise Explorer view.
  2. If you already have a customized version of the marketing component configuration file at workspace_dir\WC\xml\config\com.ibm.commerce.marketing-ext\, skip to step 3. If not, create one:
    1. Navigate to the following path:

      workspace_dir\WC\xml\config\

    2. In the config folder, add com.ibm.commerce.marketing-ext folder so the path looks like this:

      workspace_dir\WC\xml\config\com.ibm.commerce.marketing-ext\.

    3. Navigate to the default marketing component configuration file at the following path:

      workspace_dir\WC\xml\config\com.ibm.commerce.marketing\

    4. Copy the default wc-admin-component.xml file to the new com.ibm.commerce.marketing-ext folder you created.
    5. Open the copied wc-admin-component.xml file in an editor. This copy becomes the customized version of the wc-admin-component.xml file.
  3. In the customized file at workspace_dir\WC\xml\config\com.ibm.commerce.marketing-ext\wc-admin-component.xml, locate or add the following line:
    <_config:property name="dailyScheduledJobTimeForTriggers" value="02:00"/>
  4. Change the value of the value parameter to a different time of day.

    The format for time is hh:mm where:

    • hh = Two digits that represent the hour (00 - 23)
    • mm = Two digits that represent the minute (00 - 59)
  5. Within the <_config:configgrouping name="MarketingRuntime"> element, remove any properties that are not set differently from the default marketing component configuration file at workspace_dir\WC\xml\config\wc-admin-component.xml. The customized file must contain only the changed properties.
  6. Save and close the customized wc-admin-component.xml file.
  7. Restart the HCL Commerce server.
  8. Deploy the customized file to the production environment.