How to set up custom parameters
The configuration of custom parameters is done in Mapp Q3. Click on Mapp Q3 > Configuration > Custom Parameters and select the parameter type:
Parameter Based on dimension Visible in the section (only for Datatype "Text") Session parameters Session ID Visitors > Session Parameters Page parameters Pages Navigation > Page Parameters Event parameters Events Navigation > Event Parameters Campaign parameters Ad Media Marketing > Campaign Parameters E-Commerce parameters Order ID, Products E-Commerce > E-Commerce Parameters Independent parameters Date with time Visitors > Independent Parameters Get inspired by reading the training chapter "Setup Options for the Tracking of Elements".
Click on Create New Custom Parameter.
Configure the Parameter
Field Description Title
Shows the name of the parameter. Description Helps others to understand what this parameter is good for. Only visible in the configuration. Active In case of deactivation, no data is collected. The analysis of historical data is still possible. Preconfigured Choose between a Figure of predefined parameters and your own configuration.
With predefined parameters you can simplify the setup process:
- Faster setup with fewer errors: you don't have to care about advanced settings. It automatically selects the optimal configuration.
- Allows easy integration of plugins. Some of them are based on the automatically selected Parameter-IDs (e.g., Content Engagement).
You find a list of available Preconfigurations below.
Parameter-ID This ID is used in the chosen tracking integration to assign values to this parameter. Datatype - Text: Allows you to store a limited amount of data in the text format (max. 255 characters).
The parameter will be available as a dimension, a metric (counting the quantity) and visible in the main menu. Generic: Allows you to store a unlimited amount of data in the text format (max. 510 characters).
The parameter will be available as a dimension, a metric (counting the quantity) and visible in the main menu.
Generic Parameters are subject to charge and limited.
- Figure: The parameter is available as a metric. See Aggretation
Aggregation Only available for Datatype "Figure".
Datatype "Text" and "Generic" always use the Aggregation "Quantity".
- Quantity: Shows, how often a parameter was tracked.
One metric with the name "Qty [Name of the parameter]" will be created. - Quantity and Sum: In addition to the quantity a metric is generated, that adds up the tracked values.
Two metrics will be created: "Qty [Name of the parameter]" and "[Name of the parameter]"
Example:
A parameter "Internal Search results" is submitted twice, once with the value 5 and once with the value 3.
"Qty Internal Search results" = 2
"Internal Search results" = 8
Amount Parameter Values How much information should be submitted in one request? Further information can be found here.
Available Preconfigurations
| Parameter type | Name | Description | How to track? | Automatic tracking | On which pages? | Parameter-ID | Datatype | Amount Parameter Values | Aggregation |
|---|---|---|---|---|---|---|---|---|---|
| Session | Adblocker | Shows the usage of Adblockers | Pixel-Plugin | X | All | 803 | Text | Single Value | Quantity |
| Session | Advertising Opt Out | Used in App tracking | SDK | X | 813 | Figure | Single Value | Quantity | |
| Session | App First Open | Flag for the first open of an app | SDK | X | 821 | Text | Single Value | Quantity | |
| Session | App updated | Flag for the update of an app | SDK | X | 815 | Figure | Single Value | Quantity | |
| Session | App preinstalled | Used in App tracking. | SDK | X | 816 | Figure | Single Value | Quantity | |
| Session | App release | Used in App tracking. | SDK | X | 805 | Text | Single Value | Quantity | |
| Session | App version | Used in App tracking. | SDK | X | 804 | Text | Single Value | Quantity | |
| Session | Login status | Shows whether a user was logged in in the session. Should only be filled if logged in (ideally with "true" or similar) | Pixel, SDK | After login | 800 | Text | Single Value | Quantity | |
| Session | NPS Feedback | NPS feedback score (1-10). Can be used for to list the different scores. | Pixel-Plugin | X | NPS sent | 819 | Text | Single Value | Quantity |
| Session | Net Promoter Score | NPS feedback score (1-10). Can be used to calculate promotore, disctractors and indifferent. | Pixel-Plugin | X | NPS sent | 818 | Figure | Single Value | Quantity and Sum |
| Session | Playstore-Advertiser-ID | App store advertisers Id | SDK | X | 809 | Generic | Single Value | Quantity | |
| Session | TV&Radio-Spot sending time | TV&Radio parameter | Import | 544 | Text | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Flight | TV&Radio parameter | Import | 541 | Text | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Genre after | TV&Radio parameter | Import | 543 | Text | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Genre before | TV&Radio parameter | Import | 542 | Text | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Costs per Spot | TV&Radio parameter | Import | 548 | Figure | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Theme | TV&Radio parameter | Import | 538 | Text | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Position in commercial break | TV&Radio parameter | Import | 545 | Text | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Range | TV&Radio parameter | Import | 549 | Figure | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Broadcast Station | TV&Radio parameter | Import | 537 | Text | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Spot duration | TV&Radio parameter | Import | 547 | Figure | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Name of spot | TV&Radio parameter | Import | 536 | Text | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Environment after | TV&Radio parameter | Import | 534 | Text | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Environment before | TV&Radio parameter | Import | 539 | Text | Single Value | Quantity and Sum | ||
| Session | TV&Radio-Commercial breaks total | TV&Radio parameter | Import | 546 | Text | Single Value | Quantity and Sum | ||
| E-Commerce | App Download (Website Goal) | Flag for the link click to the app store, should be filled with "true" or similar or the app variant for additional info | Pixel | Link to App store clicked | 569 | Text | Single Value | Quantity | |
| E-Commerce | Payment method | Payment method. E.g. "Paypal" | Pixel, SDK | Order confirmation | 761 | Text | Single Value | Quantity | |
| E-Commerce | Email Subscription (Website Goal) | Flag for the email subscription event. Should be filled with "true" or similar | Pixel, SDK | Registration click or on double opt-in page | 564 | Text | Single Value | Quantity | |
| E-Commerce | Coupon Value | Total coupon value | Pixel, SDK | Order confirmation | 563 | Figure | Single Value | Quantity and Sum | |
| E-Commerce | Contact (Website Goal) | Flag for the contact event (usually on finance websites). Should be filled with "true" or any other useful info | Pixel, SDK | Contact request sent | 568 | Text | Single Value | Quantity | |
| E-Commerce | Lead (Website Goal) | Flag for the lead generation event (usually on finance websites). Should be filled with "true" or any other useful info | Pixel, SDK | Request for an offer sent | 567 | Text | Single Value | Quantity | |
| E-Commerce | Shipping duration | Shipping duration | Pixel, SDK | Order confirmation | 763 | Figure | Single Value | Quantity | |
| E-Commerce | Product sold out | Flag for products being out of stock | Pixel, SDK | Product detail | 760 | Figure | Several Values | Quantity and Sum | |
| E-Commerce | Product on Sale | Flag for products being on sale | Pixel, SDK | Product detail, product added to basket, order confirmation | 675 | Text | Several Values | Quantity | |
| E-Commerce | Subscription (Website Goal) | Flag for the general customer registration. Should be filled with "true" or similar | Pixel, SDK | Registration click | 566 | Text | Single Value | Quantity | |
| E-Commerce | Return Value | Order return value for the individual products | Import | 561 | Figure | Several Values | Quantity and Sum | ||
| E-Commerce | Social Media Follow (Website Goal) | Flag for the click on a social media button on the website. Should be filled with "true" or similar or the name of the social media platform | Pixel, SDK | Click on a social media button | 565 | Text | Single Value | Quantity | |
| E-Commerce | Cancellation Value | Order cancellation value for the individual products | Import | 562 | Figure | Several Values | Quantity and Sum | ||
| E-Commerce | Shipper | Shipping method or partner | Pixel, SDK | Order confirmation | 762 | Text | Single Value | Quantity | |
| E-Commerce | Shipping costs | Shipping costs | Pixel, SDK | Order confirmation | 764 | Figure | Single Value | Quantity and Sum | |
| Page | Number of search results | Total number of search results to be tracked on the search result page | Pixel, SDK | Search result page | 771 | Figure | Single Value | Quantity and Sum | |
| Page | Article heading | Headline of an article (publishing industry) | Pixel, SDK | Article pages | 774 | Text | Single Value | Quantity | |
| Page | Screen Orientation | Screen orientation for mobile, usually "landscape" or "portrait" | SDK | X | Each relevant page | 783 | Text | Single Value | Quantity |
| Page | Content tags | Content tags for an article or other kind of page | Pixel, SDK | Article pages | 775 | Text | Several Values | Quantity | |
| Page | Days since publication | Number of days since an article has been published | Pixel, SDK | Article pages | 779 | Figure | Single Value | Quantity and Sum | |
| Page | Domain | Domain of a page. Only relevant if you are tracking multiple domains and the domain is not part of the page name | Pixel | All | 752 | Text | Single Value | Quantity | |
| Page | Login Status | Shows whether a user was logged in on the page. Can be filled if logged in or not logged in | Pixel, SDK | All | 751 | Text | Single Value | Quantity | |
| Page | Page type | Type of a page. E.g. "overview", "article detail" | Pixel, SDK | All | 777 | Text | Single Value | Quantity | |
| Page | Pagination | Number of page in a list (for example for category pages or search result pages) | Pixel, SDK | All pages with pagination | 750 | Text | Single Value | Quantity | |
| Page | Paywall calls | Flag for views of a page behind a paywall, should be filled with "true" or similar | Pixel, SDK | All pages behind paywall | 773 | Text | Single Value | Quantity | |
| Page | Page Load Time | Used by old version of page load time plugin, not recommended | Pixel | X | 570 | Figure | Single Value | Quantity and Sum | |
| Page | Page title | Title of a page | Pixel, SDK | All | 776 | Text | Single Value | Quantity | |
| Page | Tabbed browsing | Tab browsing flag, contains the number of times the page was viewed again via tab browsing | Pixel | X | 770 | Figure | Single Value | Quantity | |
| Page | Viewport | Viewport type (breakdown) of a mobile responsive website | Pixel | All | 780 | Text | Single Value | Quantity | |
| Event | App Crash - Type | App crash info | SDK | X | 910 | Figure | Single Value | Quantity | |
| Event | App Crash - Message | App crash info | SDK | X | 912 | Text | Single Value | Quantity | |
| Event | App Crash - Name | App crash info | SDK | X | 911 | Text | Single Value | Quantity | |
| Event | App Crash - Return Addresses | App crash info | SDK | X | 917 | Text | Single Value | Quantity | |
| Event | App Crash - Stack | App crash info | SDK | X | 914 | Text | Single Value | Quantity | |
| Event | App Crash - Cause Message | App crash info | SDK | X | 913 | Text | Single Value | Quantity | |
| Event | App Crash - Cause Stack | App crash info | SDK | X | 915 | Text | Single Value | Quantity | |
| Event | App Crash - User Info | App crash info | SDK | X | 916 | Text | Single Value | Quantity | |
| Event | Error - Message | Error message in case of an error | Pixel, SDK | Pages with potential error messages | 503 | Text | Single Value | Quantity | |
| Event | Error - Type | Error classification in case of an error | Pixel, SDK | Pages with potential error messages | 504 | Text | Single Value | Quantity | |
| Event | Scroll Depth (Figure) | Used by scroll position plugin | Pixel-Plugin | X | 501 | Figure | Single Value | Quantity and Sum | |
| Event | Scroll Depth | Used by scroll position plugin | Pixel-Plugin | X | 540 | Text | Single Value | Quantity and Sum | |
| Event | Page Length | Used by scroll position plugin | Pixel-Plugin | X | 502 | Figure | Single Value | Quantity and Sum | |
| Event | Page Load Time | Used by page load time plugin | Pixel-Plugin | X | 920 | Figure | Single Value | Quantity and Sum | |
| Event | Teaser - Views | Used by teaser tracking & Marketing Automation plugins | Pixel-Plugin | X | 523 | Figure | Single Value | Quantity and Sum | |
| Event | Teaser - Content | Used by teaser tracking & Marketing Automation plugins | Pixel-Plugin | X | 526 | Text | Single Value | Quantity | |
| Event | Teaser - Item Page in Widget | Used by teaser tracking & Marketing Automation plugins | Pixel-Plugin | X | 532 | Text | Single Value | Quantity | |
| Event | Teaser - Item Position in Widget | Used by teaser tracking & Marketing Automation plugins | Pixel-Plugin | X | 533 | Text | Single Value | Quantity | |
| Event | Teaser - Clicks | Used by teaser tracking & Marketing Automation plugins | Pixel-Plugin | X | 524 | Figure | Single Value | Quantity and Sum | |
| Event | Teaser - Conversions | Used by teaser tracking & Marketing Automation plugins | Pixel-Plugin | X | 528 | Figure | Single Value | Quantity and Sum | |
| Event | Teaser - Name | Used by teaser tracking & Marketing Automation plugins | Pixel-Plugin | X | 521 | Text | Single Value | Quantity | |
| Event | Teaser - Page Engagement | Used by teaser tracking & Marketing Automation plugins | Pixel-Plugin | X | 525 | Figure | Single Value | Quantity and Sum | |
| Event | Teaser - Placement | Used by teaser tracking & Marketing Automation plugins | Pixel-Plugin | X | 520 | Text | Single Value | Quantity | |
| Event | Teaser - Rule | Used by teaser tracking & Marketing Automation plugins | Pixel-Plugin | X | 531 | Text | Single Value | Quantity | |
| Event | Teaser - Type | Used by teaser tracking & Marketing Automation plugins | Pixel-Plugin | X | 527 | Text | Single Value | Quantity | |
| Event | Teaser - Widget Request ID | Used by Marketing Automation plugin | Pixel-Plugin | X | 529 | Generic | Single Value | Quantity | |
| Event | Teaser - Target Group | Used by Marketing Automation plugin | Pixel-Plugin | X | 530 | Text | Single Value | Quantity | |
| Event | Test - Experiment | Name of an A/B/n test | Pixel, SDK | 830 | Text | Single Value | Quantity | ||
| Event | Test - Variant | Variant of an A/B/n test | Pixel, SDK | 831 | Text | Single Value | Quantity | ||
| Event | Content Engagement - Name | Used by Content Engagement | Pixel-Plugin | X | All relevant pages | 921 | Text | Single Value | Quantity |
| Event | Content Engagement - Element Visibility % (figure) | Used by Content Engagement | Pixel-Plugin | X | All relevant pages | 922 | Figure | Single Value | Quantity and Sum |
| Event | Content Engagement - Element Visibility % (text) | Used by Content Engagement | Pixel-Plugin | X | All relevant pages | 923 | Text | Single Value | Quantity |
| Campaign | Google Click ID | Click ID provided by Google in the URL ("gclid"), needs to be read out and provided to the tracking | Pixel | All | 607 | Generic | Single Value | Quantity | |
| Campaign | Keyword | SEA keyword | Pixel | All | 606 | Generic | Single Value | Quantity | |
| Campaign | Link Position | Position description of an individual link, usually within an email | Pixel | All | 601 | Text | Single Value | Quantity |
Further information
Setup Options for the Tracking of Elements