Digital is a dynamic environment that includes features such as custom parameters to enrich the survey feedback. A custom parameter is a reference to information on your website or mobile app, and collects data exposed on the front-end of the site about the customer's identification and attributes such as their purchases or behavior. Use custom parameters to:
collect data when a survey is submitted
trigger invitations to provide feedback according to specific data
Custom parameters are often used with a dataLayer object that has been added by a web developer, or a tool such as Google Tag Manager or Adobe Analytics.
By default, all Custom parameters are automatically set up as text q-fields in Medallia Experience Cloud. Custom parameters can be shared across forms but not across properties. Custom parameters can be added to dashboards, but are not assigned by default.
Document audience and usage
See the following topics for details on custom parameters:
Data collection examples
A custom parameter collects information from a website or mobile app and adds it to the feedback collected. For example, if a webpage displays the username for a logged-in user, a custom parameter could store this information instead of asking the user to provide that information during survey submission. This is useful when a webpage includes data that can provide more information about a user or add to the context and information about the customer's experience at the time of survey submission.
For an online shopping page, when a customer leaves feedback, use custom parameters to understand any or all of the following items:
Did the user place anything in the cart?
What is the value of the cart?
How many items are in the cart?
Is the customer logged in?
Is the customer a specific type of customer, such as bronze, silver, gold, or platinum?
Is there a specific campaign ID or transaction information?
If a custom parameter is attached to a survey, the feedback item contains a new section and a new field when the feedback is received. The custom parameter does not add a field to the survey.
The following lists some examples of how custom parameters can be used in different industries:
eCommerce/retail - Cart value, loyalty, products viewed or purchased
Insurance - Member type, group number
Travel hospitality - Confirmation code, loyalty ID
In a similar way that a custom parameter can provide additional information when a survey is submitted, a custom parameter can also be used to define when a survey is triggered. For example, on a webpage that exposes information related to specific types of customers (such as bronze, silver, gold, or platinum), set up a custom parameter to capture this information. This custom parameter can then be used for targeting.
Custom parameter types
Custom parameters can collect data from the following origins:
Cookie, for example created using Google Tag Manager or Adobe Analytics.
URL parameters, for example after the "?" character in
example.com/?search=heatedBlanket&color=Blueare two parameters -
s_obj - Default variable containing the Adobe Analytics data and eVars (e.g., s_obj.eVar1).
|Domain portion of a URL (e.g., www.company.com).|
|Full URL (e.g., https://company.com/path1/path2).|
|Path portion of a URL (e.g., /path1/path2).|
|URL of the document that loaded the current document.|
Reusing custom parameters
For every data point created in Digital there is a corresponding field in the Medallia Experience Cloud reporting module. This is true for survey components as well as custom parameters. Reusing a custom parameter means the same reporting field mapping can be used across all properties in the account. Use the self-service reusable custom parameter fields to:
- Determine if the custom parameter is mapped to an existing reporting field or create a new reporting field.
- Administrators can configure a new or existing custom parameter to be reused in other properties within the account. See Adding custom parameters.
Note the following important features of reusing custom parameters:
- All Digital custom parameters are defined in reporting fields as Q-Fields of type "Text".
- It is not possible to map two custom parameters within the same property to the same report field as it could cause data inconsistencies.
- It is only possible to use self-service mapping to fields that have been created in Digital. To map custom parameters to fields that were previously created in the Admin suite please contact your Medallia Digital Expert.