Personizely exposes some Javascript methods to give you more flexibility in using it.

Identify API

ply.identifyVisitor(data) - returns a Promise

data - object, containing information about the visitor and custom fields values. The object can have the following properties:

email - string, a valid email address

firstName - string, visitor's first name

lastName - string, visitor's last name

phone - string, visitor's phone number

companyName - string, visitor's company name

companyTitle- string, visitor's company title

marketingConsent- boolean, visitor's marketing consent status

privacyConsent- boolean, visitor's privacy consent status

address - string, visitor's address

bio - string, visitor's bio

customFieldValues" - object, visitor's custom field's values

The custom field values object is an object where the keys are the custom fields id's which can be found on the Settings page and the values are the values of the respective fields for current visitor.

For radio and select field types you need to make sure that the choice options are valid ones, so if you have a field named "Gender" with 2 options: Male, Female, you won't be able to save a different value than one of those two values.

The checkbox type fields should receive a boolean value.

The number type fields should receive a numeric value.

An example call:

window.ply.identifyVisitor({
  "email": "test@personizely.net",
  "firstName": "John",
  "lastName": "Doe",
  "phone": "+1665599555",
  "companyName": "Personizely",
  "companyTitle": "CEO",
  "marketingConsent": true,
  "privacyConsent": true,
  "address": "5th Avenue",
  "bio": "My bio",
  "customFieldValues": {
     "1": "Male"
   }
})

Goal Tracking API

To track custom goals using JS use the exampe below:

ply.trackGoal('%Event name%', %Goal value%)

Event name - the name of the event (can be anything)

Goal value - goal value in the currency of you website

For example to track a purchase worth 100$ on your site, you can use the following code on your thank-you page:

ply.trackGoal('Purchase', 100)

Manual Widget Trigger

ply.showWidget(id, suppressRules)

You show up any widget using this method indifferently of the triggers it has assigned to it.

id - integer, the id of the widget

suppressRules - boolean, whether to suppress the widget rules

Updated on: 07/05/2021