Ручная загрузка продаж

Интеграция связывает строки продаж с рекламой VK по utm_content (ID объявления) или utm_campaign (ID кампании).

Загрузка подходит, если продажи уже есть в CRM, кассе или таблице, но нет готовой API-интеграции. Одна строка файла — одна продажа. После импорта Вектор показывает количество продаж, их стоимость и, если заполнены суммы, выручку, ROAS и ROI.

Статус пункта в меню «Интеграции» показывает текущее состояние:

• Нет данных — продажи ещё не загружены или были очищены;
• Загрузка… — импорт в очереди или выполняется;
• Есть несопоставленные продажи — нужно проверить UTM;
• Загружено (статистика выключена) — данные есть, но не добавляются в отчёты;
• ✓ Загружено — данные готовы и предупреждений нет.

Демонстрация — данные вымышлены

Как проходит загрузка

Шаг 1 из 5

Рекламный кабинет

Интеграции

Senler✓ Подключено

Ручная загрузка продажЕсть несопоставленные продажи

!

Статус меняется от «Нет данных» до «✓ Загружено», а предупреждение показывает несопоставленные UTM.

1. Подготовьте UTM-метки

До запуска рекламы добавьте в ссылку кампании:

• utm_content= — ID объявления; эта метка даёт самую точную привязку;
• utm_campaign= — ID кампании; Вектор использует его, если объявление определить не удалось.

В файл нужно перенести фактические VK ID, которые пришли вместе с заказом, а не тексты и . Достаточно хотя бы одной из двух меток. При наличии обеих Вектор сначала ищет объявление.

2. Скачайте шаблон

Выберите удобный формат:

• Скачать шаблон CSV
• Скачать шаблон XLSX

Не переименовывайте заголовки и не добавляйте колонки. CSV-шаблон использует UTF-8 с BOM и точку с запятой, чтобы корректно открываться в русской локали Excel.

3. Заполните восемь колонок

Колонка	Нужно заполнить	Что указать
sale_id	Да	Уникальный неизменный ID продажи, например order-1001; от 1 до 128 символов. Регистр важен.
sold_at	Да	Дата и время продажи. Если в значении нет часового пояса, при загрузке выберите его отдельно.
amount_rub	Нет	Сумма продажи в рублях. Пусто = сумма неизвестна; 0 = известная нулевая сумма.
utm_source	Нет	Источник, обычно vk_ads.
utm_medium	Нет	Тип трафика, например cpc.
utm_campaign	Если нет utm_content	Числовой ID кампании VK.
utm_content	Если нет utm_campaign	Числовой ID объявления VK.
utm_term	Нет	Дополнительная метка для вашей аналитики; можно оставить пустой.

Не добавляйте личные данные

Не используйте email, телефон или имя покупателя как sale_id. Возьмите нейтральный ID заказа. Неизвестные колонки блокируют весь файл, чтобы лишние данные не попали в Вектор.

Форматы даты

sold_at принимает дату Excel и текст:

YYYY-MM-DD HH:MM
YYYY-MM-DD HH:MM:SS
YYYY-MM-DDTHH:MM:SSZ
YYYY-MM-DDTHH:MM:SS+03:00
DD.MM.YYYY HH:MM
DD.MM.YYYY HH:MM:SS

Дата без offset трактуется в часовом поясе файла; по умолчанию — Europe/Moscow.

Форматы суммы

amount_rub принимает число Excel, 14990.00, 14990,00 и пробелы как разделители тысяч. Допустимы значения от 0.00 до 999999999999999.99, не более двух знаков после разделителя. Отрицательные суммы, формулы, NaN/Infinity и значения с более чем двумя знаками блокируют импорт. Валюта всегда рубли.

4. Загрузите файл

1. В нужном кабинете откройте Рекламный кабинет → Интеграции → Ручная загрузка продаж.
2. На вкладке Загрузка нажмите Выбрать файл.
3. Если CSV неоднозначен, укажите кодировку (UTF-8 или Windows-1251) и разделител (;, , или табуляция). Для XLSX с несколькими листами выберите лист.
4. Проверьте часовой пояс и дождитесь предпросмотра.

Пользователь с ролью viewer может смотреть сводку и историю. Загрузка, предпросмотр, подтверждение, отмена, настройки и очистка доступны только editor или owner.

5. Проверьте предпросмотр

В сводке показываются физические и пустые строки, валидные, новые и обновляемые продажи, строки с суммой и без неё, сопоставления с объявлением или только с кампанией, UTM-конфликты и несопоставленные строки.

• Новая — sale_id ещё нет в Векторе; после подтверждения будет создана продажа.
• Обновляемая — sale_id уже есть; дата, сумма и UTM будут заменены значениями из файла.
• Несопоставленная — Вектор не нашёл указанные VK ID в выбранном кабинете. Продажа сохранится, но не попадёт в метрики рекламных объектов.
• UTM-конфликт — utm_content ведёт к объявлению из другой кампании, чем utm_campaign. Выигрывает более точное сопоставление по объявлению; конфликт остаётся в счётчике предупреждений.

Если есть blocking error, кнопки Подтвердить импорт не будет. Исправьте файл и загрузите его заново: данные не изменятся частично. Несопоставленные UTM и конфликты — предупреждения; они не блокируют остальные валидные продажи.

6. Как считаются показатели

1. Продажи = количество атрибутированных продаж за выбранный период.
2. Стоимость продажи = расход ÷ количество продаж.
3. Сумма продаж = сумма всех известных amount_rub.
4. ROAS = сумма продаж ÷ расход × 100%.
5. ROI = (сумма продаж − расход) ÷ расход × 100%.

Продажи, сопоставленные с кампанией, учитываются на уровне кампании. На уровне группы и объявления видны только продажи, найденные по utm_content. При нуле продаж стоимость продажи показывается как —; при нулевом расходе ROAS и ROI также —. Итоги и экспорт пересчитывают формулы из общего расхода, количества и выручки, а не складывают готовые отношения.

7. Если суммы заполнены не везде

• Суммы есть у всех продаж. Выручка, ROAS и ROI показываются без примечания.
• Суммы есть только у части продаж. Вектор покажет сумму и рассчитанные по ней ROAS/ROI, но добавит примечание «Сумма указана для X из Y продаж». Эти значения неполные.
• Сумм нет ни у одной продажи. Выручка, ROAS и ROI не показываются. «Продажи» и «Стоимость продажи» остаются.

8. Продажи в Dashboard

Откройте Рекламный кабинет → Настроить отображение и в группе Ручные продажи включите нужные колонки. Они скрыты по умолчанию. Доступные показатели видны в строках кампаний, групп и объявлений, в мобильных карточках и итогах.

В CSV/XLSX-экспорте рядом с выручкой, ROAS или ROI появится колонка «Покрытие суммы продаж», если суммы заполнены частично. Подробнее о настройке таблицы — в разделе о колонках.

9. Продажи в Аналитике

В разделе Аналитика показатели продаж доступны:

• в карточках KPI и сравнении с предыдущим периодом;
• на графике динамики по дням;
• в воронке Показы → Клики → Продажи, где конверсия продаж считается от кликов;
• в рейтинге лидеров и аутсайдеров;
• в CSV-экспорте динамики. При выборе выручки, ROAS или ROI в нём есть колонки «Продаж с суммой» и «Продаж без суммы».

На графике каждый день имеет своё покрытие сумм. Объект без единой известной суммы не попадает в рейтинг по выручке, ROAS или ROI, но может участвовать в рейтинге по количеству и стоимости продажи. Подробнее — в обзоре Аналитики.

10. Исправления и повторные загрузки

Импорт накопительный. Новый sale_id добавляет продажу; повторный sale_id заменяет её дату, сумму и UTM. Чтобы исправить продажу, загрузите её строку с тем же sale_id и правильными значениями. Так же исправляется несопоставленная UTM.

Если в новом файле нет ранее загруженного sale_id, продажа не удаляется. В одном файле sale_id не должен повторяться — такой дубль блокирует весь импорт.

11. Как очистить все продажи

Откройте Интеграции → Ручная загрузка продаж → Настройки и нажмите Очистить все продажи. Подтверждение привязано к текущему кабинету. Очистка недоступна, пока есть активный предпросмотр или импорт.

Канонические продажи будут удалены, а метрики пересчитаны. Общая история заданий останется без значений строк. Если нужно убрать одну лишнюю продажу, в первой версии нужно очистить все данные и заново загрузить исправленный файл.

12. Ошибки и предупреждения

Что видно	Что делать
Неверные или лишние колонки	Скачайте свежий шаблон, скопируйте только восемь разрешённых колонок и не меняйте регистр заголовков.
Повтор sale_id	Оставьте в текущем файле одну строку с этим ID.
Неверная дата или сумма	Используйте один из форматов в описании колонок; не используйте формулы.
Нужна UTM-метка	Заполните utm_content или utm_campaign.
Продажа не сопоставлена	Проверьте, что VK ID относятся к текущему кабинету, и повторно загрузите тот же sale_id.
Колонок продаж нет в Dashboard/Аналитике	Проверьте, что статистика интеграции включена, период охватывает даты продаж, а сами продажи сопоставлены с рекламой. Выручка/ROAS/ROI также скрыты, если все amount_rub пусты.

13. Лимиты и приватность

• Только .csv и .xlsx; .xls, .xlsm, ссылки на Google Sheets и архивы не принимаются.
• Размер — до 20 МиБ; до 50 000 непустых строк продаж; до 500 технических колонок XLSX до проверки восьми разрешённых заголовков.
• Формулы, макросы и внешние ссылки книги отклоняются.
• Исходный файл удаляется после предпросмотра. В истории нет имени файла, sale_id, UTM или значений строк — только даты, статусы и счётчики.
• Номера проблемных строк и безопасный код ошибки показываются максимум для 100 строк; их значения не возвращаются.
• Незавершённая загрузка хранится до 30 минут, готовый предпросмотр — до 60 минут. После истечения нужно загрузить файл заново.

14. Короткие ответы

Повторная загрузка создаст дубли?

Нет. Один и тот же sale_id обновляет существующую продажу. Новый sale_id добавит новую.

Можно ли не заполнять сумму?

Да. Количество и стоимость продажи будут доступны. Выручка, ROAS и ROI появятся, если сумма известна хотя у одной продажи в выбранном срезе, и будут помечены как неполные.

Почему продажа есть в сводке, но нет в рекламных метриках?

Скорее всего, utm_content/utm_campaign не сопоставились с объектами выбранного кабинета. Исправьте UTM и повторите загрузку с тем же sale_id.

Можно ли удалить одну продажу?

В первой версии — нет. Можно очистить все продажи и загрузить исправленный файл.

См. также: Интеграции, Dashboard, Аналитика, Решение проблем.