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

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

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

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

{
  first_name: "John", // имя
  last_name: "Smith", // фамилия/отчество
  full_name: "John Smith", // фамилия и отчество (если нет раздельных полей имени)
  email: "john_smith@example.com", // email
  phone: "8-800-000-000", // телефон
  date_of_birth: "1974-07-30", // дата рождения
  gender: "male", // пол "male" или "famale"
  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, когда известно только имя посетителя:

{
  first_name: "John"
}

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

{
  first_name: "John",
  last_name: "",
  email: ""
}

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

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

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

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

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

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

http://site.com?convead[event]=update_info&convead[visitor_info][first_name]=John

Все еще нужна помощь? Связаться с нами Связаться с нами