Экспорт предназначен для выгрузки сырых данных по шаблону без обработки. Кодировка файла - UTF-8, переносы строки не важны Настройки шаблона. Хранятся в файле template_settings.ini в корневом каталоге шаблона. Если файла нет, используются настройки по умолчанию. Файл не копируется в результирующую папку. Формат файла настроек (если настройка по-умолчанию, то её значение можно не вписывать): [template_settings] template_regexp=.+\.csv - Регулярное выражение для файлов, в которых производятся замены. Остальные файлы копируются как есть. unique_elements=0 - Значение 1 означает специальный режим выгрузки, где каждый элемент данных встречается только один раз с part_id_0 start_marker_begin=[ - Начальный маркер начала блока (значение по умолчанию с пробелом на конце). start_marker_end=: ] - Конечный маркер начала блока. finish_marker_begin=[ : - Начальный маркер окончания блока. finish_marker_end= ] - Конечный маркер окончания блока. extension_delimiter= - Разделитель имени и расширения блока, если оно есть (значение по умолчанию - пробел). variable_begin=% - Маркер начала переменной variable_end=% - Маркер окончания переменной escape_mode=0 - Режим экранирования: 0 - нет, 1 - CSV (" -> ""), 2 - JSON (\" \\ \t \n \r) trim_last_repeat= - Строка, которую нужно обрезать в конце последнего repeat-блока (например, запятая или
) browser_open_file= - Имя файла для открытия в браузере после формирования отчёта (значение по умолчанию - пустая строка - открытие корневой папки) Блоки. В HTML-коде блоки выглядят так (при условии дефолтных маркеров): [ name_of_block: ] HTML-код [ :name_of_block ] Имя блока помещается между соответствующими маркерами. Расширение имени отделяется от имени блока разделителем extension_delimiter (по умолчанию - пробел). Переменная выглядит так: %variable_name% (имя переменной заключено между двумя маркерами переменной, по умолчанию - %). Если блок в программе отключен, весь кусок (начиная с первого "[ " и заканчивая последним " ]") вырезается. Если в коде нужно сделать вывод данных этого блока в разных местах, то можно создать несколько дополнительных блоков в таком формате: [ name_of_block ext: ] HTML-код [ :name_of_block ext ] Где "ext" - любой дополнительный уникальный идентификатор (через пробел). Блоки не должны повторяться. Нельзя добавлять в код два блока с одинаковым именем. Это привело бы к неверной замене. Поэтому нужны дополнительные "ext". Если программа находит два или более блока с одинаковым именем, она считает это ошибкой. Если всё нормально, программа работает с этим блоком, делая в нём замены, а в конце заменяет его, вырезая маркеры. Все последующие переменные и блоки должны быть обёрнуты в конструкцию списка групп: [ groups_repeat: ] ... [ :groups_repeat ] Блок основной информации группы: %group_name% - Имя группы %group_key% - Идентификатор группы %parent_group_name% - Имя родительской группы (или пусто, если нет) %parent_group_key% - Идентификатор родительской группы (или -1, если нет) %group_subgroups_count% - Количество непосредственных подгрупп Список непосредственных подгрупп: [ subgroups_repeat: ] %subgroup_name% %subgroup_key% [ :subgroups_repeat ] В каждой группе содержится несколько блоков даты-времени: [ datetime_repeat: ] %datetime% - Дата и время %datetime_cmp% - Дата и время для сравнения (или "—", если нет даты сравнения) Подблок - настройки: [ settings_block: ] %elements_count% - Количество элементов данных в группе Перечислитель элементов группы: [ elements_repeat: ] %element_id% - Идентификатор элемента данных Переключатель типа данных элемента (выводятся подходящие из них, остальные удаляются): [ keyword_element_switch: ] У этого элемента настроек нет. Можно его вообще не выводить. [ :keyword_element_switch ] [ engine_element_switch: ] %proxy_region% - Регион прокси-серверов (или "Любой", если не задан) %browser_name% - Имя браузера (или "—", если задан свой User-Agent) %browser_os% - Операционная система браузера (или "—", если задан свой User-Agent) %browser_accept_language% - Язык браузера [ :engine_element_switch ] [ wordstat_element_switch: ] Доступны все переменные из engine_element_switch и дополнительно: %frequency_type% - Тип частотности ("Базовая", "Фразовая", "Точная", "Фразовая с фиксированным порядком слов", "Точная с фиксированным порядком слов") %frequency_type_marker% - Тип частотности значком (пусто для базовой и "", "!", "[]", "[!]" для остальных) %frequency_db% - База Вордстата ("Все", "Десктопы", "Мобильные", "Только телефоны", "Только планшеты") %regions% - Строка с перечислением регионов в формате Вордстата (или пусто, если регионы не заданы) %regions_text% - Регионы текстом (или "Все регионы", если не заданы) [ :wordstat_element_switch ] [ searchengine_element_switch: ] Доступны все переменные из engine_element_switch и дополнительно: Блок доменов сайта (вырезается полностью, если ни один домен не задан): [ site_domains_block: ] %site_domains_size% - Количество заданных доменов Сами домены: [ site_domains_repeat: ] %domain% - Домен без http[s]:// и www., punicode раскодирован %domain_lower% - То же в нижнем регистре %target_url% - Целевая страница внутри домена, начинается с / %subdomains% - "true" или "false" %target_type% - Тип совпадения ("Домен и любой URL", "Домен и точный URL", "Домен и начало URL") [ :site_domains_repeat ] [ :site_domains_block ] Блок настроек кластеризации (вырезается полностью, если кластеризация отключена): [ clusterisation_block: ] %threshold% - Степень схожести результатов поиска ("min" или число от 1 до 20) %random_tests% - Случайный порядок кластерных тестов ("true" или "false") %combine_clusters% - Объединение кластеров при необходимости ("true" или "false") %max_tests% - Максимальное число кластерных тестов (0 - без ограничений или число от 1 и выше) [ :clusterisation_block ] [ :searchengine_element_switch ] [ yandex_element_switch: ] Доступны все переменные и блоки из searchengine_element_switch и дополнительно: %region% - Номер региона (или пусто, если регион не задан) %region_text% - Регион текстом (или "Все регионы", если не задан) %use_xml% - Использование Яндекс XML ("true" или "false") %use_yandex_when_xml_error% - Использование Яндекса при невозможности использовать Яндекс XML ("true" или "false") %xml_page_results% - Число результатов на странице при проверке через Яндекс XML %xml_check_until% - Глубина проверки при использовании Яндекс XML %yandex_domain% - Домен Яндекса, использующийся для проверки позиций %page_results% - Число результатов на странице при проверке через Яндекс %check_until% - Глубина проверки при использовании Яндекса %parse_direct% - Парсится ли реклама Яндекс Директ ("true" или "false") [ :yandex_element_switch ] [ google_element_switch: ] Доступны все переменные и блоки из searchengine_element_switch и дополнительно: %region% - Номер региона (или пусто, если регион не задан) %region_text% - Регион текстом (или "Не задан", если не задан) %google_domain% - Домен Google, использующийся для проверки позиций %page_results% - Число результатов на странице %check_until% - Глубина проверки %parse_ads% - Парсится ли Google Реклама ("true" или "false") [ :google_element_switch ] [ mail_element_switch: ] Доступны все переменные и блоки из searchengine_element_switch и дополнительно: %check_until% - Глубина проверки [ :mail_element_switch ] [ :elements_repeat ] [ :settings_block ] Подблок - таблица: [ table_block: ] %table_headers% - Число столбцов в таблице %table_size% - Число строк в таблице %table_output_size% - Число строк таблицы, выведенное в отчет Заголовки столбцов таблицы: [ table_headers_repeat: ] %header_name% - Название столбца %header_part_id% - Число, идентифицирующее ту часть данных, которую отображает столбец Здесь доступны следующие переключатели (выводятся подходящие из них, остальные удаляются): [ table_header_keyword_switch: ][ :table_header_keyword_switch ] [ table_header_engine_switch: ][ :table_header_engine_switch ] [ table_header_wordstat_switch: ][ :table_header_wordstat_switch ] [ table_header_searchengine_switch: ][ :table_header_searchengine_switch ] [ table_header_yandex_switch: ][ :table_header_yandex_switch ] [ table_header_google_switch: ][ :table_header_google_switch ] [ table_header_mail_switch: ][ :table_header_mail_switch ] [ :table_headers_repeat ] Сама таблица (строки и ячейки): [ table_rows_repeat: ] [ table_row_cells_repeat: ] Переключатель типа данных ячейки (выводятся подходящие из них, остальные удаляются): [ table_cell_keyword_switch: ] %keyword% - Ключевое слово %rgbcolor% - Цвет ключевого слова Переключатель в зависимости от part_id: [ table_header_part_id_0_switch: ] Вывод всех данных [ :table_header_part_id_0_switch ] [ table_header_part_id_1_switch: ] Вывод только ключевого слова [ :table_header_part_id_1_switch ] [ :table_cell_keyword_switch ] [ table_cell_engine_switch: ] %checking_state% - Статус проверки %checking_state_text% - Статус проверки (текстом) %error% - Код ошибки (0 - без ошибок) %error_text% - Сообщение об ошибке (текстом или пусто, если без ошибок) %time% - Дата/время полученя данных проверки Переключатель в зависимости от part_id: [ table_header_part_id_0_switch: ] Вывод всех данных [ :table_header_part_id_0_switch ] [ table_header_part_id_1_switch: ] Вывод только статуса проверки [ :table_header_part_id_1_switch ] [ table_header_part_id_2_switch: ] Вывод только кода ошибки [ :table_header_part_id_2_switch ] [ table_header_part_id_3_switch: ] Вывод только даты/времени проверки [ :table_header_part_id_3_switch ] [ :table_cell_engine_switch ] [ table_cell_wordstat_switch: ] Доступны все переменные из table_cell_engine_switch и дополнительно: %frequency% - Частотность %frequency_cmp% - Частотность для сравнения %frequency_dynamics% - Изменение частотности (число, начинающееся с +/- или пусто, если изменений нет) Переключатели в зависимости от part_id, как и в table_cell_engine_switch и дополнительно: [ table_header_part_id_32_switch: ] Вывод только частотности [ :table_header_part_id_32_switch ] [ :table_cell_wordstat_switch ] [ table_cell_searchengine_switch: ] Доступны все переменные из table_cell_engine_switch и дополнительно: %snippet_title% - Заголовок сниппета %snippet_title_cmp% - Заголовок сниппета для сравнения %snippet_description% - Описание сниппета %snippet_description_cmp% - Описание сниппета для сравнения %relevant_page% - Релевантная страница %relevant_page_cmp% - Релевантная страница для сравнения %relevant_page_target% - Страница является целевой ("true" или "false") %position% - Позиция (0, если не проверялось; -1, если не найдено) %position_cmp% - Позиция для сравнения (0, если не проверялось; -1, если не найдено) %position_dynamics% - Изменение позиции (число, начинающееся с +/- или +∞/-∞, или пусто, если изменений нет) %infected% - Информация о пометке "инфицирован" ("true" или "false") %infected_cmp% - Информация о пометке "инфицирован" для сравнения ("true" или "false") %cluster% - Номер кластера или 0, если не присвоен Переключатели в зависимости от part_id, как и в table_cell_engine_switch и дополнительно: [ table_header_part_id_32_switch: ] Вывод только заголовка сниппета [ :table_header_part_id_32_switch ] [ table_header_part_id_33_switch: ] Вывод только описания сниппета [ :table_header_part_id_33_switch ] [ table_header_part_id_34_switch: ] Вывод только релевантной страницы [ :table_header_part_id_34_switch ] [ table_header_part_id_35_switch: ] Вывод только позиции [ :table_header_part_id_35_switch ] [ table_header_part_id_36_switch: ] Вывод только флага "инфицирован" [ :table_header_part_id_36_switch ] [ table_header_part_id_37_switch: ] Вывод только номера кластера [ :table_header_part_id_37_switch ] [ :table_cell_searchengine_switch ] [ table_cell_yandex_switch: ] Доступны все переменные из table_cell_searchengine_switch и дополнительно: %from_xml% - Информация об источнике данных Яндекс XML ("true" или "false") %from_xml_cmp% - Информация об источнике данных Яндекс XML для сравнения ("true" или "false") %yandex_direct_position% - Позиция сайта в Директе (или "—", если не найдено, или пусто, если данные не получены) %yandex_direct_pos% - Короткий вариант позиции в Директе (или пусто, если не найдено) %yandex_direct_position_cmp% - Позиция сайта в Директе для сравнения (или "—", если не найдено, или пусто, если данные не получены) %yandex_direct_pos_cmp% - Короткий вариант позиции в Директе для сравнения (или пусто, если не найдено) Переключатели в зависимости от part_id, как и в table_cell_searchengine_switch и дополнительно: [ table_header_part_id_64_switch: ] Вывод только источника данных [ :table_header_part_id_64_switch ] [ table_header_part_id_65_switch: ] Вывод только позиции в Яндекс Директ [ :table_header_part_id_65_switch ] [ :table_cell_yandex_switch ] [ table_cell_google_switch: ] Доступны все переменные из table_cell_searchengine_switch и дополнительно: %google_ads_position% - Позиция сайта в Google Рекламе (или "—", если не найдено, или пусто, если данные не получены) %google_ads_pos% - Короткий вариант позиции в Google Рекламе (или пусто, если не найдено) %google_ads_position_cmp% - Позиция сайта в Google Рекламе для сравнения (или "—", если не найдено, или пусто, если данные не получены) %google_ads_pos_cmp% - Короткий вариант позиции в Google Рекламе для сравнения (или пусто, если не найдено) Переключатели в зависимости от part_id, как и в table_cell_searchengine_switch и дополнительно: [ table_header_part_id_64_switch: ] Вывод только позиции в Google Рекламе [ :table_header_part_id_64_switch ] [ :table_cell_google_switch ] [ table_cell_mail_switch: ] Доступны все переменные из table_cell_searchengine_switch Переключатели в зависимости от part_id, как и в table_cell_searchengine_switch [ :table_cell_mail_switch ] [ :table_row_cells_repeat ] [ :table_rows_repeat ] [ :table_block ] Подблок - таблица "Конкуренты": [ competitors_block: ] %competitors_headers% - Число столбцов в таблице %competitors_output_size% - Число доменов конкурентов, выведенное в отчет Заголовки столбцов таблицы: [ competitors_headers_repeat: ] %header_name% - Название столбца [ :competitors_headers_repeat ] Сама таблица (строки и ячейки): [ competitors_rows_repeat: ] [ competitors_row_cells_repeat: ] %domain% - Домен сайта конкурента %my_domain% - "Свой" домен ("true" или "false") %pos_dynamics% - Динамика позиции домена конкурента в списке (число, начинающееся с +/- или пусто, если изменений нет) %domain_percent% - Процент видимости для всего домена (суммарно всех урлов) В каждой ячейке таблицы может быть несколько URL для текущего домена конкурента: [ competitor_domain_urls_repeat: ] %url% - URL страницы сайта конкурента %url_percent% - Процент видимости для этого URL [ :competitor_domain_urls_repeat ] [ :competitors_row_cells_repeat ] [ :competitors_rows_repeat ] [ :competitors_block ] [ :datetime_repeat ]