How to set up custom parameters
    • 7 Minutes to read
    • Dark
      Light

    How to set up custom parameters

    • Dark
      Light

    Article summary

    1. 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".

    2. Click on Create New Custom Parameter.

    3. 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.

      "First Occurrence" as dimension

      The first occurrence can be calculated for custom parameters with data type text. Please see the dimension pages for more information:

      First occurrence [Dimension Name]

      Date of First Occurrence [Dimension Name]

    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


    Was this article helpful?