Contents x
      customer
      • 2 Minutes to read
      • Print
      • Dark
        Light
      Contents

      customer

      • 2 Minutes to read
      • Print
      • Dark
        Light
      Article summary

      To improve customer identification, you can use customer IDs and Mapp's long-term cookies ("eid"). Learn more about User-centric tracking here.

      Overview

      Value

      Description

      Data type

      Default value

      Required

      Where to analyze

      Request Parameter

      id

      Use this parameter to transfer a unique identifier for the user. It can be a unique identifier from your shop or CMS system or the customer's email address. If the latter, it is necessary to encrypt the email address and ensure it is unreadable (e.g., using the MD5 or SHA256 hash) to comply with data protection requirements.

      If you use an unhashed e-mail address as a customer ID, the pixel automatically generates a SHA256 hash and uses that as the customer ID.

      String


      Yes

      Dimension "Custom Visitor Id"

      cd

      emailRID

      Use this parameter to transfer the email receiver ID of the user.

      If you are using Mapp Engage, it gets automatically filled with the Mapp Engage contact ID when a user clicks an email. This allows for identifying users between Mapp Intelligence and Mapp Engage.

      String


      -

      -

      uc701

      emailOptIn

      Use this parameter to transfer the opt-in email status of the user.

      Boolean

      false

      -


      uc702

      gender

      Use this parameter to transfer the gender of the user. 1 male. 2 female.

      Number

      0

      -

      Dimension "User - Gender"

      uc706

      birthday

      Use this parameter to transfer the user's birthday (YYYYMMDD).

      String


      -

      Dimension "User - Age"

      uc707

      street

      Use this parameter to transfer the street of the user.

      String


      -

      Dimension "User - Street"

      uc711

      country

      Use this parameter to transfer the country of the user.

      String


      -

      Dimension "User - Country"

      uc708

      city

      Use this parameter to transfer the city of the user.

      String


      -

      Dimension "User - City"

      uc709

      category

      You can use this parameter to categorize customers and create meaningful visitor segments. Find more details below.

      Object


      -

      Visitors > User - Relationship Management > User Categories

      uc[ID]

      validation

      true overwrites existing customer information.

      Boolean

      false

      -

      -

      uc713

      Further information

      category

      Before use, categories must be set up under Mapp Q3 > Configuration > Categorisation > URM Categories. The ID and data type (text/number) are defined for each parameter during setup. Find more info here.

      Example (parameter with ID "1"): {1:"Status: Gold"}

      It is recommended to transmit hashed personal data that is not evaluated in terms of content (e.g. with the SHA256 hash). If you would like to collect this data for analytical reasons, we recommend that you transmit the data in encrypted form.

      Implementation Example

      import { WebtrekkSmartPixelReact, WebtrekkCustomerData } from "@webtrekk-smart-pixel/react";
      import { WebtrekkSmartPixelReact, WebtrekkCustomerData } from "@webtrekk-smart-pixel/next";

      If you do not have automatic page tracking enabled, invoke the track method after adding all relevant tracking information.

      WebtrekkSmartPixelReact.customer("user5684798169", {
     emailRID: "",
     emailOptin: true,
     gender: 1,
     birthday: "19870913",
     country: "Germany",
     city: "Berlin",
     postalCode: "10115",
     street: "Robert-Koch-Platz",
     category: {5: "login"}
}, false);

      If you do not have automatic page tracking enabled, invoke the track method after adding all relevant tracking information.

      render()
{
    return (
        <div>
            <WebtrekkCustomerData
                id="user5684798169"
                emailRID=""
                emailOptin={ true }
                gender={ 1 }
                birthday="19870913"
                country="Germany"
                city="Berlin"
                postalCode="10115"
                street="Robert-Koch-Platz"
                category={ {5: "login"} }
                validation={ false }
            />
        </div>
    );
}

      Was this article helpful?
      What's Next