Продавцы могут загружать свои товары в Pinterest в виде товарных пинов. Товарные пины имеют специальный формат, представляя ваши товары в Pinterest как доступные для покупки. Они содержат название и описание товара, а также цену и информацию о наличии.
Добавьте в Pinterest источник данных розничного каталога, чтобы сразу загрузить несколько товаров в виде товарных пинов. После этого вы сможете рекламировать товары в Pinterest в виде товарных объявлений. Вы можете предоставить URL-адрес источника данных на хостинге или загрузить его вручную.
Прежде чем добавить розничный каталог, необходимо сделать следующее:
Если вы не соответствуете указанным выше требованиям,
Работа розничных каталогов зависит от того, как вы добавили источник данных, предоставляющий доступ к каталогу.
Если вы указали URL-адрес своего источника данных, мы ежедневно будем обращаться к нему, чтобы динамически создавать товарные пины для каждого товара в каталоге. Чтобы информация о товаре была актуальной, обеспечьте ежедневную доступность обновляемого источника данных. Вы также можете запланировать прием данных заранее.
Если вы загрузили источник данных вручную, мы получим доступ к нему при первоначальной загрузке и после каждого обновления, что позволяет создавать товарные пины и обновлять метаданные для существующих пинов в вашем розничном каталоге.
Мы уведомим вас о наличии ошибок. Важно как можно быстрее проверять и исправлять ошибки, чтобы информация о товарах была точной и актуальной. Ошибки могут указывать на то, что не обновляется вся лента, на то, что не обновляются лишь некоторые позиции в ней или нужно внести изменения в форматирование.
Мы можем обработать до 20 миллионов товаров в одном розничном каталоге. Если у вас более 20 миллионов товаров,
Это актуально только в том случае, если вы размещаете источник данных на хостинге. Если вы загружаете источник данных вручную, этот раздел можно пропустить.
Размещайте источник данных на сервере FTP/SFTP/WebDAV или по прямой ссылке для скачивания HTTP/HTTPS. Ссылка должна быть доступна для пользовательского агента. Использование «белых списков» определенных IP-адресов и SSH-ключей не допускается. Если вы используете прямую ссылку для скачивания, файл должен быть доступен без какой-либо дополнительной навигации.
Мы поддерживаем следующие форматы:
Значения, разделенные табуляцией (TSV) | (Скачать пример файла TSV) |
Значения, разделенные запятыми (CSV) | (Скачать пример файла CSV) |
Файлы XML (RSS 2.0, ATOM 1.0) | (Скачать пример файла XML) |
Примечание. Можно использовать сжатые файлы (ZIP, GIZ, GZ, BZ2 и другие), но зашифрованные и защищенные паролем сжатые файлы, а также файлы на Google Диске или Dropbox в настоящее время не поддерживаются.
Розничный каталог должен содержать приведенные ниже поля, отформатированные точно в соответствии с примером. Отсутствие или недопустимый формат какого-либо поля помешает обработке всего каталога.
Название столбца | Описание | Синтаксис/поддерживаемые значения | Пример |
---|---|---|---|
id |
Уникальный идентификатор товара. |
До 127 символов. | DS0294-L |
title | Название товара (должно совпадать с названием товара на целевой странице и содержит подробности о разновидности товара, например цвет и размер). | До 500 символов. | Women’s denim shirt, large |
description | Описание товара. | До 10 000 символов простого текста (не HTML). | Повседневная джинсовая рубашка из высококачественной японской джинсовой ткани |
link | Целевая страница товара (должна вести непосредственно к товару и отображать те же данные) |
Строка URL До 511 символов, URL-адрес должен начинаться с префикса http:// (не рекомендуется использовать страницы с требованием регистрации). |
https://www.example.com/cat/womens-clothing/denim-shirt-0294 |
image_link |
Ссылка на основное изображение товара (не менее 75 x 75 пикселей, должно быть доступно для пользовательского агента и не иметь изображений шаблонов или заполнителей). Если в дальнейшем вы измените изображение, для него нужно указать другую ссылку. Иначе оно не обновится. |
Строка URL До 2000 символов, начинается с префикса http:// или https:// (необходимо закодировать или удалить запятые). Рекомендация: заключайте строку в кавычки. |
https://scene.example.com/image/image.jpg |
price |
Цена товара (должна отражать истинную стоимость товара и включать валюту по стандарту ISO-4217, если цена указана не в долларах США, в противном случае по умолчанию будет указана валюта в долларах США). |
<число> <ISO 4217> Валюта может указываться до или после числового значения цены, с пробелом или без него, обозначение должно следовать стандарту ISO-4217. Не используйте нулевые значения или символы валют. |
24.99 USD 24.99USD 24,99 USD 24,99USD 24.99 24,99 RUB249.99 RUB 249.99 RUB249,99 RUB 249,99 |
availability | Наличие товара. |
Должно содержать одно из следующих значений: in stock |
in stock |
item_group_id (необходимо только если товары имеют несколько вариантов) | Родительский идентификатор товара. | До 127 символов. | DS0294 |
Вы можете добавить в розничный каталог дополнительные поля, чтобы мы лучше сопоставили ваши товары с пользователями. Чем больше информации вы предоставите, тем более актуальными будут пины для пользователей, которые их просматривают. Ниже дополнительные поля описаны подробнее.
Название столбца | Описание | Синтаксис/поддерживаемые значения | Пример |
---|---|---|---|
product_type | Категория товара по вашей таксономии. |
До пяти подкатегорий, которые могут содержать не больше 1000 символов, должны разделяться символом «>» с пробелами по обе стороны (другие разделители, такие как запятая или вертикальная черта, не распознаются). |
Clothing > Women’s > Shirts > Denim |
additional_image_link |
Ссылки на дополнительные изображения товара в количестве до 10 штук (не менее 75 x 75 пикселей, должны быть доступны для пользовательского агента и не иметь изображений шаблонов или заполнителей). Мы создадим новый пин для каждой дополнительной ссылки на изображение. Если в дальнейшем вы измените изображение, для него нужно указать другую ссылку. Иначе оно не обновится. |
До 2000 символов в каждой ссылке, начинаются с префикса http:// или https:// (необходимо закодировать или удалить запятые). Рекомендация: заключайте строку в кавычки. |
«https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg» |
mobile_link | Версия целевой страницы, оптимизированная для мобильных устройств. | Ссылка должна начинаться с префикса http:// или https:// | https://m.example.com/cat/womens-clothing/denim-shirt-0294 |
sale_price |
Цена товара со скидкой (должна быть меньше стандартной цены и включать валюту по стандарту ISO-4217, если цена указана не в долларах США, в противном случае по умолчанию будет указана валюта в долларах США). Если указана цена распродажи, то она будет считаться текущей ценой товара. |
<число> <ISO 4217> Валюта может указываться до или после числового значения цены, с пробелом или без него, обозначение должно следовать стандарту ISO-4217. Не используйте нулевые значения или символы валют. |
14.99 USD 14.99USD 14,99 USD 14,99USD 14.99 14,99 RUB 149.99 RUB149.99 RUB 149,99 RUB149,99 |
average_review_rating | Среднее количество отзывов о товаре. |
<число> От 1 до 5 |
5 |
number_of_ratings | Количество оценок у товара. | <число> | 2 |
number_of_reviews | Количество отзывов о товаре. | <число> | 4 |
description_html |
Описание товара в формате HTML. Рекомендация: используйте это поле, если длина описания превышает 200 символов. При наличии значение этого поля будет использоваться вместо обычного описания. |
Форматирование HTML | <body> <h1>Мой товар</h1> <p>Купить</p> </body> |
video_link |
Ссылка на видео товара на хостинге. Допустимые типы файлов для видео по ссылке: .mp4, .mov или .m4v. Размер файла не может превышать 2 ГБ. |
Строка URL Максимум 2000 символов (начиная с http:// или https://). |
https://www.example.com/example.mp4 |
Название столбца | Описание | Синтаксис/поддерживаемые значения | Пример |
---|---|---|---|
item_group_id | Родительский идентификатор товара. | До 127 символов. | DS0294 |
brand |
Название бренда товара. | До 100 символов. | Josie’s Denim |
gtin | Уникальный универсальный идентификатор товара. | Число, должно следовать правилам GTIN. | 3234567890126 |
mpn | Артикул производителя товара. |
До 70 символов (буквы и цифры). |
"mpn": "PI12345NTEREST" |
Название столбца | Описание | Синтаксис/поддерживаемые значения | Пример |
---|---|---|---|
color |
Основной цвет товара. | До 30 символов. | blue |
gender | Пол пользователей товара. | Должно содержать одно из следующих значений: male female unisex |
MALE |
age_group | Возраст пользователей товара. |
Должно содержать одно из следующих значений: newborn |
newborn |
material | Материал, из которого изготовлен товар. | До 30 символов. | cotton |
pattern | Узор, используемый для товара. | До 30 символов. | plaid |
size | Размер товара. | До 30 символов. | M |
size_type | Дополнительное описание размера товара. |
Должно содержать одно из следующих значений: regular |
regular |
size_system | Таблица размеров для страны, в которой заказан товар. | Код страны. |
США |
alt_text | Описание основных изображений товара. | Одно или несколько значений замещающего текста, разделенных запятыми. Количество значений замещающего текста должно соответствовать количеству изображений в поле image_link. Входящие в текст запятые следует закодировать как «,» или удалить. Используйте запятые для разделения нескольких значений замещающего текста. | Голубая вязаная крючком детская шапка с кисточками |
variant_names | Параметры этого варианта товара (пользователи Pinterest увидят эти параметры рядом с вашим пином и смогут выбрать нужный). | Текст, разделенный запятыми, в желаемом порядке отображения. | Цвет,Размер |
variant_values | Параметры ценности этого варианта товара (пользователи Pinterest увидят эти параметры рядом с вашим пином и смогут выбрать нужный вариант). |
Текст, разделенный запятыми, в желаемом порядке отображения. Должен соответствовать порядку в поле variant_names. |
Красный,S |
adult | Предназначен ли товар для взрослых. Товары для взрослых не будут отображаться в Pinterest. |
Должно содержать одно из следующих значений: TRUE |
false |
Название столбца | Описание | Синтаксис/поддерживаемые значения | Пример |
---|---|---|---|
tax | Налоговые реквизиты для товара. |
Содержит четыре элемента: три обязательных (country, region, rate) и один дополнительный (tax_ship). Все двоеточия должны быть указаны, даже для пустых значений. country:region:rate(required):tax_ship |
US:1025433:6.00:y |
shipping | Сведения о доставке товара. |
Содержит четыре элемента: три необязательных (country, region, service) и один обязательный (price). Все двоеточия должны быть указаны, даже для пустых значений. country:region:service:price(required) |
US::Express:13.12 |
shipping_weight |
Вес товара. |
<число> <единица измерения> Между числом и единицей измерения должен стоять пробел. |
5 фунтов |
shipping_width | Ширина упаковки для доставки товара. |
<число> <единица измерения> Между числом и единицей измерения должен стоять пробел. |
16 in |
shipping_height | Высота упаковки для доставки товара. |
<число> <единица измерения> Между числом и единицей измерения должен стоять пробел. |
12 in |
free_shipping_label |
Предлагаете ли вы бесплатную доставку товара. Если она бесплатна всегда, введите в поле free_shipping_limit значение «0», а если только для заказов от определенной суммы — укажите эту сумму в поле free_shipping_limit. |
Должно содержать одно из следующих значений: TRUE |
true |
free_shipping_limit | Минимальная сумма заказа для бесплатной доставки товара. |
<число> <ISO 4217> |
35USD |
Название столбца | Описание | Синтаксис/поддерживаемые значения | Пример |
---|---|---|---|
custom_label_0 | Настраиваемая группировка товаров (до пяти) | До 200 символов. |
Summer promotion |
custom_label_1 | Настраиваемая группировка товаров (до пяти) | До 200 символов. | Best sellers |
custom_label_2 | Настраиваемая группировка товаров (до пяти) | До 200 символов. | Новые товары |
custom_label_3 | Настраиваемая группировка товаров (до пяти) | До 200 символов. | Распродажа |
custom_label_4 | Настраиваемая группировка товаров (до пяти) | До 200 символов. | Скидка 50 % |
Название столбца | Описание | Синтаксис/поддерживаемые значения | Пример |
---|---|---|---|
ad_link | Ссылка для отслеживания трафика, исходящего от товарных объявлений Pinterest. |
Строка URL Необходимо отправить полный URL-адрес отслеживания, а не только параметры. В настоящее время отслеживание показов не поддерживается. Ссылки должны начинаться с http:// или https:// |
https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest |
condition | Состояние товара. |
Должно содержать одно из следующих значений: new |
new |
google_product_category | Категоризация товаров на основе стандартизированной таксономии товаров в Google. |
Просмотрите полную таксономию для английского языка. Таксономию для других языков можно найти в Справочном центре Google. Принимаются текстовые значения и цифровые коды. |
Apparel & Accessories > Clothing > Shirts & Tops 21 |
Соблюдайте правила, изложенные в нашем
Узнайте, как