CSV фид

CSV фид — файл в формате CSV, который содержит данные в виде таблицы. Одна строка — это одно товарное предложение (оффер).

Пример:

Требования

  • Данные должны быть представлены в виде таблицы.

  • Разделители: ; и ,.

  • Формат: UTF-8 (без BOM) или windows-1251.

  • Первая строка должна содержать заголовки полей.

  • Обязательные колонки: id и url.

  • Каждый id должен быть уникальным.

  • Файл фида должен быть доступен по url, который вы указали в настройках проекта.

  • Названия столбцов могут содержать кириллицу и латиницу, десятичные числа, а также символы * и _.

Рекомендации

Используйте все возможные параметры товаров в фиде. Чем больше параметров — тем больше возможностей для составления объявлений.

Рекомендуемые параметры фида по стандарту Яндекс Маркет

Звездочкой * выделены обязательные параметры.

Поле

Описание

id *

Уникальный идентификатор товара.

url *

URL адрес страницы товара. Максимальная длина — 512 символов.

price

Цена товара. Выводится и округляется в зависимости от настроек пользователя.

currencyId

Идентификатор валюты товара: RUB, USD, UAH, KZT. Чтобы цена в национальной валюте отображалась правильно, используйте идентификатор (например, UAH) с соответствующим значением цены.

picture

Ссылка на изображение товарного предложения. Нельзя использовать ссылки на заглушки, плейсхолдеры, логотипы. Максимальная длина ссылки — 512 символов.

typePrefix

Название группы товаров или категории.

vendor

Производитель.

model

Модель.

name

Наименование товарного предложения.

store

Покупка в точке продаж без предварительного заказа через интернет.

  • true — да.
  • false — нет.

pickup

Самовывоз.

  • true — да.
  • false — нет.

delivery

Доставка на условиях, описанных в партнерском интерфейсе на странице Редактирование.

  • true — да.
  • false — нет.

description

Описание товарного предложения.

vendorCode

Код товара. Как правило — код от производителя.

local_delivery_cost

Стоимость доставки товара в регионе продавца.

available

Товар в наличии или на заказ.

  • true — в наличии. Магазин готов сразу договориться с покупателем о доставке товара, либо товар имеется в магазине или на складе, где товар выдают покупателям. Точное описание смотрите в Требованиях к рекламным материалам.
  • false — на заказ. Магазин готов поставить товар на указанных условиях в течение месяца (срок может быть больше для товаров, которые всеми участниками рынка поставляются только на заказ). Те товарные предложения, на которые заказы не принимаются, не должны выгружаться в Яндекс Маркет.

sales_notes

Информация о минимальной сумме заказа, минимальной партии товара, обязательной предоплате, акциях, скидках и распродажах. Допустимая длина текста — 50 символов.

manufacturer_warranty

Официальная гарантия производителя.

  • true — да.
  • false — нет.

country_of_origin

Страна производства.

downloadable

Продукт можно скачать только с предоплатой. Если указано true, предложение показывается во всех регионах, при этом оплатить продукт можно только онлайн.

adult *

Обязательная отметка, если товар имеет отношение к удовлетворению сексуальных потребностей, либо иным образом эксплуатирующие интерес к сексу.

  • true — да.
  • false — нет.

age

Возрастная категория товара. Допустимые значения: 0+, 6+, 12+, 16+, 18+.

barcode

Штрих-код товара, указанный производителем.

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

Примеры:

  • param_discount — размер скидки.

  • param_addition_date — дата добавления товара в каталог. С помощью такой даты можно автоматически добавлять и убирать пометку Новинка в рекламе новых товаров.

  • param_disk_type, param_disk_diameter, param_pins — параметры автомобильных дисков.

Я не могу использовать поле id, что делать?

Вместо ID товаров укажите опорные поля, по которым можно однозначно определить оффер — в конце названия поля добавьте звездочку *.

Например, если комбинация производителя и модели уникальна для каждого товара, то используйте поля vendor* и offer*.

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

Желательно использовать динамический фид — чтобы файл генерировался на основании актуальных данных каждый раз при обращении к нему по URL.

Иначе обновляйте фид один раз в час.

Категорийный фид

Чтобы создавать объявления для категорий товаров, используйте категорийный фид.

Рекомендуемые параметры категорийного фида

Поле

Описание

id

Идентификатор строки.

cat_id (category_id)

Идентификатор категории.

parent_id

Идентификатор родительской категории.

Рекомендуется использовать дополнительные поля с агрегированной информацией. Например, среднюю цену или количество товаров в наличии.

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

  • www.site.ru/catalog/category/brand/model — хорошо.

  • www.site.ru/catalog/tv/samsung/UE85HU8500TXRU — хорошо.

  • www.site.ru/tv-samsung-UE85HU8500TXRU — плохо.

CSV из Google Таблиц

Чтобы получить ссылку на CSV файл из Google Таблиц:

  1. Создайте таблицу в Google Диске.

  2. В таблице слева вверху нажмите Файл →  → Открыть доступ →  → Опубликовать в интернете → .

  3. Выберите название нужного листа.

  4. Выберите тип Файл CSV.

  5. Нажмите кнопку Опубликовать.

  6. Скопируйте ссылку.

CSV из Dropbox

Чтобы получить ссылку на CSV файл из Dropbox:

  1. Загрузите CSV файл в Dropbox.

  2. Скопируйте ссылку на файл.

  3. В ссылке измените dl=0 на dl=1, чтобы файл стал доступен для К50:

    • https://www.dropbox.com/s/(...)/test_feed.csv?dl=0 — до.

    • https://www.dropbox.com/s/(...)/test_feed.csv?dl=1 — после.

Предыдущая
Следующая