customer

What can you do?

Improve User Identification

To improve user identification, you can use customer IDs in addition to Mapp's long-term cookies. This allows cross-device and cross-browser user identification. Learn more about User-centric tracking here. Customer IDs can be passed to the Smart Pixel following a successful login or completed order, for example. These customer IDs can be evaluated in the Mapp tool under Visitors > Visitors > Last Custom Visitor IDs.

Enable User Matching with Mapp Engage

You can configure User matching (including user creation) with Mapp Engage. Find more information on Mapp Cloud User Matching on this page.

Send additional user-specific information

Track additional user-specific information via categories that help you to analyze and segment users.

Parameter overview

Methods

The customer object contains the following four methods, which are contained in the objects data and category:

• set: Overwrites all existing values.

• add: Overwrites only the corresponding values.

• get: Returns the current configuration.

• remove: Removes the current configuration or individual values.

data

set

/**
 * @param {{
 *      [id=""]: string,
 *      [emailRID=""]: string,
 *      [emailOptin=false]: boolean,
 *      [registrationEmail='']: string,
 *      [registrationGroupId=""]: string,
 *      [registrationMode=""]: string,
 *      [registrationFirstName=""]: string,
 *      [registrationLastName=""]: string,
 *      [registrationGender=""]: string,
 *      [registrationTitle=""]: string,
 *      [registrationOptin=false]: boolean,
 *      [category={}]: {[number]: string}
 * }} data
 *
 * @returns {wtSmart.customer.data}
 */
wtSmart.customer.data.set(data);

add

/**
 * @param {{
 *      [id]: string,
 *      [emailRID]: string,
 *      [emailOptin]: boolean,
 *      [registrationEmail='']: string,
 *      [registrationGroupId=""]: string,
 *      [registrationMode=""]: string,
 *      [registrationFirstName=""]: string,
 *      [registrationLastName=""]: string,
 *      [registrationGender=""]: string,
 *      [registrationTitle=""]: string,
 *      [registrationOptin=false]: boolean,
 *      [category]: {[number]: string}
 * }} data
 *
 * @returns {wtSmart.customer.data}
 */
wtSmart.customer.data.add(data);

get

/**
 * @returns {{
 *      id: string,
 *      emailRID: string,
 *      emailOptin: boolean,
 *      registrationEmail: string,
 *      registrationGroupId: string,
 *      registrationMode: string,
 *      registrationFirstName: string,
 *      registrationLastName: string,
 *      registrationGender: string,
 *      registrationTitle: string,
 *      registrationOptin: boolean,
 *      category: {[number]: string}
 * }}
 */
wtSmart.customer.data.get();

remove

/**
 * @param {string[]} [removeList]
 *
 * @returns {wtSmart.customer.data}
 */
wtSmart.customer.data.remove(removeList);

Example object data

// set customer data
wtSmart.customer.data.set({
	id: 'user5684798169',
	emailRID: '',
	emailOptin: true,
	registrationEmail: 'john.doe@mapp.com',
	registrationGroupId: '123456',
	registrationMode: 'o',
	registrationFirstName: 'John',
	registrationLastName: 'Doe',
	registrationGender: 'm',
	registrationTitle: '',
    registrationOptin: true,
	category: {
		5: 'login'
	}
});

// add customer data
wtSmart.customer.data.add({
	emailRID: 'foo.bar'
});

// get customer data
var data = wtSmart.customer.data.get();
  
// remove all customer data
wtSmart.customer.data.remove();

// remove only registrationFirstName, and registrationLastName from customer data
wtSmart.customer.data.remove(['registrationFirstName', 'registrationLastName']);

category

set

/**
 * @param {{[number]: string}} data
 *
 * @returns {wtSmart.customer.category}
 */
wtSmart.customer.category.set(data);

add

/**
 * @param {{[number]: string}} data
 *
 * @returns {wtSmart.customer.category}
 */
wtSmart.customer.category.add(data);

get

/**
 * @returns {{[number]: string}}
 */
wtSmart.customer.category.get();

remove

/**
 * @param {number[]} [removeList]
 *
 * @returns {wtSmart.customer.category}
 */
wtSmart.customer.category.remove(removeList);

Example object category

// set customer category
wtSmart.customer.category.set({
    1: 'login'
});

// add customer category
wtSmart.customer.category.add({
    7: 'foo.bar'
});

// get customer category
var data = wtSmart.customer.category.get();
  
// remove all customer category
wtSmart.customer.category.remove();

// remove only customer category 7
wtSmart.customer.category.remove([7]);

Code Generator

Use the code generator to create individual code that you can then integrate directly into the website.