Руководство по работе с каталогами

Похоже, вы находитесь в регионе, в котором каталоги еще не доступны. Узнайте, в каких странах владельцы бизнес-аккаунтов могут использовать каталоги.

Подробнее

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

Для чего нужны каталоги

Каталоги — это инструменты обработки канала, созданные для компаний, которые продают товары на своих веб-сайтах. Вот что нужно для использования каталогов.

  • Бизнес-аккаунт Pinterest.
  • Источник данных — файл со списком ваших товаров и соответствующими атрибутами. Он также называется каталогом или каналом товаров.
  • Подтвержденный сайт.
  • Веб-сайт, соответствующий требованиям Руководства для продавцов, с четкими правилами доставки, политикой возмещения и контактными данными, которые нетрудно найти.
  • Хостинг источников данных — это способ единого размещения и хранения источника данных для ваших товаров, которые вы можете ежедневно отправлять в Pinterest.

Если вы не соответствуете этим требованиям и хотите создать товарные пины, вы можете сотрудничать с сайтом электронной коммерции, который отформатирует ваши товары для Pinterest. Сейчас мы поддерживаем интеграцию с GoDataFeed и Productsup. Вы также можете рекламировать свой контент в Pinterest другими способами.

Обзор источника данных

Что такое источник данных?

Источник данных (каталог товаров, канал товаров или данных) — это файл со списком ваших товаров и соответствующими атрибутами, который имеет особую структуру. Мы обрабатываем этот файл каждый день для динамического создания пинов на основе ваших товаров.

Как работает источник данных

Для отправки источника данных в Pinterest вам необходимо предоставить URL-адрес, по которому мы сможем получить доступ к файлу источника данных. Мы проверим файл и создадим товарный пин для каждого элемента, который будет соответствовать нашим требованиям. Узнайте больше о характеристиках источника данных.

Поддержание источника данных

Хостинг источника данных — это первый шаг для постоянного обновления информации о доступных товарах. Каждый день Pinterest будет обрабатывать ваш источник данных и сообщать о любых ошибках. Важно как можно быстрее проверять и исправлять ошибки, чтобы информация о вашем товаре была точной и актуальной.

Есть разные типы ошибок: одни указывают на то, что весь канал не обновляется, другие — что не обновляются лишь некоторые элементы канала или нужно внести изменения для улучшения его работы. Узнайте больше о сообщениях об ошибках и устранении неполадок.

Подробнее об источниках данных

  • Обновляйте источник данных ежедневно. Мы принимаем новые данные из источника раз в сутки. Регулярно полностью обновляйте источник данных, чтобы данные о ваших товарах всегда оставались актуальными. Мы не поддерживаем прием данных по определенному расписанию или по требованию.
  • Размещайте источник данных на хостинге. Размещайте свой источник данных на сервере FTP/SFTP или по прямой ссылке HTTP/HTTPS для скачивания. Ссылка должна быть доступна для пользователя-агента. Использование «белых списков» определенных IP-адресов и SSH-ключей не допускается. Если вы используете прямую ссылку для скачивания, запрещается использовать дополнительную навигацию для доступа к файлу. Мы не предоставляем услуги размещения источников данных на хостинге.
  • Максимум 5 миллионов товаров.  Мы можем обработать до 5 миллионов товаров в одном аккаунте. Если ваш источник данных содержит более 5 миллионов позиций, мы обработаем первые 5 миллионов строк.
  • Один бизнес-аккаунт — один источник данных.

Подтверждение права собственности на сайт в Pinterest

Все целевые URL-адреса в источнике данных должны иметь домен, зарегистрированный как подтвержденный сайт в Pinterest. Компания может подтвердить несколько доменов, но каждый из них должен быть связан с одним бизнес-аккаунтом Pinterest. Узнайте, как подтвердить веб-сайт.

Подготовка источника данных

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

Требования к размещению источника данных каталогов

Вы должны предоставить свой собственный хостинг на сервере FTP/SFTP или настроить прямую ссылку HTTP/HTTPS для скачивания. Pinterest не предоставляет хостинг для пользователей. Местоположение источника данных должно быть доступным для пользователя-агента. Использование любых «белых списков» IP-адресов и SSH-ключей не допускается. Если вы используете прямую ссылку HTTP/HTTPS для скачивания, она не должна содержать дополнительных переходов для доступа Pinterest к файлу.

Требования к формату источника данных каталогов

Поддерживаемые форматы:

Советы по форматированию

  • Если вы используете формат .csv, значения будут браться в двойные кавычки, чтобы избежать возможных проблем со считыванием данных.
  • Из-за дополнительного плавающего разделителя (запятой или табуляции) элемент или файл может обработаться неправильно.
  • Убедитесь, что разделители для всех столбцов и строк настроены правильно. В каждой строке должно быть одинаковое количество разделителей.
  • Спецификации для канала должны соответствовать стандартам американского английского языка для обязательных и установленных значений.
  • Источник данных для файлов с разделителями табуляции или запятыми должен содержать простой текст с кодировкой UTF-8 или Latin1.

Требования к данным про товар

Вы должны придерживаться руководства для продавцов. Мы можем удалять товары или аккаунты, которые нарушают это руководство.

Обязательные и дополнительные поля

Существует 7 обязательных полей. Если одно из этих полей отсутствует или неправильно отформатировано, не обработается все содержимое канала.

Обязательные поля:

  • id
  • title
  • description
  • link
  • image_link
  • price
  • availability

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

Обязательные поля

Название столбца Описание Синтаксис / поддерживаемые значения Пример Требование
id

Созданный пользователем уникальный идентификатор, который представляет товар.

Принимаются только символы Юникода.

До 127 символов DS0294-L обязательно
title Название товара. Должно совпадать с названием товара на целевой странице. Содержит подробности о товаре, например цвет и размер. До 500 символов Женская джинсовая рубашка, размер L обязательно
description Описание товара. Это поле не поддерживает HTML. Для оптимальной работы информацию нужно вводить в виде простого текста. До 10 000 символов Повседневная джинсовая рубашка из высококачественной японской джинсовой ткани.  обязательно
link Целевая страница товара. Ссылка должна вести непосредственно к товару и отображать те же данные про него. Не используйте страницы с требованием регистрации и т. д. URL-адрес должен начинаться с http:// или https://  До 511 символов https://www.example.com/cat/womens-clothing/denim-shirt-0294 обязательно
image_link

Ссылка на изображение товара. URL-адрес должен быть доступным для пользователя-агента и содержать правильное изображение. Убедитесь, что при переходе по ссылке не отображаются шаблоны или заполнители изображений. Ссылка должна начинаться с http:// или https://

Запятые должны быть закодированы или удалены, если они являются частью ссылки на изображение. Сейчас мы не можем обрабатывать ссылки на изображения, содержащие запятые.

  https://scene.example.com/image/image.jpg обязательно
price Цена товара. Если цена не указана в долл. США, она должна содержать валюту по стандартам ISO-4217. Если валюта не указана, мы по умолчанию добавляем долл. США. Мы принимаем формат валюты, указанный после числового значения цены с пробелом или без него. Валюта должна соответствовать стандартам ISO-4217. Для цен не принимаются значения 0. Не используйте символы валюты.

<numeric>

<ISO 4217>

24.99 USD
24.99USD
24.99
24.99 GBP
обязательно
availability Наличие товара. Укажите одно из следующих значений: in stock, out of stock, preorder. in stock
out of stock
preorder
in stock обязательно

Дополнительные общие атрибуты

Название столбца Описание Синтаксис / поддерживаемые значения Пример Требование
product_type Категоризация товара на основе пользовательской таксономии. Подкатегории нужно разделять знаком « > ». Знак « > » должен отделяться пробелами. Другие разделители, как запятые или вертикальные линии, не принимаются.

L0 > L1 > L2 > L3 > L4

До 1000 символов

Clothing > Women’s > Shirts > Denim необязательно
additional_image_link

Ссылки на дополнительные изображения для вашего товара. Разделяйте дополнительные изображения запятыми. Советуем брать в кавычки всю строку. Ссылка должна начинаться с 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 Цена товара со скидкой. Значение sale_price должно быть меньше значения price. Валюта должна совпадать с указанной для значения price. Если цена не указана в долл. США, она должна содержать валюту по стандартам ISO-4217. Если валюта не указана, мы по умолчанию добавляем долл. США. Мы принимаем формат валюты, указанный после числового значения цены с пробелом или без него. Мы не принимаем значения 0. Не используйте символы валюты.

<numeric>

<ISO 4217>

14.99 USD
14.99USD
14.99
14.99 GBP
необязательно

Дополнительный идентификатор товара

Название столбца Описание Синтаксис / поддерживаемые значения Пример Требование
item_group_id Начальный идентификатор товара.  До 127 символов DS0294 обязательно для товаров в нескольких вариациях

brand

Бренд товара.   Josie’s Denim необязательно
gtin Уникальный универсальный идентификатор товара. Цифровое значение 3234567890126 необязательно
mpn Номер детали производителя — это буквенно-цифровой код, созданный производителем для обозначения своего товара.  Буквенно-цифровой «mpn»:
«PI12345NTEREST»
необязательно

Дополнительные характеристики товара

Название столбца Описание Синтаксис / поддерживаемые значения Пример Требование

color

Основной цвет товара   blue необязательно
gender Пол пользователей товара. Укажите одно из следующих значений: male, female, unisex male
female
unisex
female необязательно
age_group Возрастная категория пользователей товара. Укажите одно из следующих значений: newborn, infant, toddler, kids, adult newborn
infant
toddler
kids
adult
adult необязательно
material Материал, из которого изготовлен товар.   cotton необязательно
pattern Описание узора товара.   plaid необязательно
size Размер товара.   M необязательно
size_type Дополнительное описание размера. Укажите одно из следующих значений: regular, petite, plus, big_and_tall, maternity regular
petite
plus
big_and_tall
maternity
regular необязательно
size_system Таблица размеров для страны, в которой заказан товар. Код страны

US
UK

необязательно

Дополнительные данные о налогах и доставке

Название столбца Описание Синтаксис / поддерживаемые значения Пример Требование
tax Каждая группа атрибутов tax может состоять из 4 субатрибутов: country:region:rate (required):tax_ship
Все двоеточия обязательны даже для пустых значений.
country:region:rate(required):tax_ship US:1025433:6.00:y необязательно
shipping Каждая группа атрибутов delivery может состоять из 4 субатрибутов: country, region, service и price (required).
Все двоеточия обязательны даже для пустых значений.
country:region:service:price(required)

US:CA:Ground:0 USD

US::Express:13.12

необязательно

shipping_weight

Вес товара. Между числом и единицей измерения должен стоять пробел. <число> <единица измерения> 3 kg
5 lbs
необязательно
shipping_width Ширина упаковки для доставки товара. Между числом и единицей измерения должен стоять пробел. <число> <единица измерения> 16 in необязательно
shipping_height Высота упаковки для доставки товара. Между числом и единицей измерения должен стоять пробел. <число> <единица измерения> 12 in необязательно

Дополнительная маркировка товара для взрослых

Название столбца Описание Синтаксис / поддерживаемые значения Пример Требование
adult Если ваш товар предназначен для взрослых, установите для этого атрибута значение TRUE. Эти товары не будут отображаться в Pinterest. TRUE
FALSE
true необязательно

Дополнительные специальные метки

Персонализированная группировка товаров. Группировать товары можно для разных целей: например, сезонные предложения, акции или хиты продаж. Мы принимаем до 5 разных специальных меток.

С их помощью можно создавать группы товаров в каталогах.

Название столбца Описание Синтаксис / поддерживаемые значения Пример Требование
custom_label_0 Персонализированная группировка товаров. До 1000 символов

Хиты продаж

Летняя акция

необязательно
custom_label_1 Персонализированная группировка товаров. До 1000 символов   необязательно
custom_label_2 Персонализированная группировка товаров. До 1000 символов   необязательно
custom_label_3 Персонализированная группировка товаров. До 1000 символов   необязательно
custom_label_4 Персонализированная группировка товаров. До 1000 символов   необязательно

Дополнительные поля для товарных объявлений

Название столбца Описание Синтаксис / поддерживаемые значения Пример Требование
ad_link Рекламодатели могут указывать отдельный URL-адрес, который можно использовать для отслеживания трафика, приходящего с товарных объявлений Pinterest. Необходимо отправить полный URL-адрес отслеживания, а не параметры. В настоящее время отслеживание показов не поддерживается. Ссылка должна начинаться с http:// или https:// строка URL https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest необязательно
condition Состояние товара. Укажите одно из следующих значений: new, used, refurbished. new
used
refurbished
new необязательно
google_product_category Категоризация товаров на основе стандартизированной таксономии товаров в Google. Это установленная таксономия. Принимаются текстовые значения и цифровые коды. Полная таксономия Apparel & Accessories > Clothing > Shirts & Tops
212
необязательно

 

Required and optional fields

There are 7 required fields. If any of these fields are missing, or are not properly formatted, your entire feed will fail ingestion.

Required fields:

  • id
  • title
  • description
  • link
  • image_link
  • price
  • availability

There are also optional fields you can add to help Pinterest better map your products to Pinners. The more information you provide, the more relevant your Pins will be to the Pinners who see them. We strongly recommend adding our optional fields as well to add more detail to your feed and improve relevancy.

Required fields

Column name Description Syntax/supported values Example Requirement
id

The user-created unique ID that represents the product.

Only Unicode characters are accepted.

Max 127 characters DS0294-L required
title The name of the product. Must be the same name as the product from the landing page. Include the variant details, such as color and size. Max 500 characters Women’s denim shirt, large required
description Description of the product. This field does not support HTML and must be in plain text for optimal experience. Max 10,000 characters Casual fit denim shirt made with the finest quality Japanese denim.  required
link The landing page for the product. The link must lead directly to the same product and showcase the same data. We recommend against hardwalls. The URL must start with http:// or https://  Max 511 characters https://www.example.com/cat/womens-clothing/denim-shirt-0294 required
image_link

The link to the product image. The URL must be accessible by a user-agent, and send the accurate image. Please make sure there are no template or placeholder images at the link. Must start with http:// or https://

Commas must be encoded or removed if they are part of the image link, as currently we are unable to process image links containing commas.

  https://scene.example.com/image/image.jpg required
price The price of the product. The price should include currency in ISO-4217 if it is not US dollars. If the currency is not included, we default to US dollars. We accept currency after the numeric price value, with or without space. Currency should follow the standard ISO-4217 code. We do not accept 0 values for price. Do not use currency symbols.

<numeric>

<ISO 4217>

24.99 USD
24.99USD
24.99
24.99 GBP
required
availability The availability of the product. Must be one of the following values: ‘in stock’, ‘out of stock’, ‘preorder’. in stock
out of stock
preorder
in stock required

Optional general attributes

Column name Description Syntax/supported values Example Requirement
product_type The categorization of your product based on your custom product taxonomy. Subcategories must be sent separated by “ > “. The > must be wrapped by spaces. We do not recognize any other delimiters such as comma or pipe.

L0 > L1 > L2 > L3 > L4

Max 1000 characters

Clothing > Women’s > Shirts > Denim optional
additional_image_link

The links to additional images for your product. Separate each additional image with comma. We recommend enclosing the whole string with quotes. Must begin with http:// or https://

Commas must be encoded or removed if they are part of the image link, as currently we are unable to process image links containing commas.
 

We will create a new pin for every additional image link sent.

  "https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg" optional
mobile_link The mobile-optimized version of your landing page. Must begin with http:// or https://   https://m.example.com/cat/womens-clothing/denim-shirt-0294 optional
sale_price The discounted price of the product. The sale_price must be lower than the price. Include currency in the same setup as price. It should include currency in ISO-4217 if it is not US dollars. If the currency is not included, we default to US dollars. We accept currency after the numeric price value, with or without space. We do not accept 0 values. Do not use currency symbols.

<numeric>

<ISO 4217>

14.99 USD
14.99USD
14.99
14.99 GBP
optional

Optional product identifier

Column name Description Syntax/supported values Example Requirement
item_group_id The parent ID of the product.  Max 127 characters DS0294 required for items with multiple variants

brand

The brand of the product.   Josie’s Denim optional
gtin The unique universal product identifier. Numeric 3234567890126 optional
mpn Manufacturer Part Number are alpha-numeric codes created by the manufacturer of a product to uniquely identify it among all products from the same manufacturer.  Alphanumeric "mpn":
"PI12345NTEREST"
optional

Optional product characteristics

Column name Description Syntax/supported values Example Requirement

color

The primary color of the product   blue optional
gender The gender associated with the product. Must be one of the following values if sent: ‘male’, ‘female’, ‘unisex’ male
female
unisex
female optional
age_group The age group to apply a demographic range to the product. Must be the one of the following values: ‘newborn’, ‘infant’, ‘toddler’, ‘kids’, ‘adult’ newborn
infant
toddler
kids
adult
adult optional
material The material used to make the product.   cotton optional
pattern Description of the pattern used for the product.   plaid optional
size The size of the product.   M optional
size_type Additional description for the size. Must be one of the following values if sent: ‘regular’, ‘petite’, ‘plus’, ‘big_and_tall’, ‘maternity’ regular
petite
plus
big_and_tall
maternity
regular optional
size_system Indicates the country’s sizing system in which you are submitting your product. Country code

US
UK

optional

Optional tax and shipping data

Column name Description Syntax/supported values Example Requirement
tax Each tax attribute group can consist of 4 sub-attributes: country:region:rate (required):tax_ship
All colons, even for blank values, are required.
country:region:rate(required):tax_ship US:1025433:6.00:y optional
shipping Each delivery attribute group can consist of 4 sub-attributes: country, region, service, and price (required).
All colons, even for blank values, are required.
country:region:service:price(required)

US:CA:Ground:0 USD

US::Express:13.12

optional

shipping_weight

The weight of the product. Ensure there is a space between the numeric string and the metric. <numeric> <metric> 3 kg
5 lbs
optional
shipping_width The width of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. <numeric> <metric> 16 in optional
shipping_height The height of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. <numeric> <metric> 12 in optional

Optional adult product flag

Column name Description Syntax/supported values Example Requirement
adult Set this attribute to TRUE if you are submitting items that are considered “adult”. These will not be shown on Pinterest. TRUE
FALSE
true optional

Optional custom labels

Custom grouping of products. These can be used for a variety of purposes such as seasonal, promotions, best sellers. We accept up to 5 different custom labels.

You will be able to create product groups in Catalogs using custom labels.

Column name Description Syntax/supported values Example Requirement
custom_label_0 Custom grouping of products. Max 1000 characters

Best sellers

Summer promotion

optional
custom_label_1 Custom grouping of products. Max 1000 characters   optional
custom_label_2 Custom grouping of products. Max 1000 characters   optional
custom_label_3 Custom grouping of products. Max 1000 characters   optional
custom_label_4 Custom grouping of products. Max 1000 characters   optional

Optional shopping ad fields

Column name Description Syntax/supported values Example Requirement
ad_link Allows advertisers to specify a separate URL that can be used to track traffic coming from Pinterest shopping ads. Must send full URL including tracking, do not send tracking parameters only. At this time we do not support impression tracking. Must begin with http:// or https:// string URL https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest optional
condition The condition of the product. Must be one of the following values: ‘new’, ‘used’, ‘refurbished’. new
used
refurbished
new optional
google_product_category The categorization of the product based on the standardized Google Product Taxonomy. This is a set taxonomy. Both the text values and numeric codes are accepted. Full taxonomy Apparel & Accessories > Clothing > Shirts & Tops
212
optional

 

Настройка тега Pinterest

Тег Pinterest — это фрагмент кода JavaScript, который вы размещаете на своем веб-сайте для сбора информации о конверсии, а также формирования целевой аудитории на основании действий, которые пользователи совершают на вашем сайте.

Делитесь необходимыми данными для рекламных объявлений через тег Pinterest.

  • Тег Pinterest нужно применять для таких типов конверсии: PageVisits, AddToCart и Checkouts
  • Данные событий для product_id необходимо передавать как атрибут PageVisit, AddToCart и Checkouts
    • Атрибут product_id должен быть указан под соответствующим элементом (не будет отображаться на странице просмотра конверсий).
    • Используйте расширение Tag Helper для Chrome, чтобы проверить, указаны ли номера продуктов на страницах сведений о них.
  • Указанные в теге данные product_id должны совпадать со значениями item_group_id или id, указанными в источнике данных.
  • Минимум 100 тыс. событий PageVisit и AddtoCart суммарно за последние 7 дней с указанными идентификаторами товаров.
     

Что дальше?

Просмотрите наше руководство по приему данных из источника и узнайте, как подключить свой канал товаров к Pinterest.

Все еще нужна помощь?
Контакты