Информация о посетителе (visitor_info)

Объект visitor_info предназначен для задания информации о посетителе. Может быть задан в настройках инициализации js приложения ( ConveadSettings) или передан в вызове эвента.

Visitor_info содержит набор переменных. Переменные делятся на два типа — стандартные и пользовательские.

Пользовательские поля создаются в разделе Мой аккаунт=>Индивидуальные поля и используются для передачи нестандартных данных. Имя переменной пользовательского поля соответствует имени ключа, указанного при создании поля.

Пример структуры объекта visitor_info с указанием всех известных переменных посетителя:

<code><code>{ first_name: "John", // имя last_name: "Smith", // фамилия/отчество full_name: "John Smith", // фамилия и отчество (если нет раздельных полей имени) email: "<a href="mailto:john_smith@example.com">john_smith@example.com</a>", // email phone: "8-800-000-000", // телефон date_of_birth: "1974-07-30", // дата рождения gender: "male", // пол "male" или "female" my_custom_numeric_property: 1234, // пример пользовательской переменной типа число my_custom_string_property: "foo", // пример пользовательской переменной типа строка my_custom_date_property: "2014-04-20", // пример пользовательской переменной типа дата my_custom_boolean_property: "true" // пример пользовательской переменной типа булев }

Объект visitor_info может содержать в себе только переменные с известными данными. Передача значения в качестве пустой строки (например first_name: ») вызовет стирание известных данных о посетителе в Convead, что приведет к потере информации.

Если в вашей cms поля «имя» и «фамилия» не разделены, то вместо first_name и last_name нужно передавать имя в full_name, при этом Convead разделит имя и фамилию автоматически.

Пример правильной записи объекта visitor_info, когда известно только имя посетителя:

<code><code>{ first_name: "John" }

Пример неправильной записи объекта visitor_info, когда известно только имя посетителя:

<code><code>{ first_name: "John", last_name: "", email: "" }

Передача пустой строки в качестве значения должна использоваться только для очистки неактуальной информации в Convead.

Пример передачи visitor_info при инициализации js приложения:

<code><code>window.ConveadSettings = { visitor_info: { first_name: "John" }, app_key: "xxxxxxxxx" }

Пример передачи visitor_info при отправке эвента:

<code><code>convead('event', 'update_info', {}, {first_name: "John"});

Пример передачи visitor_info в URL API:

<code><code><a href="http://site.com/?convead%5Bevent%5D=update_info&convead%5Bvisitor_info%5D%5Bfirst_name%5D=John">http://site.com?convead[event]=update_info&convead[visitor_info][first_name]=John</a>