Antes de começar a usar a ferramenta Catálogos

Parece que você está visualizando isso de uma região onde os  Catálogos ainda não estão disponíveis. Veja onde os Catálogos estão disponíveis para contas do Pinterest Business.

Saiba mais

Conclua estas etapas para começar a configurar a ferramenta Catálogos. Clique no link abaixo para ir para a seção necessária:

A ferramenta Catálogos é para você?

Catálogos é uma ferramenta de ingestão de feed desenvolvida para empresas que vendem produtos em seus sites. Para usar a ferramenta Catálogos, você precisa de:

  • Uma conta business do Pinterest
  • Uma fonte de dados: um arquivo que contém uma lista dos seus produtos e seus atributos correspondentes, também chamada de catálogo de produtos ou feed de produtos
  • Um site reivindicado
  • Um site que siga nossas Diretrizes para Comerciantes, com uma política de frete, uma política de reembolso e dados de contato claramente visíveis e fáceis de encontrar
  • Hospedagem de fonte de dados: uma maneira de hospedar e armazenar consistentemente uma fonte de dados dos seus produtos que você pode enviar diariamente para o Pinterest

Se você não satisfaz essas condições e quer criar Pins de compras, pode fazer uma parceria com um site de comércio eletrônico para formatar seus produtos para o Pinterest. Até agora, temos integrações com o GoDataFeed e o Productsup. Você também pode patrocinar seu conteúdo de outras maneiras no Pinterest.

Visão geral da fonte de dados

O que é uma fonte de dados?

Uma fonte de dados (também conhecida como catálogo de produtos, feed de produtos ou feed de dados) é um arquivo com uma lista dos seus produtos e seus atributos correspondentes estruturados de uma maneira específica. Esse arquivo é processado diariamente para criar Pins dos seus produtos de forma dinâmica.

Como uma fonte de dados funciona

Para enviar uma fonte de dados ao Pinterest, você fornece um link para uma URL onde podemos acessar o seu arquivo de fonte de dados. Validaremos o arquivo e criaremos um Pin de produto para cada item que passar na nossa validação. Veja mais sobre Especificações da fonte de dados.

Manutenção de uma fonte de dados

A hospedagem de uma fonte de dados inicia um esforço contínuo para fornecer informações atualizadas sobre os produtos disponíveis. O Pinterest fará a ingestão da sua fonte de dados diariamente e alertará você sobre erros. É importante verificar e corrigir os erros o mais rápido possível para garantir que as informações dos seus produtos sejam precisas e atualizadas.

Dependendo do tipo de erro, ele poderá impedir a atualização do feed inteiro, alguns itens do feed poderão não ser atualizados ou você precisará fazer algumas alterações para se alinhar às práticas recomendadas. Saiba mais sobre solução de problemas de mensagens de erro.

Mais sobre fontes de dados:

  • Atualize diariamente. Fazemos a ingestão da sua fonte de dados uma vez a cada 24 horas. Disponibilize sua fonte de dados completa e atualizada diariamente para manter os detalhes do produto atualizados. Não oferecemos a possibilidade de programar ou de fazer a ingestão sob demanda.
  • Hospede sua fonte de dados. Hospede sua própria fonte de dados em um servidor FTP/SFTP ou com um link de download direto HTTP/HTTPS. Ela precisa ser acessível por um agente do usuário e não pode exigir uma lista de permissões de chaves IP ou SSH. Se você estiver usando um link de download direto, não poderá haver nenhuma navegação extra necessária para o Pinterest acessar o arquivo. Não fornecemos hospedagem de fontes de dados.
  • Máximo de 5 milhões de produtos. Podemos processar até 5 milhões de produtos por conta. Se sua fonte de dados tiver mais do que isso, processaremos os primeiros 5 milhões de linhas.
  • Uma única fonte de dados por conta business.

Tenha um site reivindicado no Pinterest

Todas as URLs de destino na sua fonte de dados devem ter um domínio da Web registrado como um site reivindicado no Pinterest. Uma empresa pode conectar vários domínios, mas cada domínio só pode ser conectado a uma única conta business do Pinterest. Saiba como reivindicar o seu site.

Prepare sua fonte de dados

Antes de configurar seu feed, é necessário criar uma fonte de dados, ou seja, um arquivo que contém uma lista dos seus produtos e seus atributos correspondentes.

Requisitos de hospedagem da fonte de dados para a ferramenta Catálogos

Você deve fornecer sua própria hospedagem em um servidor FTP/SFTP ou configurar um link HTTP/HTTPS de download direto. O Pinterest não oferece hospedagem para usuários. A localização da sua fonte de dados deve ser acessível por um usuário agente e não exigir nenhuma lista de permissões de chave IP ou SSH. Se você estiver usando um link de download direto na forma de HTTP/HTTP, este não deverá ter nenhuma navegação adicional necessária para o Pinterest acessar o arquivo.

Requisitos de formato da fonte de dados para a ferramenta Catálogos

Formatos aceitos:

Dicas de formatação:

  • Se você está usando um arquivo csv, incluímos seus valores entre aspas duplas para evitar possíveis problemas de análise
  • Um delimitador flutuante adicional (vírgula, tabulação) pode fazer com que o item ou o arquivo não seja processado corretamente
  • Verifique se os delimitadores de todas as suas colunas e linhas estão configurados corretamente, conferindo se você tem o mesmo número de delimitadores em cada linha.
  • As especificações para o feed devem seguir o inglês americano padronizado para os valores necessários e definidos.
  • Para arquivos delimitados por tabulação ou por vírgula, o arquivo da fonte de dados deve conter texto sem formatação, codificado em UTF-8 ou Latin1.

Requisitos de dados do produto

Siga nossas Diretrizes para Comerciantes. Podemos remover produtos ou contas que violem essas diretrizes.

Campos obrigatórios e opcionais

Existem sete campos obrigatórios. Se algum desses campos estiver ausente ou não estiver formatado corretamente, ocorrerá uma falha na ingestão do seu feed inteiro.

Campos obrigatórios:

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

Também existem campos opcionais que você pode adicionar para ajudar o Pinterest a mapear melhor seus produtos para os usuários. Quanto mais informações você fornecer, mais relevantes serão seus Pins para as pessoas que os visualizarem. É altamente recomendável adicionar nossos campos opcionais para incluir mais detalhes no seu feed e melhorar a relevância.

Campos obrigatórios

Nome da coluna Descrição Sintaxe/valores aceitos Exemplo Requisito
id

A identificação exclusiva criada pelo usuário que representa o produto.

Somente caracteres unicode são aceitos.

Máximo de 127 caracteres DS0294-L obrigatório
title O nome do produto. Deve ser igual ao nome do produto da página de destino. Inclua os detalhes da variante, como cor e tamanho. Máximo de 500 caracteres Camisa jeans feminina, grande obrigatório
description Descrição do produto. Este campo não aceita HTML e deve estar em texto simples para proporcionar uma experiência ideal. Máximo de 10 mil caracteres Camisa jeans casual, feita com jeans japonês da melhor qualidade. obrigatório
link A página de destino do produto. O link deve levar diretamente ao mesmo produto e mostrar os mesmos dados. Não recomendamos páginas de cadastramento do usuário. A URL deve começar com http:// ou https:// Máximo de 511 caracteres https://www.example.com/cat/womens-clothing/denim-shirt-0294 obrigatório
image_link

O link para a imagem do produto. A URL deve ser acessível por um usuário agente e enviar a imagem precisa. Não deve haver imagens de modelo ou temporárias no link. Deve começar com http:// ou https://

As vírgulas devem ser codificadas ou removidas se fizerem parte do link da imagem, pois atualmente não é possível processar links de imagem que contenham vírgulas.

  https://scene.example.com/image/image.jpg obrigatório
price O preço do produto. O preço deverá incluir a moeda na norma ISO-4217 se não estiver em dólares americanos. Se a moeda não estiver incluída, o padrão utilizado é o dólar americano. Aceitamos que a moeda seja incluída após o valor numérico do preço, com ou sem espaço. A moeda deve seguir o código da norma ISO-4217. O valor de 0 não é aceito para o preço. Não use símbolos de moeda.

<numeric>

<ISO 4217>

24,99 USD
24,99USD
24,99
24,99 GBP
obrigatório
availability A disponibilidade do produto. Deve ser um dos seguintes valores: "in stock" (em estoque), "out of stock" (esgotado), "preorder" (reserva). in stock
out of stock
preorder
in stock obrigatório

Atributos gerais opcionais

Nome da coluna Descrição Sintaxe/valores aceitos Exemplo Requisito
product_type A categorização do seu produto com base na sua taxonomia de produto personalizada. Subcategorias devem ser enviadas separadas por ">". O ">" deve estar entre espaços. Nenhum outro delimitador (por exemplo, vírgulas ou barras verticais) é reconhecido.

L0 > L1 > L2 > L3 > L4

Máximo de mil caracteres

Roupas > Feminino > Camisas > Jeans opcional
additional_image_link

Os links para imagens adicionais do seu produto. Separe cada imagem adicional com vírgula. Recomendamos colocar toda a cadeia de caracteres entre aspas. Deve começar com http:// ou https://

As vírgulas devem ser codificadas ou removidas se fizerem parte do link da imagem, pois atualmente não é possível processar links de imagem que contenham vírgulas.
 

Criaremos um novo Pin para cada link de imagem adicional enviado.

  "https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg" opcional
mobile_link A versão da sua página de destino otimizada para dispositivos móveis. Deve começar com http:// ou https://   https://m.example.com/cat/womens-clothing/denim-shirt-0294 opcional
sale_price O preço do produto com desconto. O sale_price deve ser inferior ao preço. Inclua a moeda na mesma configuração do preço. Deverá incluir a moeda na norma ISO-4217 se não estiver em dólares americanos. Se a moeda não estiver incluída, o padrão utilizado é o dólar americano. Aceitamos que a moeda seja incluída após o valor numérico do preço, com ou sem espaço. O valor de 0 não é aceito para o preço. Não use símbolos de moeda.

<numeric>

<ISO 4217>

14,99 USD
14,99USD
14,99
14,99 GBP
opcional

Identificador de produto opcional

Nome da coluna Descrição Sintaxe/valores aceitos Exemplo Requisito
item_group_id A identificação principal do produto. Máximo de 127 caracteres DS0294 obrigatório para itens com múltiplas variantes

brand

A marca do produto.   Jeans by Josie opcional
gtin O identificador de produto universal exclusivo. Numérico 3234567890126 opcional
mpn O número da peça do fabricante é um código alfanumérico criado pelo fabricante de um produto para identificá-lo de maneira exclusiva entre todos os produtos do mesmo fabricante. Alfanumérico "mpn":
"PI12345NTEREST"
opcional

Características opcionais do produto

Nome da coluna Descrição Sintaxe/valores aceitos Exemplo Requisito

color

A cor principal do produto.   azul opcional
gender O gênero associado ao produto. Deve ser um dos seguintes valores, se enviado: "male" (masculino), "female" (feminino), "unisex" (unissex) male
female
unisex
female opcional
age_group O grupo etário para aplicar um intervalo demográfico ao produto. Deve ser um dos seguintes valores: "newborn" (recém-nascido), "infant" (bebê), "toddler" (infantil), "kids" (criança), "adult" (adulto) newborn
infant
toddler
kids
adult
adult opcional
material O material usado para confeccionar o produto.   algodão opcional
pattern Descrição da estampa usada para o produto.   xadrez opcional
size O tamanho do produto.   M opcional
size_type Descrição adicional do tamanho. Deve ser um dos seguintes valores se enviado: "regular", "petite", "plus", "big_and_tall", "maternity" regular
petite
plus
big_and_tall
maternity
regular opcional
size_system Indica o sistema de tamanho do país no qual você está enviando seu produto. Código do país

US
UK

opcional

Dados opcionais de impostos e envio

Nome da coluna Descrição Sintaxe/valores aceitos Exemplo Requisito
tax Cada grupo de atributos de imposto pode ser composto por quatro subatributos: country:region:rate(obrigatório):tax_ship
Todos os dois-pontos, mesmo para valores em branco, são obrigatórios.
country:region:rate(required):tax_ship US:1025433:6.00:y opcional
shipping Cada grupo de atributos de entrega pode ser composto por quatro subatributos: region, service e price (obrigatório).
Todos os dois-pontos, mesmo para valores em branco, são obrigatórios.
country:region:service:price(required)

US:CA:Ground:0 USD

US::Express:13.12

opcional

shipping_weight

O peso do produto. Deve haver um espaço entre a cadeia de caracteres numérica e a métrica. <numeric> <metric> 3 kg
5 lbs
opcional
shipping_width A largura do pacote necessário para enviar o produto. Deve haver um espaço entre a cadeia de caracteres numérica e a métrica. <numeric> <metric> 16 pol opcional
shipping_height A altura do pacote necessário para enviar o produto. Deve haver um espaço entre a cadeia de caracteres numérica e a métrica. <numeric> <metric> 12 pol opcional

Sinalizador de produto adulto opcional

Nome da coluna Descrição Sintaxe/valores aceitos Exemplo Requisito
adult Defina este atributo como TRUE se estiver enviando itens considerados "adultos". Estes não serão exibidos no Pinterest. TRUE
FALSE
true opcional

Rótulos personalizados opcionais

Agrupamento personalizado de produtos. Eles podem ser usados com vários propósitos, como sazonal, promoções, mais vendidos. Aceitamos até 5 rótulos personalizados diferentes.

Você poderá criar grupos de produtos na ferramenta Catálogos usando rótulos personalizados.

Nome da coluna Descrição Sintaxe/valores aceitos Exemplo Requisito
custom_label_0 Agrupamento personalizado de produtos. Máximo de mil caracteres

Mais vendidos

Promoção de verão

opcional
custom_label_1 Agrupamento personalizado de produtos. Máximo de mil caracteres   opcional
custom_label_2 Agrupamento personalizado de produtos. Máximo de mil caracteres   opcional
custom_label_3 Agrupamento personalizado de produtos. Máximo de mil caracteres   opcional
custom_label_4 Agrupamento personalizado de produtos. Máximo de mil caracteres   opcional

Campos opcionais de anúncio de compras

Nome da coluna Descrição Sintaxe/valores aceitos Exemplo Requisito
ad_link Permite que os anunciantes especifiquem uma URL separada que pode ser usada para rastrear o tráfego proveniente dos anúncios de compras do Pinterest. É necessário enviar a URL completa, incluindo o rastreamento. Não envie apenas parâmetros de rastreamento. No momento, não oferecemos suporte para rastreamento de impressões. Deve começar com http:// ou https:// URL da string https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest opcional
condition A condição do produto. Deve ser um dos seguintes valores: "new" (novo), "used" (usado), "refurbished" (recondicionado). new
used
refurbished
new opcional
google_product_category A categorização do produto com base na taxonomia do produto do Google padronizada. Esta é uma taxonomia definida. São aceitos valores de texto e códigos numéricos. Taxonomia completa Vestuário e acessórios > Roupas > Camisas e blusas
212
opcional

 

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

 

Configurar a tag do Pinterest

A tag do Pinterest é um trecho de código JavaScript que você coloca no seu site para reunir informações de conversão e definir públicos-alvo com base nas ações que eles realizam no seu site.

Lembre-se de enviar campos específicos de compras por meio da tag do Pinterest.

  • É necessário ter a tag do Pinterest implementada com os seguintes tipos de conversão: PageVisits, AddToCart e Checkouts
  • É necessário passar os dados do evento para "product_id" como um atributo para PageVisit, AddToCart e Checkouts
    • O product_id deve passar sob um item de linha (não estará visível na página de visualização de Conversões).
    • Use a extensão do Chrome Pinterest Tag Helper para se certificar de que você tem IDs de produtos retornando nas páginas de detalhes do produto.
  • Os dados de product_id passados na tag devem corresponder ao "item_group_id" ou "id" fornecido na fonte de dados
  • Mínimo de cem mil eventos PageVisit e AddtoCart combinados nos últimos 7 dias retornando IDs de produtos
     

Qual é o próximo passo?

Consulte o nosso guia de ingestão da fonte de dados para saber como conectar seu feed de produtos ao Pinterest.

Ainda precisa de ajuda?
Fale conosco