Pages

Learn how to create and edit a custom action, and define the settings for the custom action.

About creating custom actions

Basic custom actions are typically created through tracking rather than directly in the Frosmo Control Panel. In other words, the Frosmo custom script or your own data layer code triggers a new custom action on your site, the custom action data gets stored in the Frosmo back end, and the custom action becomes available in the Control Panel. You can then edit the custom action and give it, for example, a description.

Basic custom action values are also typically added through tracking (when a custom action is triggered with a new value) rather than in the Control Panel (by manually defining a new value). However, you can further define the values in the Control Panel by giving them descriptive titles.

Geolocation custom actions are created in the Control Panel. Once created, the Frosmo JavaScript library takes care of tracking the visitor's location and triggering the custom actions as necessary.

For more information about the custom action types and how to track them, see Introduction to custom actions and Tracking custom actions.

Creating a custom action

To create a custom action:

  1. In the Frosmo Control Panel, select Utilities > Custom Actions.
  2. Click Create custom action.
  3. Define the custom action settings.

    Creating a custom action

  4. When you're done, click Save.

You can now use the custom action to implement other features.

If you created a basic custom action, you still need to implement tracking for it, before any features built on it can function correctly. Make sure the name and values used in the tracking match the ones you defined in the Control Panel.

Editing a custom action

To edit a custom action:

  1. In the Frosmo Control Panel, select Utilities > Custom Actions.
  2. In the custom actions list, find the custom action you want to edit, click the quick menu button for the custom action, and select Edit.

    Editing a custom action

  3. Edit the custom action settings.

    If you're editing a basic custom action, only edit the regular value-name pairs. If you're editing a geolocation custom action, only edit the geolocation values.

  4. When you're done, click Save.

Custom action settings

To define the settings for a custom action:

  1. Define the basic information for the custom action.
  2. Select Values.
  3. Define the values for the custom action.

Basic information

The following table describes the basic information you can define for a custom action in the Control Panel.

Table: Basic information for a custom action

SettingDescriptionRole
NameEnter a name for the custom action.Required
DescriptionEnter a description for the custom action.Optional
Use as a state

If you want to use the custom action as a state in modifications, enable this setting.

For more information, see Using custom actions with other features.

You cannot use geolocation custom actions as states in modifications.

Required

Defining the basic information for a custom action

Figure: Defining the basic information for a custom action

Values

You can define one or more values for a custom action. You can define the values either for a basic custom action or a geolocation custom action, but not both. Your choice determines the type of the custom action.

Basic custom action

To define the values for a basic custom action:

  1. In the Values view, select Custom action.
  2. Enter a Value and optionally its Title. The value is case-sensitive and must be unique for this custom action.
  3. To add another value, click Add another value, and repeat from the preceding step.
  4. To remove a value, click Remove for the value.

Defining the values for a basic custom action

Geolocation custom action

To define the values for a geolocation custom action:

  1. In the Values view, select Geolocation.
  2. Enter a Title for the location you want to track, and define the location either by entering its Latitude, Longitude, and Radius, or by clicking show map and drawing the location on the map. To hide the map, click show map again.
  3. To add another location, click Add another value, and repeat from the preceding step.
  4. To remove a value, click Remove for the value.

Defining the values for a geolocation custom action