What are multi-value parameters and how are they working?
Mapp Intelligence supports custom parameters with single- or multiple values. Both allow sending a list of information in a tracking request. But only multi-value parameters can be logically connected with each other. This means that the individual pieces of information can be directly linked to each other based on their position within the request.
In this example, the error message and error message code belong together and should therefore also be directly linked in the evaluation:
So if you want to track several parameters with different information in one request, which you want to link together, you should use the multi-value parameters.
Common use cases for multi-value parameters
- track (multiple) error messages and error codes on a page
- track (multiple) tags on a page with a related tag category
- track all visible teasers on a page with additional teaser-related information
Examples
Example 1: One parameter
Setup:
Track all error messages on a page with the "Error messages" parameter.
Case:
A user gets 2 error messages on the page "Checkout.1": Salutation missing, City missing
Analysis:
If you are using the two dimensions in a pivot table, it will show the following:
This use case can also be implemented with a single values parameter. The example wouldn't change.
Example 2: Combination of several multi-value parameters
Setup:
Track all error messages on a page with the "Error messages" parameter.
Track an error code for each message with the parameter "Error messages codes"
Case:
A user gets 2 error messages on the page "Checkout.1": Salutation missing (error code 107), City missing (error code 109)
Analysis:
If you are using the three dimensions in a pivot table, it will show the following:
Example 3: Combination of single and multi-value parameter
Setup:
Track all error messages on a page with the "Error messages" parameter. It's configured as a multi-value parameter.
Track the A/B testing variant with the parameter "A/B testing variant". It's configured as a single-value parameter.
Case:
A user sees testing variant "B" and gets 2 error messages on the page "Checkout.1": Salutation missing, City missing
Analysis:
If you are using the three dimensions in a pivot table, it will show the following:
Example 4: E-Commerce parameters
E-commerce parameters have a special feature: they refer not to a single object but to (potentially) several products. Each multi-value parameter uniquely relates to a product.
Setup:
You track different product information when placing an order:
- Product size - configured as a multi-value parameter.
- Product color - configured as a multi-value parameter.
Case:
A user buys two products:
- Product A: Size L, Color blue
- Product B: Size 42, Color red
Analysis:
If you are using the three dimensions in a pivot table, it will show the following:
Related Information
How to set up custom parameters