Перенос проекта из KeyCollector

Что переносится из файлов .kc4 и .kcdb, как загрузить большой проект и как загрузить частоты и позиции из CSV или Excel в существующий проект.

Keys открывает файлы проектов KeyCollector 4 (.kc4) и KeyCollector 3 (.kcdb). Из файла создаётся новый проект: дерево групп, фразы с галочками и цветами, частоты, данные выдачи, позиции и минус-слова. Ниже по шагам, как перенести проект, что в нём окажется и что проверить после переноса.

Если проект в Keys уже есть и нужно добавить в него частоты или позиции, снятые в KeyCollector или где-то ещё, загрузите выгрузку CSV или Excel: Импорт данных из CSV и Excel в существующий проект.

Как перенести проект

Найдите файл проекта KeyCollector на диске: .kc4 для KeyCollector 4 или .kcdb для KeyCollector 3. Перед загрузкой лучше закрыть проект в KeyCollector, чтобы в файл попали последние изменения.
В Keys откройте страницу проектов и нажмите «Импорт из KeyCollector».
Нажмите на поле «Выберите файл или перетащите сюда» или перетащите файл прямо в него. В поле появятся имя и размер файла.
Впишите «Название проекта». Если оставить поле пустым, проект назовётся по имени файла. Если у вас несколько пространств (команд), выберите, в каком создать проект.
Нажмите «Загрузить». Под полем идёт полоса «Загружено … из …». Пока файл загружается, не закрывайте вкладку: загрузка идёт из вашего браузера.
Когда файл загружен, вы попадёте на страницу нового проекта. Дальше перенос идёт на сервере, и страницу можно закрыть.

Импорт файла проекта KeyCollector всегда создаёт новый проект. Чтобы добавить данные в проект, который уже есть в Keys, выгрузите таблицу из KeyCollector в CSV или Excel и загрузите её через меню «Данные»: как это сделать.

Ход переноса

Пока идёт импорт, проект закрыт для правок: поверх страницы проекта видна надпись с этапом, числом перенесённых фраз и процентом. Этапы такие: «Импорт в очереди…», «Распаковываю файл» (только для .kc4), «Переношу группы», «Переношу фразы», «Переношу выдачу», «Переношу минус-слова». Тот же ход виден на странице проектов над списком.

Можно закрыть вкладку и вернуться позже: перенос продолжится без вас. Крупный проект переносится несколько минут. Если импорт прервался из-за перезапуска сервера, он один раз повторится сам.

Когда перенос закончится, проект откроется для работы. Если страница в этот момент открыта, появится всплывающее сообщение с итогом. Итог в любом случае остаётся во вкладке «Процессы» внизу страницы проекта, в строке «Импорт из KeyCollector»:

Перенесено: 214 групп, 48 310 фраз, частоты у 47 902, выдача у 12 040, позиции у 3 118, минус-слов 1 260 в 9 списках

Числа здесь для примера. Если в файле были повторы фраз, в конце итога добавится число дублей (подробнее ниже).

Ограничения на файл и тариф

Что	Ограничение
Размер файла	до 2 ГБ
Проект .kc4 в распакованном виде	до 30 ГБ
Незаконченные загрузки	не больше 3 одновременно и не больше 4 ГБ на человека; брошенные загрузки удаляются через сутки
Фраз в проекте	«Старт»: 10 000; платные тарифы: 500 000
Число проектов	импорт считается новым проектом: на «Старте» доступен один проект не в архиве

Лимит фраз проверяется до переноса, по числу строк с фразами в файле (повторы тоже считаются). Если фраз больше, чем помещается по тарифу, импорт остановится с сообщением «В проекте KC … фраз, а по тарифу в проект помещается …. Смените тариф или перенесите проект частями.» Перенести частями можно так: разделите проект в KeyCollector на несколько файлов и загрузите каждый отдельным проектом.

Файл загружается частями по 8 МБ. Если связь оборвалась, часть отправляется заново, до 5 попыток. Если вы закрыли вкладку во время загрузки, начните загрузку сначала.

Что переносится

В KeyCollector	В Keys
Группы и подгруппы	Дерево групп с тем же порядком и цветами групп. Удалённые в KeyCollector группы и их фразы пропускаются.
Фразы	Текст, галочка, цвет строки и дата добавления. В колонке «Источник» у них стоит «Импорт KC».
Цвета строк	10 цветов KeyCollector переносятся с теми же номерами и оттенками: Оранжевый, Розовый, Зелёный, Бирюзовый, Голубой, Жёлтый, Серый, Красный, Салатовый, Фиолетовый.
Частоты Wordstat	Базовая, "фразовая" и "!точная" частота в колонках «База», «" "» и «"!"».
Данные выдачи Яндекса	Колонки «Документов», «Главных», «Заголовков».
Позиции	«Позиция Я» и «Позиция G» с URL. Изменение позиции из KeyCollector превращается в прежнюю позицию, поэтому стрелки роста и падения сохраняются.
Топ выдачи	Сохранённые адреса и заголовки топ-10 Яндекса и Google. Их видно в меню строки: «Топ-10 выдачи».
Стоп-слова	Группы стоп-слов становятся минус-списками с теми же названиями. Слова без группы попадают в список «Без списка».

Особые случаи

Одна фраза в нескольких группах

В KeyCollector одна и та же фраза может лежать в нескольких группах. В Keys фраза живёт только в одной группе, поэтому остаётся первая копия по порядку добавления в KeyCollector, остальные не переносятся. Число таких повторов показано в конце итога: «Дублей в KC: N, оставлена первая копия». Повтором считается та же фраза без учёта регистра, буква «ё» приравнивается к «е».

Корзина и фразы без группы

Фразы из корзин KeyCollector 4, если они там были, собираются в группу «Корзина из KeyCollector» в конце дерева.
Фразы, у которых в файле не нашлось группы, попадают в группу «Без группы (из KeyCollector)».
Пустые строки без текста фразы пропускаются.

Галочки у стоп-слов

В Keys галочка у минус-слова значит «участвует в поиске». Поэтому все стоп-слова переносятся включёнными, независимо от того, стояла ли у них галочка в KeyCollector. Ненужные слова можно выключить в окне «Минус-слова». Подробнее: Минус-слова.

Что не переносится

Значения KEI и формулы KEI. В новом проекте стоят шесть формул по умолчанию, и KEI сразу пересчитываются по перенесённым данным. Свои формулы из KeyCollector впишите заново: Формулы KEI.
Адрес сайта. Поле «Сайт» в новом проекте пустое. Без него не снимутся новые позиции.
Другие колонки KeyCollector. Переносятся только данные из таблицы выше.
История правок. Журнал нового проекта начинается с нуля, а сам импорт нельзя отменить через Ctrl+Z.

Что сделать после переноса

Откройте вкладку «Процессы» внизу и прочитайте итог: сколько групп, фраз, частот и позиций перенесено, были ли дубли.
Нажмите на название проекта в шапке, чтобы открыть «Настройки проекта», и впишите сайт. Там же проверьте формулы KEI.
Проверьте группы «Корзина из KeyCollector» и «Без группы (из KeyCollector)», если они появились: перенесите нужные фразы или удалите группы.
Откройте окно «Минус-слова» (Ctrl+M) и выключите слова, которые не должны участвовать в поиске.
Если над проектом работает команда или клиент, откройте доступ кнопкой «Доступ»: Проекты, доступ и архив.

Если импорт не удался

При ошибке или отмене всё, что успело записаться, удаляется. Проект остаётся пустым, с одной группой «Новая группа 1», а сообщение начинается со слов «Импорт не удался». Частые причины:

Сообщение	Что делать
«Нужен файл проекта KeyCollector: .kc4 или .kcdb»	Выберите файл проекта, а не выгрузку в Excel или CSV. Выгрузку загружайте в открытый проект: «Данные → Импорт данных из CSV / Excel», подробнее.
«Файл .kc4 повреждён или это не проект KeyCollector 4»	Сохраните проект в KeyCollector заново и загрузите свежий файл.
«Файл не читается как проект KeyCollector»	Файл повреждён или это другой формат. Проверьте, что он открывается в KeyCollector.
«В проекте KC … фраз, а по тарифу в проект помещается …»	Смените тариф или разделите проект на части.
«Слишком много незаконченных загрузок…»	Дождитесь окончания идущих импортов или повторите через сутки.

Повторный импорт создаёт ещё один проект. На тарифе «Старт» пустой проект после неудачного импорта занимает единственное место: сначала отправьте его в архив или удалите, затем загружайте файл снова. Как это сделать: Архив и удаление.

Импорт данных из CSV и Excel в существующий проект

Так в проект Keys загружаются частоты, данные выдачи, позиции и адреса страниц из таблицы: выгрузки KeyCollector, файла от коллеги или выгрузки самого Keys. Импорт бесплатный и отменяется через Ctrl+Z.

Выгрузите таблицу. В KeyCollector подойдёт экспорт в CSV (кодировка Windows-1251 и разделитель «;» понимаются сами) или в Excel. Файлы, выгруженные из Keys кнопкой «Выгрузить таблицу», тоже подходят.
Откройте проект в Keys и нажмите «Данные → Импорт данных из CSV / Excel…».
Выберите файл или перетащите его в окно. Понимаются .csv, .txt, .tsv и .xlsx. Старый формат Excel .xls сначала пересохраните как .xlsx или CSV.
Проверьте, как Keys прочитал файл. Над окном предпросмотра видны имя файла, число строк и кодировка. Если вместо букв видны непонятные знаки или все данные слиплись в один столбец, поменяйте «Кодировку» или «Разделитель». У книги Excel с несколькими листами выберите «Лист».
Над каждым столбцом выберите, что в нём лежит (какие бывают столбцы). Обязателен только столбец «Фраза». Ненужные столбцы оставьте на «пропустить».
Выберите, что делать с новыми фразами и с уже собранными данными.
Прочитайте сводку внизу окна: сколько фраз уже есть в проекте, сколько новых, сколько значений заполнится и сколько перезапишется. Нажмите «Импортировать».

После импорта появится итог. Кнопки «Показать добавленные» и «Показать обновлённые» оставляют в таблице только эти фразы.

Столбцы

Keys узнаёт столбцы по заголовкам: из выгрузки KeyCollector («Фраза», «Группа», «База [YW]», «" " [YW]», «"!" [YW]», «SERP документы [Yandex]», «Позиция [Yandex]», «URL позиции [Yandex]» и похожие) и из выгрузки Keys. Если заголовки не узнаны, Keys сам снимает галочку «Первая строка с заголовками» и делает первый столбец «Фразой». Галочку можно снять и вручную: первая строка станет данными, а столбцы над таблицей выберите сами.

Столбец	Что в нём должно быть
Фраза	Текст фразы. Фраза ищется в проекте без учёта регистра, «ё» равна «е», лишние пробелы не мешают.
Группа	Название группы или путь «Родитель / Группа». Нужен, только если новые фразы раскладываются по группам из файла.
База, " " фразовая, "!" точная	Частоты, целые числа. Пробелы между разрядами не мешают.
Документов, Главных, Заголовков	Данные выдачи Яндекса.
Позиция Я, Позиция G	Число от 1 до 1000. Прочерк, «>100» или «100+» значат «сайта нет в выдаче»: в таблице будет прочерк, как после проверки позиций.
URL в Яндексе, URL в Google	Адрес страницы, начиная с `http://` или `https://`.

Каждое поле можно выбрать только для одного столбца. KEI из файла не загружаются: они считаются по формулам проекта из загруженных частот и данных выдачи. Значения, которые не удалось понять (текст в столбце частоты, адрес без http), пропускаются: их число видно в сводке.

Фразы, которых нет в проекте

Добавить в группу: все новые фразы ложатся в выбранную группу.
В группы из колонки «Группа», недостающие создать: фраза ложится в группу с названием из файла. Путь «Родитель / Группа» ищется от корня дерева, просто название ищется по всему дереву (берётся первая такая группа сверху). Если группы нет, она создаётся. Строки с пустой «Группой» ложатся в выбранную группу.
Не добавлять, только обновить данные у существующих: новые фразы пропускаются.

Новые фразы получают источник «Файл» и учитываются в лимите фраз тарифа. Фразы, которые уже есть в проекте, остаются в своих группах: импорт их не переносит.

Если у фразы данные уже есть

Заполнить только пустые: значение из файла пишется, только если у фразы такого значения ещё нет. Уже собранные данные не меняются.
Перезаписать значениями из файла: значение из файла заменяет собранное. У позиций прежнее значение становится предыдущим, и в таблице видна стрелка изменения.

Пустая ячейка файла не стирает ничего в обоих режимах. Если в файле одна фраза встречается несколько раз, берётся первая строка.

Отмена и ограничения

Импорт отменяется через Ctrl+Z или кнопкой отмены у последней правки во вкладке «Журнал»: добавленные фразы удаляются, созданные группы тоже (если вы не положили в них свои фразы), а колонки, которые импорт заполнил или перезаписал, возвращаются, какими были. Данные, собранные заданиями после импорта в другие колонки, остаются.
За один раз загружается до 200 000 строк, файл побольше разделите на части. Больше 25 000 строк Keys отправляет частями: в журнале это несколько правок, и Ctrl+Z отменяет по одной части.
У частот из файла регион и период неизвестны. Если потом снимать частоты с галочкой «Только где частоты ещё нет», загруженные значения не перезапишутся и не оплачиваются.