В этом подразделе можно выполнять пакетные действия по добавлению объявлений в базу и их выгрузке из нее.
В скрипте доски объявлений со стороны пользовательской части функция импорта доступна только в профиле типа Магазин (Бизнес).
1. Импорт объявлений
Для импорта объявлений, после выбора категории можно скачать XML или CSV шаблон, которому стоит следовать:
Также обязательно необходимо указать пользователя, которому эти объявления будут принадлежать.
После импорта объявлений данные отображаются в табличном виде в блоке ниже:
Краткое описание структуры XML файла импорта:
<?xml version="1.0" encoding="UTF-8"?>
<bbs type="items-import-export">
<items>
<item id="0" external="0" publicated="1">
<title>Заголовок объявления</title>
<description>Текст подробного описания объявления</description>
<user id="10" shop="0">user@gmail.com</user>
<category type="offer">31</category>
<geo delivery="0">
<city id="255">Киев</city>
<station id="30">Площадь Независимости</station>
<district>5</district>
<addr>переулок Тараса Шевченко, 8б</addr>
<lat>50.451099</lat>
<lon>30.530300</lon>
</geo>
<price currency="1" free="0" exchange="0" agreed="0" mod="1">1000.00</price>
<images>
<image id="8">http://example.com/files/image1.jpg</image>
<image id="4">http://example.com/files/image2.jpg</image>
</images>
<contacts>
<name>Имя пользователя</name>
<phones>
<phone>123 00 11 11</phone>
<phone>123 00 22 22</phone>
</phones>
<skype>_Skype1_</skype>
<icq>1234567890</icq>
</contacts>
<video></video>
</item>
<item id="0" external="0" publicated="1">...</item>
</items>
</bbs>
Основной элемент <items> с вложенными <item>.
<item>включает в себя следующие атрибуты:- id который может быть равен нулю (0), в таком случае будет создано новое объявление, либо больше нуля, в таком случае будет выполнен поиск объявления по id в базе и если такое будет найдено, данные объявления будут обновлены.
- external, при помощи которого доступна возможность указать ID во внешнем источнике, что позволяет в дальнейшем обновлять существующие объявления по указанному ID не привязываясь к ID в базе данных проекта. Данный атрибут принимает значения 0 или 1, в случае если указано значение 1, значение атрибута id обрабатывается как ID из внешнего источника (версия 2.2.4+).
- publicated указывает на требуемый статус объявления, 0 - снять с публикации, 1 - опубликовать. Данный атрибут имеет больший приоритет чем статус указанный в настройках импорта (версия 2.4.3+).
В тег <item> входят следующие вложенные теги:
<title>- заголовок объявления (обязательный элемент)<description>- описание<user id="10" shop="0">Email пользователя</user>- пользователь, владелец создаваемого объявления, id - ID пользователя в базе, shop - ID магазина привязанного к данному пользователю либо 0.<category type="offer">31</category>- ID категории, в которой будет размещено объявление, в данной категории не должно быть подкатегорий (обязательный элемент).- атрибут type определяет тип объявления (версия 2.2.4+) и принимает следующие значения:
offer- предлагаю/продам (по-умолчанию)seek- ищу/куплю
- начиная с версии 2.2.4 данный тег не является обязательным, в случае его отсутствия будет использована категория указанная в настройках импорта.
- атрибут type определяет тип объявления (версия 2.2.4+) и принимает следующие значения:
<geo delivery="0">- гео. данные (обязательный элемент):<city id="255">Киев</city>- ID города, название необязательно, главное указать атрибут id<station id="30">Площадь Независимости</station>- ID станции метро, название необязательно<district>5</district>- ID района города (версия 2.2.4+)<addr>переулок Тараса Шевченко, 8б</addr>- адрес на карте<lat>50.451099</lat>- координата Lat на карте<lon>30.530300</lon>- координата Lon на карте- атрибут delivery - возможность доставки в регионы, варианты 1 или 0 (по-умолчанию). В случае если в категории, в которую добавляется объявление, настройка "Доставка в регионы" выключена - данный атрибут игнорируется. (версия 2.2.4+)
<price currency="1" free="0" exchange="0" agreed="0" mod="1">1000.00</price>- цена указываемая в объявлении.- атрибут currency - ID валюты
- атрибут free - пометка "Даром", 0/1
- атрибут exchange - пометка "Обмен", 0/1
- атрибут agreed - пометка "Договорная", 0/1 (версия 2.3+)
- атрибут mod - пометка "Торг возможен", 0/1
- Значение - стоимость
<images>- изображения, прикрепляемые к объявлению<image id="8">http://example.com/files/image1.jpg</image>- Атрибут "id" - ID изображение в таблице
bff_bbs_items_imagesна случай если оно уже было загруженно ранее или 0 - Значение - URL изображения для загрузки
<contacts>- контакты владельца объявления, указываются в каждом объявлении<name>- имя<phones>- телефоны<skype>- skype<icq>- icq
<video>- видео-ссылка(url) на ролик youtube / vimeo
Краткое описание структуры CSV файла импорта (версия 2.3.0+):
item-id - 0 (добавить новое объявление), ID (обновить данные об объявлении)
item-external - ID во внешнем источнике
item-publicated - Статус публикации, 0 - снято с публикации, 1 - опубликовано (версия 2.4.3+)
user - ID существующего пользователя или Email существующего/нового пользователя
title - заголовок объявления (обязательный элемент)
description - описание
category-id - ID категории, в которой будет размещено объявление
category-type - тип объявления: offer, seek
geo-delivery - возможность доставки в регионы, варианты 1 или 0 (по-умолчанию)
geo-city-id - ID города (обязательный элемент)
geo-station-id - ID станции метро
geo-district-id - ID района города
geo-addr - адрес на карте (улица, дом)
geo-lat - координата Lat на карте
geo-lon - координата Lon на карте
price - цена указываемая в объявлении
price-currency - ID валюты
price-free - пометка "Даром", 0/1
price-exchange - пометка "Обмен", 0/1
price-mod - пометка "Торг возможен", 0/1
price-agreed - пометка "Договорная", 0/1
images - изображения, URL разделяемые 1 пробельным символом
contacts-name - имя владельца
contacts-phones - телефоны, разделителем является символ ;
contacts-skype - skype
contacts-icq - icq
video - видео-ссылка на ролик youtube / vimeo
Дополнительные контактные поля, реализованные в версии 2.3.3 можно указывать следующим образом:
contacts-telegram, contacts-whatsapp, contacts-viber и другие добавленные вами по схожему принципу
2. Экспорт объявлений
Для экспорта объявлений необходимо обязательно выбрать категорию:
3. Экспорт объявлений в Яндекс.Маркет
Перейдите во вкладку Яндекс.Маркет.
Выполните настройку параметров экспорта объявлений в Яндекс.Маркет:
1. Чтобы получить доступ к настройкам экспорта объявлений в Яндекс.Маркет, Установите флажок Формировать выгрузку.
2. В поле Наименование магазина введите короткое название своего магазина, соответствующее следующим требованиям:
- до 20 символов;
- не содержит слова, которые не имеют к нему отношения, например «лучший», «дешевый» и т. п.
- совпадает с фактическим названием, опубликованным на сайте.
3. В поле Наименование компании введите полное название своей компании.
4. С помощью блока Валюты задайте свой список курсов валют для отображения в Яндекс.Маркете.
5. Из выпадающего списка Основная валюта выберите валюту, которая будет взята за единицу при расчёте курса других валют.
6. Настройте опцию Категории, выбрав одно из следующих действий:
- Установите флажок все категории, чтобы выбрать все категории объявлений.
- Укажите конкретные категории объявлений с помощью выпадающего списка.
7. Используйте опцию Загрузка, чтобы автоматизировать процесс загрузки прайс-листа на Яндекс.Маркет:
- Установите флажок разрешить Яндекс.Маркету автоматически загружать прайс лист.
- Если доступ к файлу прайс-листа требует настройки доступа, то установите флажок требовать авторизацию.
8. Нажмите кнопку Сохранить.
Примечание:
Прайс-лист формируется в формате YML раз в сутки. Чтобы обновить прайс-лист принудительно, нажмите кнопку Сформировать принудительно. Чтобы скачать прайс-лист, нажмите ссылку скачать в верхней части окна настроек.