Перейти к содержанию

Подключение таблицы

Если вы выбрали сценарий «Из таблицы» в разделе Интеграции — нужно подготовить файл и дать редактору доступ.

Откуда берём таблицу

SmartGenPlan читает таблицы из:

  • Google Sheets — лист в Google Drive
  • Яндекс.Диск — XLSX-файл

Других источников пока нет. Excel-файл с компьютера загружается через «Импорт» — это разовое действие, для регулярного обновления не подходит.

Подготовка таблицы

  1. Скачайте шаблон из редактора — в шапке кнопка «Экспорт XLSX». Файл уже содержит правильные колонки и пример заполнения.
  2. Заполните данные — номер участка, цена, площадь, статус, описание. По одной строке на участок.
  3. Загрузите файл в Google Sheets или Яндекс.Диск.

Колонки таблицы

Колонка Что содержит Обязательная
Номер Номер участка как на карте (15, 16А, А-12) Да
Статус available, reserved, sold, with_house, promotion, draft Если хотите автообновление статусов
Цена Число без пробелов и валюты (например 4500000) Нет
Площадь Число в м² или сотках (по настройке проекта) Нет
Описание Произвольный текст Нет
Квартал Название микрорайона / очереди / квартала (для больших проектов). Можно заполнить и в редакторе — поле «Квартал» в карточке участка. Нет

Точные названия колонок — в скачанном шаблоне. Они привязаны через «Соответствие колонок» при первом импорте, дальше робот находит их сам.

Как колонки появляются в попапе участка

Когда посетитель кликает на участок на опубликованной карте — открывается окошко (попап). Поля идут в фиксированном порядке:

  1. Заголовок — «Название проекта Номер». Например, «КП Кедровый 42». Имя проекта берётся из настроек публикации, номер — из колонки «Номер».
  2. Название (колонка «Название» / поле «Название» в редакторе) — короткое имя участка. Показывается только если заполнено.
  3. Статус — переводится на русский по теме («Свободен», «Забронирован», «Продан», «С домом», «Акция», «Недоступен»). Черновики не показываются вообще.
  4. Площадь — в м² или сотках по настройке проекта. Управляется галочкой «Показывать площадь».
  5. Цена и Цена со скидкой — в валюте участка. Скидка показывается только если статус «Акция» и цена со скидкой меньше обычной.
  6. Квартал — название микрорайона / очереди. Показывается только если заполнено.
  7. Описание — отдельный блок без подписи, многострочный.
  8. Кнопка действия — «Забронировать» / «WhatsApp» / «Позвонить» — настраивается отдельно в разделе Публикация → Кнопка действия.

Что прячется и при каких условиях:

  • Все галочки «Показывать ...» в разделе Публикация → Окно и метка участка управляют видимостью соответствующих полей в попапе. Выключили «Показывать цену» — цена нигде не появится (включая всплывающую метку при наведении).
  • Галочка «Показывать описание» одной кнопкой управляет показом и Описания, и Квартала.
  • Для проданных участков есть отдельные галочки «Скрывать цену / площадь / описание / метку / окно полностью у проданных» — позволяет защитить чувствительные данные после сделки.
  • На черновиках попап и кнопка действия не показываются вообще, чтобы посетитель не пытался забронировать неготовое.

Открыть доступ

Google Sheets

  1. Откройте таблицу в Google Sheets.
  2. Кнопка «Поделиться» в правом верхнем углу.
  3. В поле «Получить ссылку» выберите «Все, у кого есть ссылка» → «Редактор».
  4. Скопируйте ссылку.

Яндекс.Диск

Одна ссылка вида https://disk.yandex.ru/i/XXXXXXXX — для всего. Её даёте и менеджеру (для редактирования), и в SmartGenPlan (для автосинхронизации).

Шаги:

  1. Загрузите XLSX-файл на Яндекс.Диск.
  2. Нажмите на файл правой кнопкой → «Поделиться» → «Создать публичную ссылку». Получите ссылку вида https://disk.yandex.ru/i/XXXXXXXX.
  3. Откройте эту ссылку один раз в браузере — это критичный шаг. Яндекс.Диск только в этот момент формирует структуру XLSX для скачивания. Без этого SmartGenPlan получит «пустой» файл при импорте.
  4. Дайте ссылку менеджеру — он по ней попадёт во встроенный онлайн-редактор Яндекс.Диска и будет править таблицу. Что он увидит (просмотр или редактирование) зависит от прав доступа на файле — выставляется в том же меню «Поделиться» / «Настроить доступ».
  5. В SmartGenPlan (поле «URL источника данных» в Публикации → Автосинхронизация, либо в Импорт → URL) вставьте ту же самую ссылку https://disk.yandex.ru/i/.... SGP читает файл через API Яндекс.Диска.

Не вставляйте в SGP сессионную ссылку из адресной строки редактора

Когда менеджер открыл файл в онлайн-редакторе Яндекс.Диска, в адресной строке у него видна ссылка вида https://disk.yandex.ru/edit/d/XXXXX.... Это временная сессионная ссылка, она привязана к текущему сеансу и может прокручиваться. Не копируйте её в SmartGenPlan — редактор покажет ошибку про неправильный формат. Нужна публичная ссылка на файл (/i/...) из меню «Поделиться».

Если позже хотите расширить доступ

Публичная ссылка /i/... привязана к файлу, не к правам доступа. Если сначала открыли файл только для просмотра, а потом захотели разрешить редактирование — поменяйте права в «Поделиться» / «Настроить доступ», ссылка останется прежней. Менеджеру и в SmartGenPlan ничего перевставлять не нужно.

Задержка после правок

После того как менеджер сохранил правки в Яндекс.Диск таблице, новые данные могут подтягиваться в SmartGenPlan с задержкой до 5 минут — это особенность Яндекс.Диска (их CDN кеширует версию файла). Если открыли редактор сразу после правки и видите старые данные — подождите минуту и обновите страницу.

Подключение в редакторе

В редакторе есть два места где работают со ссылкой на таблицу — для разных задач.

Регулярное автообновление — настраивается один раз

Откройте Публикация → Автосинхронизация:

  1. Включите галочку «Автосинхронизация включена».
  2. Вставьте ссылку в поле «URL источника данных».
  3. (Опционально) Нажмите «Синхронизировать сейчас» — редактор сразу подтянет таблицу в пул данных, чтобы проверить что ссылка рабочая и колонки распознаются.
  4. Нажмите «Опубликовать» в шапке — после публикации робот начнёт обходить таблицу раз в час сам.

С этого момента менеджер просто правит таблицу — всё подтянется на сайт автоматически.

Разовый импорт — для проверки или ручной загрузки

Откройте Данные:

  • В поле https://... в шапке вставьте ссылку → нажмите «Импортировать» — для импорта из Google Sheets / Яндекс.Диск.
  • Или нажмите «Выбрать файлы» — для XLSX-файла с компьютера.

Это разовое действие. Регулярного обновления не запустит — для регулярки нужна Автосинхронизация (см. выше).

Первая загрузка таблицы — пошагово

Когда вы загружаете таблицу первый раз и хотите увидеть данные в редакторе до настройки автосинхрона — пройдите три шага в разделе Данные:

Шаг 1. Импорт

В разделе Данные в шапке: вставьте ссылку и нажмите «Импортировать», либо нажмите «Выбрать файлы» для XLSX с компьютера. Редактор скачает таблицу и покажет превью: сколько строк прочитано, какие колонки распознаны, есть ли проблемы.

Шаг 2. Применить импорт

Если превью выглядит правильно — нажмите «Применить импорт». Прочитанные строки попадут в Пул данных — это промежуточное хранилище, ещё не привязанное к конкретным участкам на карте.

Зачем нужен пул? Если в таблице у вас участок с номером, которого нет на карте (например менеджер опечатался), мы не теряем строку — она лежит в пуле, ждёт пока вы либо исправите номер, либо нарисуете участок.

Шаг 3. Привязка к участкам

Из пула данные нужно привязать к участкам на карте — это связывает строку таблицы с полигоном участка и проставляет на нём цену, площадь, статус.

Два способа:

  • Автопривязка по номеру — кнопка в шапке пула. Редактор сопоставит каждую строку пула с участком где совпадает «Номер участка» — если у вас в таблице номера те же что на карте (а так и должно быть), привяжется автоматически. Это нормальный путь.
  • Перетащить вручную — каждую строку пула можно перетянуть мышкой на нужный участок на карте. Полезно если у плота на карте номер не задан (например нарисовали недавно), или для разовой ручной правки.

После привязки участки на карте сразу получают данные. Опубликовать проект — и всё уйдёт на сайт.

А что с автоматическим обновлением?

После того как источник данных настроен (см. предыдущую секцию), регулярные изменения в таблице подтягиваются сами. Раз в час робот:

  1. Скачивает свежую версию таблицы
  2. Обновляет данные на участках (цена, площадь, статус, описание, квартал)
  3. Обновляет пул данных в редакторе (зеркало таблицы)
  4. Заново публикует карту на сайт

Если откроете редактор после очередного автосинхрона — увидите в пуле все строки из таблицы в актуальном состоянии. Уже привязанные к участкам строки сохраняют привязку, новые строки (если в таблице появились новые номера, для которых полигоны ещё не нарисованы) — лежат в пуле как непривязанные. Останется только нарисовать полигон и автопривязка по номеру их подберёт.

Что робот меняет, а что — нет

Робот трогает только данные участков. Все настройки внешнего вида карты он оставляет как есть.

Категория Что меняется автоматически Что робот не трогает
Данные участков Цена, скидка, площадь, статус, описание, квартал, валюта —
Геометрия — Полигоны участков, границы, инфраструктура
Окно участка (попап) — Что показывать (площадь / цена / описание), позиция, метка при наведении
Легенда — Показывать или нет, какие статусы видимы, количество
Цветовая тема, локализация — Тема, язык, валюта по умолчанию
Кнопка действия (CTA) — Способ связи, текст кнопки, ссылка
Скрытие чувствительного для проданных — Все настройки «Скрывать ... у проданных»

Это значит: вы один раз настроили «Скрывать цену у проданных» и нажали «Опубликовать» — дальше робот будет уважать эту настройку при каждом автообновлении. Каждый час перезапись данных не сбросит её.

Как робот обращается с пустыми ячейками

Поле Пустая ячейка в таблице Заполненная
Статус сохраняется как было (защита) перезаписывает
Цена / Площадь / Цена со скидкой очищает (= нет значения) перезаписывает
Описание / Валюта / Квартал очищает перезаписывает
Номера нет в таблице участок не трогается —

То есть пустая ячейка статуса не сбросит «продан» в «черновик» — это намеренная защита от случайной потери критичных данных. А пустая ячейка цены очистит цену на участке — это позволяет менеджеру убрать значение через таблицу.

Когда нажимать «Опубликовать» — важный нюанс

Любая ваша правка в редакторе (вкл/выкл галочка, изменение текста, перетаскивание полигона) сохраняется в редакторе автоматически, но на сайт уходит только когда вы:

  • нажмёте «Опубликовать» — мгновенно
  • или дождётесь следующего часового запуска робота — он опубликует ваши правки за вас (вместе с обновлением данных из таблицы)

Это значит: если вы поменяли настройки попапа в редакторе, но не нажали «Опубликовать» — следующее автообновление таблицы вынесет ваши изменения на публичную карту вместе с обновлением цен. Иногда это удобно (не нужно публиковать вручную), иногда — сюрприз.

Если хотите гарантированную предсказуемость — после любой правки в редакторе нажимайте «Опубликовать» сразу, не оставляя «черновик» висеть в редакторе. Тогда робот никогда не выпустит на публику ничего, что вы сами не отправили.

Когда пул может быть нужен явно

Автосинхрон сам наполняет пул раз в час. Ручной заход в раздел Данные нужен в трёх случаях:

  • Первый раз заводите проект — не хотите ждать час, импортируете сразу
  • Сменили источник (новая таблица) и хотите проверить как ляжет до публикации
  • Меняли таблицу прямо сейчас — кнопка «Синхронизировать сейчас» в редакторе сделает то же что робот, но мгновенно

Что если таблица сломается

  • Если ссылка перестала работать (доступ закрыли) — в Интеграциях появится предупреждение.
  • Робот пытается ещё несколько раз с интервалом, чтобы обойти временный сбой.
  • На карте останется последняя успешно подтянутая версия — посетители увидят актуальные данные пока таблица не починится.

Что НЕ нужно делать

  • Не публиковать проект каждый раз когда поправили таблицу — робот сам подтянет.
  • Не давать всем подряд доступ «Редактор» — только тем кто реально работает с продажами.
  • Не менять структуру колонок (порядок, название) — робот может не найти данные.