Фид формата Домклик

В Домопланере можно сделать xml-фид для выгрузки объявлений в Домклик.

Более подробно формат данного фида описан на портале и доступен по ссылке: https://domclick.ru/validation/requirements

Для создания перейдите в раздел ПРОЕКТЫ — Фиды — Список фидов — нажмите кнопку "Создать фид" и и выберите формат фида "Домклик Новостройки":

Инструкция по дальнейшему заполнению фида доступна здесь.

Домклик - Вторичка

В Домопланере можно сделать xml-фид Домклик для вторички.

Формат данного фида более подробно описан на портале и доступен по ссылке: https://blog.domclick.ru/home/post/tehnicheskie-trebovaniya-k-xml-fidam

Для создания перейдите в раздел ПРОЕКТЫ — Фиды — Список фидов — нажмите кнопку "Создать фид" и укажите в качестве формата "Домклик Вторичка":

С полным описанием заполнения фида можно ознакомиться здесь.

НАПОМИНАЕМ! вы можете добавить индивидуальное описание для каждой квартиры. Как это сделать — загляните в инструкцию вот здесь.

Переопределение для ID проекта

Бывает так, что в Домопланере дома нескольких разных жилых комплексов по каким-то причинам оказались объединены в один проект. При этом на стороне Домклика у этих ЖК — разные идентификаторы проектов.

Так как фид может быть только один для проекта и второй фид для этих же домов не получится создать с другим ID проекта, то площадка будет видеть все эти дома как один проект. Это приводит к путанице: данные по одному ЖК  могут ошибочно подтягиваться к домам другого и информация не будет соответствовать реальности.

Чтобы корректно разделить такие дома и отправлять по ним данные с правильным ID проекта, используется переопределение для ID проекта.

ЧТО НУЖНО СДЕЛАТЬ:

1. Найдите на стороне площадки тот ID проекта, который присвоен реальному ЖК, куда должны входить дома, оказавшиеся "не в своем" проекте. Скопируйте этот ID.

2. В Домопланере создайте отдельный фид специально для этих домов. При создании фида в блоке "Объекты в фиде" укажите только те дома, которые относятся к этому реальному проекту.

3. В настройках созданного фида укажите переопределение ID проекта — вставьте скопированный идентификатор.

После такой настройки:
— Домопланер будет понимать, что этот фид создан для другого реального проекта.
— В фид не будут подтягиваться данные из основного проекта (описание, адрес, инфраструктура), которые могут не соответствовать действительности.
— Площадка получит корректный идентификатор и будет показывать дома именно в том проекте, к которому они относятся.

ВАЖНО! Ситуация редкая, но если она возникла — решается просто. Переопределение работает для каждого фида отдельно, можно гибко распределять дома по разным реальным проектам.

Дополнительные поля в фиде Домклика

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

Давайте разберем, где настраиваются такие поля, какую информацию можно передавать и как это сделать дополнительно к базовым настройкам, описанным в большом руководстве "Всё о фидах".

Дополнительные поля для домов

В фиде Домклика предусмотрено специальное поле ceiling_height внутри каждого дома, которое передает высоту потолков в квартирах. Это важный параметр, который влияет на привлекательность предложения и может использоваться в фильтрах поиска на площадке.

Чтобы передавать корректные значения в это поле, в Домопланере реализована гибкая настройка через дополнительные поля в Настройках дома.

КАК НАСТРОИТЬ:

1. Перейдите в раздел НАСТРОЙКИ — Проекты и дома — Настройки дома — Дополнительные поля — нажмите кнопку "Открыть редактор полей":

2. Создайте новое дополнительное поле с параметрами:
— Название: DC_ceiling_height (строго по этому шаблону)
— Тип: Текстовое.

3. В появившемся поле DC_ceiling_height укажите нужное значение высоты потолков. Формат заполнения: указывайте значение через запятую (как десятичный разделитель) и без кавычек, например: 2,7 или 2,75. 

4. Сохраните изменения.

КАК ЭТО РАБОТАЕТ: После заполнения поля, при формировании фида для Домклика система автоматически подставит указанное значение в поле ceiling_height для соответствующего дома. Если значение не заполнено, поле в фиде передаваться не будет.

ВАЖНО! значение высоты потолков заполняется индивидуально для каждого дома. Если в разных домах вашего ЖК разная высота потолков, вы можете указать соответствующие значения в настройках каждого дома.

Дополнительные поля для проектов

Есть данные, которые одинаковы для всех помещений и домов внутри одного жилого комплекса. Например, описание проекта, отделка, инфраструктура и другие.

И здесь фиды Домклика предлагают очень удобное решение: вы описываете такие параметры один раз на уровне проекта, а дальше они автоматически передаются для всех домов, которые в этот проект входят.

Давайте разберем, какие данные согласно требованиям Домклика вы можете добавить, чтобы ваш объект выглядел максимально привлекательно на площадке.

Инфраструктура

В фиде Домклика для каждого проекта предусмотрен блок с информацией об инфраструктуре. Давайте посмотрим, какие параметры можно передавать и какие значения для них допустимы согласно требованиям площадки:

Изначальное состояние этого поля, которые мы передаем по умолчанию:
security = 1
kindergarten = 1
school = 1
playground = 1
sports_ground = 1
fenced_area = 1
Цифра 1 в данном контексте означает "есть в наличии" или "доступно". То есть Домопланер по умолчанию сообщает Домклику, что в проекте:
— есть охрана (security),
— есть детский сад (kindergarten)
— есть школа (school)
— есть детская площадка (playground)
— есть спортивная площадка (sports_ground)
— есть огороженная территория (fenced_area)

Если вам нужно передать другие значения, вы можете воспользоваться переопределением с помощью создания дополнительных полей к проектам:

КАК НАСТРОИТЬ:

1. Перейдите в раздел НАСТРОЙКИ — Проекты и дома — Настройки проекта — Дополнительные поля — нажмите кнопку "Открыть редактор полей":

2. Создайте новое дополнительное поле с параметрами:— Название: DC_infrastructure.parking (строго по этому шаблону)— Тип: Текстовое:

3. В появившемся поле DC_infrastructure.parking укажите значение: 0 (для передачи отрицательного значения).

4. Сохраните изменения.

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

КАК ЭТО РАБОТАЕТ: После заполнения дополнительных полей, при формировании фида для Домклика система автоматически подставит указанные значения в соответствующие параметры инфраструктуры проекта. Если поле не создано или значение не заполнено, будет передаваться по умолчанию  значение 1 (объект есть в наличии). Если же вы указали 0 через доп. поле, система передаст отсутствие объекта.

Особенности ЖК

Домклик позволяет передавать до 10 главных особенностей (УТП) вашего проекта. Это специальные карточки, которые наглядно демонстрируют ключевые преимущества жилого комплекса. Каждая карточка состоит из трёх элементов:
— изображение (фото)
—заголовок (короткая фраза)
— текст (пояснение или детали)

КАК НАСТРОИТЬ:

1. Перейдите в раздел НАСТРОЙКИ — Проекты и дома — Настройки проекта — Дополнительные поля — нажмите кнопку "Открыть редактор полей":

2. Нажмите на кнопку "Добавить поле" и для каждой фишки создайте три связанных дополнительных поля для проектов:
— Изображение. Название: DC_profit.1.image Тип поля: Изображение.
— Заголовок. Название: DC_profit.1.title Тип поля: Текст.
— Текст. Название: DC_profit.1.text Тип поля: Текст.

3. Заполните для каждого поля соответствующие значения. Нажмите кнопку "Сохранить".

Цифра в названии поля указывает номер карточки (от 1 до 10). Для второй фишки поля будут называться `DC_profit.2.image`, `DC_profit.2.title`, `DC_profit.2.text` и так далее.

КАК ЭТО РАБОТАЕТ: При формировании фида Домопланер последовательно перебирает номера от 1 до 10 и проверяет, заполнены ли все три поля для данного номера.
Если все три поля заполнены — карточка добавляется в фид. Если хотя бы одно из полей пустует — этот номер пропускается.

Например, если вы заполнили только первую тройку полей (цифра 1), а во второй тройке написали только заголовок и текст(описание), то в фид уйдет одна карточка УТП — первая.

ВАЖНО!
— Максимум — 10 карточек на проект.
— Каждая карточка требует заполнения всех трёх полей.
— Изображения должны быть загружены в соответствующее поле (простая ссылка на картинку не подойдет).
— Порядок карточек в фиде будет соответствовать нумерации полей (1, 2, 3...).

Отделка в ЖК

В фид Домклик можно передать массив отделок. Они могут быть не связаны с отделкой, указанной в Домопланере, поэтому мы выделили их создание в дополнительные поля проектов.

Каждая отделка включает:
— title — название отделки
— text — описание отделки текстом
— images — массив изображений (до 5 штук на одну отделку)

КАК НАСТРОИТЬ:

1. Перейдите в раздел НАСТРОЙКИ — Проекты и дома — Настройки проекта — Дополнительные поля — нажмите кнопку "Открыть редактор полей":

2. Нажмите на кнопку "Добавить поле" и для каждой отделки создайте три связанных дополнительных поля для проектов:
— Название отделки. Название: DC_decoration.1.title Тип поля: Текст.
— Описание. Название: DC_decoration.1.text Тип поля: Текст.
— Изображение. Название: DC_decoration.1.image.1 Тип поля: Изображение.

3. Заполните для каждого поля соответствующие значения. Нажмите кнопку "Сохранить".

ВАЖНО! МИНИМУМ ОДНО ИЗОБРАЖЕНИЕ ОБЯЗАТЕЛЬНО! Если поле с изображением не заполнено, отделка передаваться не будет, даже если заполнены название и описание.

ЕСЛИ НУЖНО НЕСКОЛЬКО ИЗОБРАЖЕНИЙ:
Вы можете добавить до 5 изображений на одну отделку. Для этого создайте дополнительные поля с увеличивающимся номером:
— DC_decoration.1.image.2 (Изображение)
— DC_decoration.1.image.3 (Изображение)
— DC_decoration.1.image.4 (Изображение)
— DC_decoration.1.image.5 (Изображение)

Тогда для первой отделки можно будет загрузить до 5 изображений.

КАК ДОБАВИТЬ НЕСКОЛЬКО ОТДЕЛОК
Чтобы передать несколько вариантов отделки, повторите ту же структуру, меняя первую цифру в названии поля:

Для второй отделки:
— DC_decoration.2.title
— DC_decoration.2.text
— DC_decoration.2.image.1, DC_decoration.2.image.2 и т.д.

Для третьей отделки:
— DC_decoration.3.title
— DC_decoration.3.text
— DC_decoration.3.image.1, DC_decoration.3.image.2 и т.д.

И так далее для каждого следующего варианта отделки.

КАК ЭТО РАБОТАЕТ: При формировании фида мы проверяем заполненность полей для каждой отделки. Отделка будет передана, если заполнены поля title, text и заполнено хотя бы одно поле с изображением (image.1).

Дополнительные цены 

В фиде Домклик можно передать дополнительные значения цены к помещению помимо основной. Поддерживается два типа:
— cash — цена при покупке за наличные
— mortgage — цена при покупке в ипотеку

Рассрочка и разделение ипотеки на несколько вариантов не предусмотрены — таковы требования самой площадки. Вот ссылка на требования самого Домклика.

КАК НАСТРОИТЬ:

1. Создайте дополнительные поля
Перейдите в НАСТРОЙКИ — Настройки помещений — Пользовательские поля и создайте новые поля типа "Текст'" с названием, например, "Цена наличные" и "Цена ипотека":

2. Заполните значения
Внесите данные по каждому объекту. Это можно сделать двумя способами:
— через редактор дома внутри каждого объекта с помощью "Изменение параметра";
— через выгрузку "Экспорт/Импорт".
Вспомнить про типы загрузки данных в системе можно в этой статье.

3. Создайте дополнительные поля в Настройках проекта
Перейдите в раздел НАСТРОЙКИ — Проекты и дома — Настройки проекта — Дополнительные поля — нажмите кнопку "Открыть редактор полей":

Для каждого проекта необходимо создать два дополнительных поля:
— Цена (оплата наличные). Название: DC_price_conditions.cash Тип поля: Текст.
— Цена (оплата ипотека). Название: DC_price_conditions.mortgage Тип поля: Текст.

4. Заполните значения 
В качестве значения этих полей нужно указать ID дополнительного поля помещений, в котором хранится соответствующая цена.

Где взять ID поля? Он отображается в списке дополнительных полей в разделе НАСТРОЙКИ — Настройки помещений — Пользовательские поля.

Нажмите кнопку "Сохранить".

В результате для каждой квартиры, где заполнены эти доп. поля, в фид уйдут соответствующие значения цен.

ВАЖНО! Основная цена помещения передаётся всегда отдельно, дополнительные цены идут как отдельные атрибуты.

КАК ЭТО РАБОТАЕТ: При формировании фида для Домклика система:
— Проверяет, заполнены ли у проекта поля DC_price_conditions.cash и/или DC_price_conditions.mortgage.
— Если поле заполнено (указан ID доп. поля помещений), то для каждой квартиры проверяется наличие значения в этом доп. поле.
— Если значение есть — оно добавляется в фид как соответствующая дополнительная цена.
— Если значения нет — дополнительная цена для этой квартиры не передается.

Дополнительные поля для акций

В фиде Домклика есть поле type внутри каждой акции. Оно обозначает тип акции:

Так как типы довольно своеобразные и могут дополняться самим Домкликом, мы выделили возможность добавления к каждой акции дополнительного поля, которое будет подставляться в это поле type.

КАК НАСТРОИТЬ:

1. Создайте доп.поле в акции

Перейдите в раздел ПРОЕКТЫ — Акции и скидки — откройте интересующую акцию — нажмите на кнопку "Открыть редактор дополнительных полей":

В открывшемся окне создайте новое дополнительное поле со следующими параметрами:
— Название: DC_type
— Тип: Текстовое поле

2. Заполните доп.поле
После создания поля в этом же окне укажите нужное значение — тип акции из списка требований Домклика. Например, для акции с общей скидки для всех, передайте в поле значения "скидки на жилье".
Возможные значения для этого поля смотрите в требования к фидам от Домклик.

КАК ЭТО РАБОТАЕТ: Для всех акций, у которых заполнено дополнительное поле DC_type, мы автоматически вставляем указанный тип акции в фид при выгрузке в Домклик: