- 1 Minute to read
- Print
- DarkLight
Update Custom User Attributes in Engage Using the Intelligence Pixel
- 1 Minute to read
- Print
- DarkLight
General Information
To effectively update custom user attributes in Mapp Engage, the Intelligence Pixel offers a streamlined way to set specific user attributes within the Engage platform. This how-to guide will walk you through configuring and using custom user attributes via the Intelligence Pixel
Prerequisites
Account Setup
- Ensure that Mapp Engage and Mapp Intelligence accounts are connected.
- Enable user matching between Mapp Intelligence and Engage (refer to Mapp Cloud User Matching).
- Confirm that account settings are compatible with IPv6 and that tracking domains support it if applicable.
Tracking Pixel Configuration
- Configure the tracking pixel (see Smart Pixel Setup & Configuration).
- Integrate tracking for your website's customer behaviors (e.g., browse abandonment) using unique, consistent event names.
Custom Attribute Management
- Create the necessary custom attributes in Engage (see how). This is essential because any missing attribute will cause the entire update request to be ignored.
Procedure
We are sending information about the product the user has last viewed along with the timestamp when they abandoned the browse, in the form of a custom attribute to Mapp Engage.
Use Pixel Code for Attribute Updates: Use the Intelligence Pixel code to update user attributes, which could include details like
last_viewed_product
, orabandonedTimestamp
.Example
window.wtSmart.engage.data.set({ attributes: { lastViewedProduct: '12345', // A string representing the last product viewed abandonedTimestamp: new Date().toISOString() // ISO 8601 date format for the timestamp } });
In this example, we are updating two user attributes:
lastViewedProduct
stores the ID of the last viewed product.abandonedTimestamp
records the time of abandonment in ISO 8601 format, suitable for Engage’s date attribute requirements.
Send the Update Request: After setting the attributes, call
wtSmart.track()
to send the update request. The attributes are included in theeaj
parameter within the request URL:eaj=%7B%22lastViewedProduct%22%3A%2212345%22%2C%22abandonedTimestamp%22%3A%222024-11-04T12%3A34%3A56.789Z%22%7D