CSV фид

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 Штрих-код товара, указанный производителем.
Поле Описание
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 Идентификатор родительской категории.
Поле Описание
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 — после.