Information for: DEVELOPERS   PARTNERS

updatePerson - Personalization JavaScript API

Personalization uses the updatePerson API function to update user-defined Person attributes without creating an Event record or updating the Touch record. The API function can be helpful when there is data from another source you want to append to the person profile, such as firmographic or demographic data. You can provide descriptive names for the attributes in Personalization Web, which are then displayed in the visitor profile summary and the segment builder, using the Content metadata page.

Note

To capture visitor attributes with Google Tag Manager, see Capture visitor identity with Google Tag Manager.

Capturing person attributes

Add the following code to your webpage:

<script type="text/javascript">
_tcaq.push( ['updatePerson',
{'person_udf5':'attributedata1', 'person_udf6':'attributedata2', 'person_udf7': 'attributedata3' }
] );
</script>

where person_udf is a user-defined field for a person and attributedata is the information to add to the person. You can define up to 50 fields for values.

Personalization captures the fields and associates them with the website visitor’s information.

When using an attribute containing a date, the date must display in the following format:

yyyy-MM-dd'T'HH:mm:ss.SSS'Z

For example:

2015-03-25T00:00:00.000Z

Example usage

The following example sets user-defined fields 5, 6, and 7 to firmographic values associated with the business the person works for—the company SMB, categorized as Retail, with 0-50 employees:

<script type="text/javascript">
_tcaq.push( ['updatePerson',
{'person_udf5':'SMB', 'person_udf6':'Retail', 'person_udf7': '0-50 employees' }
] );
</script>

Note

Public _tcaq functions are only available after lift-capture.js is loaded on a page after personalization return. You will know lift-capture.js hasn’t loaded on a page if you receive the following reference error:

ReferenceError: _tcaq is not defined