Как загрузить данные в формате CSV
Общее
В Журнале сделок есть функция массовой загрузки сделок из CSV-файла. Она позволяет загружать информацию о сделках из различных источников в Коллтрекинг, тем самым расширяя возможности анализа и обеспечивая централизованный доступ к данным о сделках.
CSV-файл с данными о сделках может быть экспортирован из внешней системы или создан вами вручную, однако он должен соответствовать определенным требованиям.
Загруженные данные объединяются с данными о сделках, собранными коллтрекингом, и отображаются в Журнале сделок. В результате вы получаете «общую картину» по сделкам вашей компании.
Примечание. Редактировать или удалить сделки, загруженные из CSV-файла, вы можете вручную.
Ограничения
Загружать данные о сделках можно одновременно только из одного файла. Если вам надо загрузить сделки из нескольких файлов, вы должны загружать их последовательно, один за одним.
Как загрузить данные в формате CSV
Для этого в Журнале сделок необходимо:
-
в поле «Сайт» выберите виджет, по которому хотите загрузить данные о сделках;
-
нажмите кнопку «Загрузить сделки»:
-
перетащите мышкой CSV-файл или загрузите его с локального диска:
Важно. Загрузить можно только один файл. Если вам надо загрузить несколько файлов, то вы должны загружать их последовательно, один за одним. 
-
дождитесь, когда загрузка файла закончится:
-
нажмите кнопку «Сохранить»:
Будет выполнена проверка файла на соответствие требованиям. Если проверка будет выполнена успешно, то данные по сделкам будут загружены из CSV-файла в Журнал сделок. Иначе будет выдано сообщение об ошибке и данные не будут загружены: 
Требования к CSV-файлу
- Общий размер CSV-файла не должен превышать 50 кб.
- CSV-файл должен содержать следующие параметры, составляющие структуру импортируемых данных:
| Название | Обязательность | Тип данных | Описание |
|---|---|---|---|
| id | required | string | Уникальный идентификатор сделки |
| status | required | string | Статус сделки: new — новая; accepted — в работе; closed — успешно закрытая (сделка состоялась); declined — отклоненная (сделка не состоялась). |
| timestamp | required | string (YYYY-MM-DDThh:mm:ss) | Дата последней модификации сделки или её статуса в формате ISO 8601 |
| amount | optional | number | Сумма сделки в рублях |
| uid | optional | string | Идентификатор пользователя MANGO OFFICE |
| contactPhone | optional | string | Контакт (номер телефона) Клиента |
| gaCid | optional | string | Идентификатор пользователя Google Analytics (Client ID) |
| utmSource | optional | string | Источник (метка utm_source) |
| utmMedium | optional | string | Канал (метка utm_medium) |
| utmCampaign | optional | string | Кампания (метка utm_campaign) |
| utmContent | optional | string | Содержание (метка utm_content) |
| utmTerm | optional | string | Ключевое слово (метка utm_term) |
| regionCode | optional | string | ISO код региона, в котором пользователь зашёл на сайт (например MOW) |
| firstPath | optional | string | Путь, по которому пользователь зашёл на сайт (например /about) |
Пример CSV- файла
Ниже приведен пример структуры CSV- файла для загрузки данных о сделках:
id;status;timestamp;amount;uid;utmSource;firstPath;contactPhone test0001;new;2023−01−01T00:00:01Z;10;;yandex;/page1;+7(495)111−11−01 test0002;accepted;2023−01−01T00:00:02Z;11;testUid;yandex;/page2;+7(495)111−11−02 test0003;closed;2023−01−01T00:00:03Z;12;;yandex;/page3;+7(495)111−11−03
Файл в формате CSV ограничен размером 50 Kb.
Список статусов сделок
new — новая;
accepted — в работе;
closed — успешно закрытая (сделка состоялась);
declined — отклоненная (сделка не состоялась).
