Creating a Custom Event

Before you create a custom event, make sure you know what incidents the event targets, what attributes define the desired incidents, what query parameters identify the attributes. Also, decide whether you want to translate or augment any collected data with a lookup table.

  1. In the left pane, click Administration > Web Analysis > Visitor Data Mart > Events.
  2. Click New.
  3. In the Event Name text box, specify a meaningful name for the new event.
  4. In the Description text box, enter a description of the event.
  5. Create attributes associated with the new event. To start, you can create an event with only one attribute and add the others later, but most events include multiple attributes. Follow these steps to create an attribute:
    1. In the Attributes dialog of the New Event Wizard dialog, click New.
    2. In the Attribute Name text box, specify a meaningful name for the new attribute.
    3. In the Query Parameter text box, specify the query parameter that you want to associate with this attribute. For more information, see the Visitor Data Mart On Demand User's Guide on the Webtrends Documentation page.
    4. From the Type list, select an attribute type.
    5. If you do not want to translate values for this attribute, click Done.
    6. If you want to translate values for this attribute, select Translate values for this attribute. Select a Lookup Table from the list. Select a Key Column from the list. In the Value Columns box, select the columns from which values are returned.
      Note:

      You can only use a particular lookup table once in an event.

      To translate values for this attribute no lookup tables are available to select, use the Advanced settings when configuring a dimension or measure to specify a lookup table, then configure your translation values and click Done.
  6. Repeat Step 5 as necessary.
  7. When you are finished creating attributes, click Next in the New Event Wizard dialog.
  8. If you want to collect data for all hits for this event, select Collect data for all hits in the Event Trigger dialog and click Next.
  9. If you want to collect data only for this event only when it includes specific criteria, complete the following steps:
    1. Select Collect data for hits that match the following criteria.
    2. From the list, specify Equal To or Not Equal To.
    3. In the URL text box, specify a URL to match.
    4. If you select the Regular Expression check box and specify a regular expression, type in the expression and click Test to see if it is a valid expression. If it is, click Apply. If not, continue until your expression passes the test.
  10. If you want to create a new URL parameter, click New. Otherwise, click Next.
  11. If you are creating a new URL Parameter, complete the following steps:
    1. In the Parameter Name text box, specify a parameter name.
    2. To configure a Boolean NOT for the parameter name, select the Match records that do not contain this parameter name check box. Otherwise, proceed to Step c.
    3. For the parameter value, select either, Text, Numeric, or Regular Expression.
    4. From the list, select Equal To or Not Equal To for the parameter value.
    5. In the Parameter Value text box, specify the parameter value, based on the choice you made in Step c.
    6. If you select Regular Expression and specify a regular expression, click Test to see if it is a valid expression. If it is, click Apply. If not, continue until your expression passes the test.
    7. When you are done with the URL Parameter dialog, click Done.
  12. Click Next.
  13. If you want to include the events’ business object in the data extraction, make sure the Business Object available for extraction check box is selected.
  14. If you want to return to a preceding wizard page, click Previous. In the Summary dialog of the New Event Wizard, click Save to complete the event.