Setting up custom parameters

Under Automation, the Custom Parameters screen displays the list of current custom parameters.

List of custom parameters and options.

Adding custom parameters

To add a new custom parameter, click Add Parameter in the top right of the Custom Parameter screen. The Add a Custom Parameter dialog controls how the custom parameter is created.

Add a custom parameter options.
  • Click Reuse an Existing Report Field to map this custom parameter to an existing report field. In the drop down menu, select from the list of reusable fields.
    Tip: If you do not see the reusable field you expect in the drop down, contact your Medallia Expert
  • Click Create New Report field to map the new custom parameter to a new field that can be used in Experience Cloud reports.

When creating a new report field, configure the type of field and the parameter information.

Configure the type of field the custom parameter is mapped to.

A custom parameter can be mapped to a new report field created in Experience Cloud as either:

  • an E-field (superseded by Event fields)
  • a Q-field (superseded by Feedback category fields in Program fields)

Optionally, administrators can make the new reporting field reusable by checking the Make this field reusable in all account properties option. Add a suitable name using the text box below the option.

In the lower part of the dialog, configure the parameter's values.

Editing a custom parameter.
  1. Parameter Name Internal name that is displayed in feedback data and reports.

  2. Parameter Type Data type of the parameter to collect, for example text, number, boolean, date, or time. For a date use a UTC timestamp in milliseconds passed in a variable as a string.

  3. Origin Type What type of origin this custom parameter should search for. In Digital the only option is Var, and this drop down is inactive.
  4. Name of what Digital should base this parameter on. For example, a JavaScript variable on the original page named exampleParameter.
  5. Attach Forms Choose at least one survey that this custom parameter should be added to. The drop down contains a list of all surveys created in the property. List of surveys the custom parameter can be attached to.
    • Select All Forms to attach this custom parameter to all surveys in the property.
    • Select All Forms & App Ratings to attach this custom parameter to all forms and all app ratings in the property.
    • Individually select the surveys that the custom parameter is attached to. Depending on the number of surveys in the property, you might need to scroll through the list or use the search box to find the survey by name. Click on a survey name to select it. Click on a selected survey to unselect it.
    The custom parameter is attached to all of the surveys selected in the drop down when you click Apply.
  6. Attach App Ratings In the same way as choosing a survey, optionally choose an app rating that this custom parameter should be added to. The drop down contains a list of all app ratings created in the property. List of app ratings the custom parameter can be attached to. The custom parameter is attached to all of the surveys selected in the drop down when you click Apply.

During execution, Digital attempts to access the origin specified to extract the data and send it to the server with the feedback. If the origin is not on the app when feedback is submitted, a null value is stored.