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.

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>

ReferenceError: _tcaq is not defined

updatePerson - Personalization JavaScript API

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

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

2015-03-25T00:00:00.000Z

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

ReferenceError: _tcaq is not defined