Приложение "Выгрузка ЦИАН": различия между версиями

Материал из CMS Sitebill Wiki
Перейти к навигации Перейти к поиску
(Отмена правки 782, сделанной участником Abushyk (обс.))
 
(не показано 20 промежуточных версий 2 участников)
Строка 22: Строка 22:
 
=== Логгирование ===
 
=== Логгирование ===
  
Приложение ведет запись логов эскпорта в файл /apps/cianexporter/logs/export_logs.txt<br />
+
Приложение ведет запись логов эскпорта в файлы<br/>
 +
/cache/cianexporter_flatssell.last.log.xml - по продаже квартир<br/>
 +
/cache/cianexporter_flatsrent.last.log.xml - по аренде квартир<br/>
 +
/cache/cianexporter_lots.last.log.xml - по земельным участкам<br/>
 +
/cache/cianexporter_nonresidential.last.log.xml - по зарубежной<br/>
  
Логи добавляются в конец файла, поэтому воизбежании разбухания файла, его следует периодически очищать.
 
  
 
Настройка экспорт
 
Настройка экспорт
  
 
Перед экспортом каждому разделу структуры каталога необходимо проассоциировать верный тип недвижимости. Делается это через административную часть приложение в разделе "Установка ассоциаций"
 
Перед экспортом каждому разделу структуры каталога необходимо проассоциировать верный тип недвижимости. Делается это через административную часть приложение в разделе "Установка ассоциаций"
 +
 +
=== Отправка данных в CIAN.ru ===
 +
 +
Перед отправкой данных вам нужно проверить источник ваших данных с помощью специального валидатора http://www.cian.ru/nd/validator/<br/>
 +
 +
Нужно проверить каждый тип выгрузки<br/>
 +
 +
Аренда квартир и комнат http://ваш_сайт/cianexport/rent/<br/>
 +
Продажа квартир и комнат http://ваш_сайт/cianexport/sell/<br/>
 +
Аренда и продажа нежилых помещений http://ваш_сайт/cianexport/commerce/<br/>
 +
Аренда и продажа домов и земельных участков http://ваш_сайт/cianexport/lots/<br/>
 +
 +
Если будут ошибки при валидации, то вам нужно поправить соответствующие данные в объявлениях и заново проверить источник.<br/>
 +
После этого вы можете написать в службу тех.поддержки '''import@cian.ru''', указать свой ID в личном кабинете cian.ru и адреса источников данных. <br><br><br>
 +
 +
Пример письма:
 +
Прошу добавить выгрузку объявлений в формате XML<br>
 +
ID аккаунта 1111111 <br>
 +
Аренда квартир и комнат http://ваш_сайт/cianexport/rent/<br/>
 +
Продажа квартир и комнат http://ваш_сайт/cianexport/sell/<br/>
 +
Аренда и продажа нежилых помещений http://ваш_сайт/cianexport/commerce/<br/>
 +
Аренда и продажа домов и земельных участков http://ваш_сайт/cianexport/lots/<br/>
 +
Отчеты отправлять сюда, пожалуйста<br>
 +
my@site.ru и manager@site.ru<br>
 +
 +
=== ВАЖНОЕ ЗАМЕЧАНИЕ!  ===
 +
У вас должен быть активировать тариф "Профессионал" в cian.ru, для того чтобы вашу выгрузку начали принимать.
 +
 +
=== Настройки ===
 +
 +
'''apps.cianexporter.text''' ''(Заменитель текста объявления)'' - укажите текст, который будет выводиться в выгрузке в поле описания<br />
 +
 +
'''apps.cianexporter.paid_ads''' ''(Платная выгрузка объявлений)'' - использовать приложение Биллинг для снятия сумм за выгрузку объявления со счета пользователя<br />
 +
 +
'''apps.cianexporter.sell''' ''(Поле:Значение отвечающие за признак продажи)'' - укажите системное имя поля и значение соответствующие продаже. Напр. optype:2<br />
 +
 +
'''apps.cianexporter.rent''' ''(Поле:Значение отвечающие за признак аренды)'' - укажите системное имя поля и значение соответствующие аренде. Напр. optype:1<br />
 +
 +
'''apps.cianexporter.region_id''' ''(ID административного региона, если известен)'' - укажите cian-идентификатор региона, если регион выгружаемых объявлений единый<br />
 +
 +
'''apps.cianexporter.default_currency''' ''(Код валюты цен (EUR/USD/RUB) для моновалютных сайтов)'' - укажите кода валюты цен объявлений на сайте<br />
 +
 +
'''apps.cianexporter.default_saletype''' ''(Тип продажи по умолчанию (F – свободная продажа, A – альтернатива))'' - укажите тип продажи для всех объявлений по продаже<br />
 +
 +
'''apps.cianexporter.max_days''' ''(Возраст в днях выгружаемых объявлений (0 - игнорировать))'' - укажите возраст объявлений, которые будут допущены к выгрузке, в днях.<br />
 +
 +
'''apps.cianexporter.use_days_limitation''' ''(Использовать ограничение доступности выгрузки по дням)'' - включает режим блокировки отдачи выгрузки по определенным дням недели<br />
 +
 +
'''apps.cianexporter.lots_days''' ''(Дни доступности выгрузки участков)'' - укажите дни недели доступности выгрузки объявлений "Аренда и продажа
 +
домов и земельных участков" в виде списка чисел от 1 до 7 через запятую (1-понедельник, 7-воскресенье)<br />
 +
 +
'''apps.cianexporter.commerce_days''' ''(Дни доступности выгрузки коммерческой)'' - укажите дни недели доступности выгрузки объявлений "Аренда и продажа
 +
нежилых помещений" в виде списка чисел от 1 до 7 через запятую (1-понедельник, 7-воскресенье)<br />
 +
 +
'''apps.cianexporter.sale_days''' ''(Дни доступности выгрузки продажи квартир)'' - укажите дни недели доступности выгрузки объявлений "Продажа
 +
квартир и комнат" в виде списка чисел от 1 до 7 через запятую (1-понедельник, 7-воскресенье)<br />
 +
 +
'''apps.cianexporter.rent_days''' ''(Дни доступности выгрузки аренды квартир) - укажите дни недели доступности выгрузки объявлений "Аренда
 +
квартир и комнат" в виде списка чисел от 1 до 7 через запятую (1-понедельник, 7-воскресенье)<br />
 +
 +
'''apps.cianexporter.use_billing_vipstatus_for_premium''' ''(Использовать VIP статус при включенном биллинге для выгрузки премиум-позиций)'' - включенная настройка предписывает устанавливать для объявления статус premium если используется биллинг и значение VIP-статуса на сайте является активным (эта настройка переопределяется настройкой apps.cianexporter.prom_by_billing)<br />
 +
 +
'''apps.cianexporter.total_square_flat''' ''(Системное имя общей площади для квартир и комнат)'' - укажите системное имя поля содержащего значение общей площади для квартир и комнат<br />
 +
 +
'''apps.cianexporter.total_square_commercial''' ''(Системное имя общей площади для нежилой\коммерческой)'' - укажите системное имя поля содержащего значение общей площади для квартир и комнат<br />
 +
 +
'''apps.cianexporter.total_square_houses''' ''(Системное имя общей площади для домов)'' - укажите системное имя поля содержащего значение общей площади для домов<br />
 +
 +
'''apps.cianexporter.total_square_lots''' ''(Системное имя общей площади для участков)'' - укажите системное имя поля содержащего значение общей площади для участков<br />
 +
 +
'''apps.cianexporter.total_square_lots_m''' ''(Единица измерения общей площади для участков (1-м2, 2-сот))'' - укажите единицу измерения значения общей площади для участков<br />
 +
 +
'''apps.cianexporter.total_square_lh_lots''' ''(Системное имя общей площади участков для участков с домами)'' - укажите системное имя поля содержащего значение общей площади для участков при экспорте участков с домами<br />
 +
 +
'''apps.cianexporter.total_square_lh_lots_m''' ''(Единица измерения общей площади участков для участков с домами (1-м2, 2-сот))'' - укажите единицу измерения значения общей площади для участков при экспорте участков с домами<br />
 +
 +
'''apps.cianexporter.total_square_lh_house''' ''(Системное имя общей площади дома для участков с домами)'' - укажите системное имя поля содержащего значение общей площади для дома при экспорте участков с домами<br />
 +
 +
'''apps.cianexporter.newbuilds_ch''' ''(Системное имя поля-чекбокса для обозначения новостройки)'' - укажите системное имя поля типа checkbox содержащее признак расположения в новостройке<br />
 +
 +
'''apps.cianexporter.unlim''' ''(Выгружать в ЦИАН все объявления)'' - указывает отправлять на выгрузку все активные объявления без фильтрации по признаку "выгружать в ЦИАН"<br />
 +
 +
'''apps.cianexporter.ceiling_f''' ''(Системное имя поля со значением высоты потолков)'' - укажите системное имя поля содержащего значение высоты потолков<br />
 +
 +
'''apps.cianexporter.year_f''' ''(Системное имя поля со значением года постройки здания)'' - укажите системное имя поля содержащего значение года постройки здания<br />
 +
 +
'''apps.cianexporter.prom_by_billing''' ''(Устанавливать статусы продвижения в зависимости от статусов биллинга)'' - настройка предписывает определять статусы продвижения объявления на основании статусов биллинга на сайте. По-умолчанию для определения premium в ЦИАН используется значение статуса Премиум, для top - VIP, для highlight - Выделено. Эта настройка отменяет действие настройки apps.cianexporter.use_billing_vipstatus_for_premium. Соответствия значений биллинг-статусов на сайте значениям статусов продвижения в ЦИАН можно изменить, указав системные имена в настройках apps.cianexporter.prom_highlight_mark, apps.cianexporter.prom_premium_mark, apps.cianexporter.prom_top_mark соответствующих значений<br />
 +
 +
'''apps.cianexporter.prom_highlight_mark''' ''(Системное имя поля установки выделения цветом)'' - настройка служит для указания значения биллинг-статуса, при включенной настройке apps.cianexporter.prom_by_billing, соответствующего highlight-статусу продвижения ЦИАН. При выключенной настройке apps.cianexporter.prom_by_billing в этом поле можно указать системное имя поля типа checkbox отмеченное значение которого будет означать наличие highlight-статуса ЦИАН<br />
 +
 +
'''apps.cianexporter.prom_premium_mark''' ''(Системное имя поля установки премиум-объявлений)'' - настройка служит для указания значения биллинг-статуса, при включенной настройке apps.cianexporter.prom_by_billing, соответствующего premium-статусу продвижения ЦИАН. При выключенной настройке apps.cianexporter.prom_by_billing в этом поле можно указать системное имя поля типа checkbox отмеченное значение которого будет означать наличие premium-статуса ЦИАН<br />
 +
 +
'''apps.cianexporter.prom_top_mark''' ''(Системное имя поля установки Топ 3 объявлений)'' - настройка служит для указания значения биллинг-статуса, при включенной настройке apps.cianexporter.prom_by_billing, соответствующего top-статусу продвижения ЦИАН. При выключенной настройке apps.cianexporter.prom_by_billing в этом поле можно указать системное имя поля типа checkbox отмеченное значение которого будет означать наличие top-статуса ЦИАН<br />
 +
 +
'''apps.cianexporter.inc_districts_to_locality''' ''(Добавлять район к locality)'' - включение этой настройки позволяет добавить в тег locality содержимое поля district_id в виде имени района области. Данное включение не срабатывает при нахождении объекта в регионах Москва и Санкт-Петербург<br />
 +
 +
=== Логи ===
 +
С версии 1.5.0 приложение хранит свои логи в папке cache/ в виде xml-файлов. Файлы логов являются ненакапливаемыми - после каждой выгрузки предыдущий лог заменяется новым.<br />
 +
 +
Логи выгрузки "Аренда квартир и комнат" хранятся в файле cianexporter_flatsrent.last.log.xml<br />
 +
 +
Логи выгрузки "Продажа квартир и комнат" хранятся в файле cianexporter_flatssell.last.log.xml<br />
 +
 +
Логи выгрузки "Аренда и продажа нежилых помещений" хранятся в файле cianexporter_nonresidential.last.log.xml<br />
 +
 +
Логи выгрузки "Аренда и продажа домов и земельных участков" хранятся в файле cianexporter_lots.last.log.xml

Текущая версия на 12:11, 28 августа 2019

Приложение для реализации экспорта объявлений на сайт http://www.cian.ru/

Экспорту подлежат все активные объявления соответствующего раздела для которых установлен параметр "Экспорт в ЦИАН".

Требования

Приложение требует дополнения модели дополнительными полями (тут будет скл файл с запросами на вставку дополей).

Отсев объявлений

Однозначно будут отклонены для экспорта следующие объявления

  • с неуказанной ценой или ценой равной нулю
  • с названием валюты цены или ее кодом (в зависимости от настроек модели), которую невозможно идентифицировать или, которое удалось идентифицировать, но оно не является допустимым
  • с именем региона размещения, которое не указано, либо указано, но не может быть однозначно сопоставлено одному из названий из xml файла http://www.cian.ru/admin_areas.php
  • если удалось определить название региона и оно является "Москва" или "СПБ", но не удалось идентифицировать название станции метро согласно соответствующего файла xml (http://www.cian.ru/metros.php или http://www.cian.ru/metros.php?region=10), либо станция метро не указана вообще.
  • если не удалось определить из данных ни одного привязанного к объявлению контактного телефона
  • для объявления, которые отмечены как продажа, и у которых не удалось определить параметр "Тип продажи"

Для остальных параметров, в случае неопределенности их значений, будут выставлены некоторые "нулевые" или "дефолтные" значения.

Логгирование

Приложение ведет запись логов эскпорта в файлы
/cache/cianexporter_flatssell.last.log.xml - по продаже квартир
/cache/cianexporter_flatsrent.last.log.xml - по аренде квартир
/cache/cianexporter_lots.last.log.xml - по земельным участкам
/cache/cianexporter_nonresidential.last.log.xml - по зарубежной


Настройка экспорт

Перед экспортом каждому разделу структуры каталога необходимо проассоциировать верный тип недвижимости. Делается это через административную часть приложение в разделе "Установка ассоциаций"

Отправка данных в CIAN.ru

Перед отправкой данных вам нужно проверить источник ваших данных с помощью специального валидатора http://www.cian.ru/nd/validator/

Нужно проверить каждый тип выгрузки

Аренда квартир и комнат http://ваш_сайт/cianexport/rent/
Продажа квартир и комнат http://ваш_сайт/cianexport/sell/
Аренда и продажа нежилых помещений http://ваш_сайт/cianexport/commerce/
Аренда и продажа домов и земельных участков http://ваш_сайт/cianexport/lots/

Если будут ошибки при валидации, то вам нужно поправить соответствующие данные в объявлениях и заново проверить источник.
После этого вы можете написать в службу тех.поддержки import@cian.ru, указать свой ID в личном кабинете cian.ru и адреса источников данных.


Пример письма: Прошу добавить выгрузку объявлений в формате XML
ID аккаунта 1111111
Аренда квартир и комнат http://ваш_сайт/cianexport/rent/
Продажа квартир и комнат http://ваш_сайт/cianexport/sell/
Аренда и продажа нежилых помещений http://ваш_сайт/cianexport/commerce/
Аренда и продажа домов и земельных участков http://ваш_сайт/cianexport/lots/
Отчеты отправлять сюда, пожалуйста
my@site.ru и manager@site.ru

=== ВАЖНОЕ ЗАМЕЧАНИЕ!  ===

У вас должен быть активировать тариф "Профессионал" в cian.ru, для того чтобы вашу выгрузку начали принимать.

Настройки

apps.cianexporter.text (Заменитель текста объявления) - укажите текст, который будет выводиться в выгрузке в поле описания

apps.cianexporter.paid_ads (Платная выгрузка объявлений) - использовать приложение Биллинг для снятия сумм за выгрузку объявления со счета пользователя

apps.cianexporter.sell (Поле:Значение отвечающие за признак продажи) - укажите системное имя поля и значение соответствующие продаже. Напр. optype:2

apps.cianexporter.rent (Поле:Значение отвечающие за признак аренды) - укажите системное имя поля и значение соответствующие аренде. Напр. optype:1

apps.cianexporter.region_id (ID административного региона, если известен) - укажите cian-идентификатор региона, если регион выгружаемых объявлений единый

apps.cianexporter.default_currency (Код валюты цен (EUR/USD/RUB) для моновалютных сайтов) - укажите кода валюты цен объявлений на сайте

apps.cianexporter.default_saletype (Тип продажи по умолчанию (F – свободная продажа, A – альтернатива)) - укажите тип продажи для всех объявлений по продаже

apps.cianexporter.max_days (Возраст в днях выгружаемых объявлений (0 - игнорировать)) - укажите возраст объявлений, которые будут допущены к выгрузке, в днях.

apps.cianexporter.use_days_limitation (Использовать ограничение доступности выгрузки по дням) - включает режим блокировки отдачи выгрузки по определенным дням недели

apps.cianexporter.lots_days (Дни доступности выгрузки участков) - укажите дни недели доступности выгрузки объявлений "Аренда и продажа домов и земельных участков" в виде списка чисел от 1 до 7 через запятую (1-понедельник, 7-воскресенье)

apps.cianexporter.commerce_days (Дни доступности выгрузки коммерческой) - укажите дни недели доступности выгрузки объявлений "Аренда и продажа нежилых помещений" в виде списка чисел от 1 до 7 через запятую (1-понедельник, 7-воскресенье)

apps.cianexporter.sale_days (Дни доступности выгрузки продажи квартир) - укажите дни недели доступности выгрузки объявлений "Продажа квартир и комнат" в виде списка чисел от 1 до 7 через запятую (1-понедельник, 7-воскресенье)

apps.cianexporter.rent_days (Дни доступности выгрузки аренды квартир) - укажите дни недели доступности выгрузки объявлений "Аренда квартир и комнат" в виде списка чисел от 1 до 7 через запятую (1-понедельник, 7-воскресенье)

apps.cianexporter.use_billing_vipstatus_for_premium (Использовать VIP статус при включенном биллинге для выгрузки премиум-позиций) - включенная настройка предписывает устанавливать для объявления статус premium если используется биллинг и значение VIP-статуса на сайте является активным (эта настройка переопределяется настройкой apps.cianexporter.prom_by_billing)

apps.cianexporter.total_square_flat (Системное имя общей площади для квартир и комнат) - укажите системное имя поля содержащего значение общей площади для квартир и комнат

apps.cianexporter.total_square_commercial (Системное имя общей площади для нежилой\коммерческой) - укажите системное имя поля содержащего значение общей площади для квартир и комнат

apps.cianexporter.total_square_houses (Системное имя общей площади для домов) - укажите системное имя поля содержащего значение общей площади для домов

apps.cianexporter.total_square_lots (Системное имя общей площади для участков) - укажите системное имя поля содержащего значение общей площади для участков

apps.cianexporter.total_square_lots_m (Единица измерения общей площади для участков (1-м2, 2-сот)) - укажите единицу измерения значения общей площади для участков

apps.cianexporter.total_square_lh_lots (Системное имя общей площади участков для участков с домами) - укажите системное имя поля содержащего значение общей площади для участков при экспорте участков с домами

apps.cianexporter.total_square_lh_lots_m (Единица измерения общей площади участков для участков с домами (1-м2, 2-сот)) - укажите единицу измерения значения общей площади для участков при экспорте участков с домами

apps.cianexporter.total_square_lh_house (Системное имя общей площади дома для участков с домами) - укажите системное имя поля содержащего значение общей площади для дома при экспорте участков с домами

apps.cianexporter.newbuilds_ch (Системное имя поля-чекбокса для обозначения новостройки) - укажите системное имя поля типа checkbox содержащее признак расположения в новостройке

apps.cianexporter.unlim (Выгружать в ЦИАН все объявления) - указывает отправлять на выгрузку все активные объявления без фильтрации по признаку "выгружать в ЦИАН"

apps.cianexporter.ceiling_f (Системное имя поля со значением высоты потолков) - укажите системное имя поля содержащего значение высоты потолков

apps.cianexporter.year_f (Системное имя поля со значением года постройки здания) - укажите системное имя поля содержащего значение года постройки здания

apps.cianexporter.prom_by_billing (Устанавливать статусы продвижения в зависимости от статусов биллинга) - настройка предписывает определять статусы продвижения объявления на основании статусов биллинга на сайте. По-умолчанию для определения premium в ЦИАН используется значение статуса Премиум, для top - VIP, для highlight - Выделено. Эта настройка отменяет действие настройки apps.cianexporter.use_billing_vipstatus_for_premium. Соответствия значений биллинг-статусов на сайте значениям статусов продвижения в ЦИАН можно изменить, указав системные имена в настройках apps.cianexporter.prom_highlight_mark, apps.cianexporter.prom_premium_mark, apps.cianexporter.prom_top_mark соответствующих значений

apps.cianexporter.prom_highlight_mark (Системное имя поля установки выделения цветом) - настройка служит для указания значения биллинг-статуса, при включенной настройке apps.cianexporter.prom_by_billing, соответствующего highlight-статусу продвижения ЦИАН. При выключенной настройке apps.cianexporter.prom_by_billing в этом поле можно указать системное имя поля типа checkbox отмеченное значение которого будет означать наличие highlight-статуса ЦИАН

apps.cianexporter.prom_premium_mark (Системное имя поля установки премиум-объявлений) - настройка служит для указания значения биллинг-статуса, при включенной настройке apps.cianexporter.prom_by_billing, соответствующего premium-статусу продвижения ЦИАН. При выключенной настройке apps.cianexporter.prom_by_billing в этом поле можно указать системное имя поля типа checkbox отмеченное значение которого будет означать наличие premium-статуса ЦИАН

apps.cianexporter.prom_top_mark (Системное имя поля установки Топ 3 объявлений) - настройка служит для указания значения биллинг-статуса, при включенной настройке apps.cianexporter.prom_by_billing, соответствующего top-статусу продвижения ЦИАН. При выключенной настройке apps.cianexporter.prom_by_billing в этом поле можно указать системное имя поля типа checkbox отмеченное значение которого будет означать наличие top-статуса ЦИАН

apps.cianexporter.inc_districts_to_locality (Добавлять район к locality) - включение этой настройки позволяет добавить в тег locality содержимое поля district_id в виде имени района области. Данное включение не срабатывает при нахождении объекта в регионах Москва и Санкт-Петербург

Логи

С версии 1.5.0 приложение хранит свои логи в папке cache/ в виде xml-файлов. Файлы логов являются ненакапливаемыми - после каждой выгрузки предыдущий лог заменяется новым.

Логи выгрузки "Аренда квартир и комнат" хранятся в файле cianexporter_flatsrent.last.log.xml

Логи выгрузки "Продажа квартир и комнат" хранятся в файле cianexporter_flatssell.last.log.xml

Логи выгрузки "Аренда и продажа нежилых помещений" хранятся в файле cianexporter_nonresidential.last.log.xml

Логи выгрузки "Аренда и продажа домов и земельных участков" хранятся в файле cianexporter_lots.last.log.xml