НовоеProduct Score, 4T Segmentation, Price War и Broken Size уже доступны.Узнать, что нового
Feedance
Логотип Grupo ZapGrupo ZapКанал · Маркетплейсы и приложения
Интеграция с Grupo Zap

Отправляйте в Grupo Zap товары,
которые стоит показывать

Feedance создаёт ваш фид для Grupo Zap и добавляет метки на уровне товара: оценку, сегмент 4T, ценовую позицию и неполные размерные ряды, чтобы каждый товар нёс собственный сигнал эффективности.

Товарный фид для Grupo Zap
Сгенерирован Feedance
Экспорт XML, CSV или JSONОбновляется при каждой синхронизации
<item>
  <id>TS-1042</id>
  <title>Футболка с круглым вырезом</title>
  <price>49.90 USD</price>
  <availability>in stock</availability>
  <custom_label_0>score_86</custom_label_0>
  <custom_label_1>top</custom_label_1>
  <custom_label_2>best_price</custom_label_2>
  <custom_label_3>size_ok</custom_label_3>
</item>
Метки Feedance, записанные как custom labels
Что Feedance отправляет в Grupo Zap

Каталог с сигналом эффективности у каждого товара

Grupo Zap считывает ваши товары из фида. Feedance отправляет полный, корректный фид, а также сигналы, которых у Grupo Zap нет самостоятельно.

Product Scorecustom_label_0Оценка от 0 до 100 на основе просмотров, добавлений в корзину и покупок за 1, 7 и 30 дней.
Сегмент 4Tcustom_label_1Top, Tolerable, Tranquil или Toxic, по собственному трафику и доходу каждого товара.
Price Warcustom_label_2Дешевле, так же или дороже, чем указанные конкуренты.
Broken Sizecustom_label_3Отмечает модели, у которых большая часть размерного ряда распродана.
Креативыimage_linkБрендированные изображения из Creative Suite с ценой и деталями акции из фида.
Как это использовать: разделяйте кампании, группы товаров или наборы товаров по этим меткам, например только товары Top или всё, кроме Toxic и неполных размерных рядов. Слоты меток настраиваются. Feedance не меняет ваши ставки и бюджеты.

Что такое Grupo ZAP?

Grupo ZAP — подразделение OLX Group в сфере недвижимости в Бразилии, которое управляет двумя крупнейшими порталами объявлений о недвижимости в стране: ZAP Imóveis и Viva Real. Агентства недвижимости, брокеры и поставщики CRM подключают свои объекты к Grupo ZAP, чтобы объявления о продаже и аренде появлялись на обоих порталах — а в зависимости от выбранного тарифа и на доске объявлений OLX — из единого фида данных, без ручного ввода на каждом портале.

Зачем подключать фид объявлений о недвижимости к Grupo ZAP?

Вместо того чтобы брокер или агент заново вводил одно и то же объявление в ZAP Imóveis, Viva Real и OLX по отдельности, система управления объектами формирует один стандартизированный XML-файл, а краулеры Grupo ZAP забирают его по фиксированному расписанию. Любое изменение, внесённое один раз в исходной системе, — новая цена, обновлённый набор фотографий, объект, отмеченный как проданный или сданный, — при следующем обходе автоматически распространяется на все подключённые порталы. Именно поэтому агентства автоматизируют этот процесс, а не ведут бэк-офис каждого портала вручную.

VRSync заменяет устаревший формат ZAP XML

В документации Grupo ZAP для разработчиков названы две поддерживаемые XML-схемы: устаревший формат «ZAP», который прямо описан как находящийся в режиме поддержки, и VRSync — текущий стандарт, который «включает всю новую функциональность». В документации указано, что фиды не в формате VRSync выводятся из употребления, а собственный инструмент проверки XML от Grupo ZAP принимает только файлы в формате VRSync. Любая новая интеграция — в том числе созданная с помощью инструмента управления фидами — должна ориентироваться на VRSync, а не на старый формат.

Какой формат фида требует Grupo ZAP?

Grupo ZAP получает объявления по модели опроса: платформа не принимает загрузки, отправляемые ей напрямую, а периодически скачивает XML-файл VRSync по указанному вами URL. Согласно официальному Guia de Conexão (руководству по подключению), принимающий сервер должен соответствовать ряду конкретных технических требований:

  1. Разрешать User-Agent краулера (в документации он указан как VivaRealBot/1.0), иначе запросы будут завершаться ошибкой HTTP 403
  2. Отдавать фид по HTTPS с действительным, не самоподписанным сертификатом и поддержкой TLS 1.0–1.2
  3. Отвечать в пределах 60-секундного тайм-аута соединения и завершать передачу файла в пределах 20-минутного окна загрузки
  4. Ограничивать длину самого URL фида 255 символами, используя корректное URL-кодирование без «сырых» пробелов
  5. Поддерживать до 100 перенаправлений по тому же протоколу, если цепочка URL перенаправляется

Кроме того, официальный XML Validator принимает файлы размером не более 30 МБ и отклоняет всё, что не отформатировано в VRSync.

Какие атрибуты объявлений о недвижимости требует VRSync?

Схема VRSync состоит из блока Listing и вложенного блока Details. Согласно справочнику элементов Grupo ZAP, обязательными (или обязательными в зависимости от типа объекта) задокументированы следующие:

АтрибутЭлементТребование
ID объявленияListingIDОбязательный, 1–50 символов, уникален для каждого объекта
ЗаголовокTitleОбязательный, 10–100 символов, без HTML-тегов
Тип сделкиTransactionTypeОбязательный: For Sale, For Rent или Sale/Rent
Адрес / местоположениеLocation (Country, State, City, Neighborhood, PostalCode)Обязательный; PostalCode обязателен во всех объявлениях
ФотографииMedia / ItemОбязательный, не менее 5 изображений в объявлении
Контакт брокераContactInfo (Name, Email)Обязательный
Тип объектаPropertyTypeОбязательный, только стандартизированные значения
ОписаниеDescriptionОбязательный, 50–3 000 символов, CDATA, без HTML-тегов
Жилая площадьLivingAreaОбязателен для большинства типов объектов, unit="square metres"
Спальни / санузлыBedrooms, BathroomsОбязательны для жилых типов; не требуются для земельных участков и складов
Цена продажи или арендыListPrice / RentalPriceListPrice обязателен для объявлений о продаже; RentalPrice обязателен для объявлений об аренде; обязателен атрибут currency="BRL"
Площадь участкаLotAreaОбязателен вместо LivingArea для земельных участков, ферм и ранчо

Как подключить Grupo ZAP к Feedance

Feedance может создавать и размещать XML-файл VRSync, который опрашивает краулер Grupo ZAP, сопоставляя записи об объектах из вашей исходной системы (CRM, ERP или таблицы) со структурой Header, Listing и Details, которую требует стандарт.

  1. Сопоставьте поля данных об объектах (адрес, цена, спальни, санузлы, площадь, фотографии, тип сделки) с соответствующими элементами VRSync
  2. Настройте необходимую условную логику — например, заполнять LotArea только для земельных участков или RentalPrice только для объявлений Rent/Sale-Rent, — поскольку обязательные поля VRSync зависят от типа объекта
  3. Опубликуйте фид по стабильному HTTPS-URL, отвечающему требованиям Grupo ZAP к подключению (действительный сертификат, разрешённый User-Agent, URL короче 255 символов)
  4. Зарегистрируйте URL фида в Grupo ZAP через Canal Pro или своего представителя, чтобы их краулер начал его опрашивать
  5. Отслеживайте отчёты об интеграции, которые присылает Grupo ZAP (через Canal Pro, по email или через вебхук, согласно документации), и исправляйте отклонённые объявления в источнике

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

Как часто должен обновляться фид?

Согласно документации Grupo ZAP, XML-файлы обрабатываются дважды в день с интервалом примерно 12 часов — это загрузка по инициативе краулера, а не отправка, поэтому пересоздавать фид чаще этого цикла бессмысленно. Важно, чтобы перед каждым окном обхода фид отражал текущее положение дел (цену, доступность, статус «продано/сдано»), поскольку устаревший фид будет держать недоступный объект в объявлениях или оставит обновлённую цену несинхронизированной до следующей 12-часовой загрузки.

Типичные ошибки фида

Документация Grupo ZAP и её XML Validator отмечают несколько повторяющихся причин отклонения объявлений:

  1. Денежные значения и площади, отформатированные с символами валют, разделителями тысяч или дробной частью, — например, «R$560.000,00» или «32,20», — вместо простых целых чисел
  2. Отсутствие обязательного атрибута currency="BRL" в элементах цены или атрибута unit="square metres" в элементах площади
  3. Пустые или отсутствующие элементы Description (<Description/>) либо описания длиной вне диапазона 50–3 000 символов
  4. Отсутствие LivingArea (или LotArea для земельных участков/ферм), что валидатор считает критической ошибкой
  5. Ответы HTTP 403 из-за того, что сервер хостинга блокирует User-Agent краулера
  6. URL фидов длиннее 255 символов или с незакодированными символами/пробелами
  7. Файлы, не являющиеся корректным XML VRSync или превышающие лимит валидатора в 30 МБ

Советы по оптимизации

Общие практики качества фида (не утверждения, специфичные для Grupo ZAP), которые обычно повышают эффективность объявлений на порталах недвижимости:

  1. Не ограничивайтесь минимумом в 5 изображений — больше фотографий в логичном порядке, начиная с экстерьера или лучшей комнаты, как правило, повышают вовлечённость на порталах объявлений
  2. Пишите полные и точные описания, используя весь доступный объём символов, а не минимум: скудное описание из 50 символов вряд ли хорошо сконвертирует, даже если пройдёт проверку
  3. Синхронизируйте цены и статусы с исходной системой в реальном времени на своей стороне, чтобы при следующем обходе всегда загружались актуальные данные, а не устаревший снимок
  4. Заполняйте необязательные отличительные данные, где это возможно (ссылки на виртуальные туры, точные широта/долгота, сведения о районе/зоне), чтобы покупателям было проще фильтровать и находить объявление

Вопросы и ответы

Поддерживает ли Feedance именно формат VRSync? Feedance может формировать XML-фиды, сопоставленные со структурой элементов VRSync, определённой в документации Grupo ZAP; устаревший формат ZAP выведен из употребления, и для новых интеграций его использовать не следует.

Можно ли отправлять один и тот же фид в ZAP Imóveis, Viva Real и OLX? В материалах Grupo ZAP описан единый XML-фид, который распространяется на порталы, входящие в ваш тариф, без необходимости в отдельных фидах для каждого портала.

Как я узнаю, что объявление отклонено? Grupo ZAP сообщает, что отправляет отчёты об интеграции, а при ошибках, сохраняющихся более трёх дней, — прямые уведомления по email с подробностями о том, что не прошло.

Это такой же фид, как товарный фид Google Merchant Center или Meta? Нет — VRSync — это схема, специфичная для недвижимости, с вложенными структурами Location, Media, ContactInfo и Details и обязательными полями, зависящими от типа объекта. Структурно она отличается от плоского товарного фида e-commerce, хотя основная цель (один исходный фид — несколько каналов назначения) похожа.

О Grupo Zap

Grupo ZAP — бизнес OLX Group в сфере недвижимости в Бразилии. Он управляет двумя крупнейшими порталами недвижимости страны — ZAP Imóveis и Viva Real, где люди ищут дома, квартиры и коммерческую недвижимость для покупки или аренды.

Агентства недвижимости, брокеры и поставщики программного обеспечения для недвижимости передают свои объявления в Grupo ZAP, чтобы объекты появлялись на обоих порталах, а в зависимости от подключённого тарифа — и в объявлениях OLX. Один источник данных заменяет ручной ввод одного и того же объявления в бэк-офисе каждого портала.

Объявления передаются в виде XML-фида в формате VRSync, который Grupo ZAP называет своим текущим стандартом; более старый формат ZAP XML находится в режиме поддержки. Grupo ZAP не принимает загрузки методом push. Его краулер регулярно по расписанию скачивает фид по URL с HTTPS, поэтому сервер должен пропускать краулер, быстро отвечать и надёжно отдавать файл.

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

Узнайте, какие
товары приносят доход.

Подключите фид и GA4. Мы покажем Product Score, 4T, Price War и Broken Size на вашем собственном каталоге.