Primi passi con Cataloghi

Sembra che tu stia visualizzando l'elemento da un'area geografica in cui Cataloghi non è ancora disponibile. Scopri dove è disponibile Cataloghi per gli account di Pinterest Business.

Ulteriori informazioni

Prima di configurare Cataloghi, dovrai completare questi passaggi. Fai clic su uno dei link qui sotto per passare alla sezione desiderata:

Cataloghi fa per te?

Cataloghi è uno strumento di creazione feed sviluppato per le aziende che vendono prodotti sui loro siti web. Per utilizzare Cataloghi sono necessari:

  • Un account per aziende Pinterest
  • Una fonte dati, ovvero un file che contiene un elenco di prodotti con i relativi attributi; viene chiamato anche catalogo prodotti o feed prodotti
  • Un sito web verificato
  • Un sito web che rispetta le nostre Linee guida per commercianti, con dati di contatto e una politica di spedizione/rimborso chiari e facili da trovare
  • Hosting della fonte dati, ovvero un modo per ospitare e archiviare una fonte dati dei prodotti che puoi inviare a Pinterest ogni giorno.

Se non soddisfi questi requisiti, ma desideri comunque creare Pin per gli acquisti, puoi iniziare una collaborazione con un sito web di e-commerce per formattare i tuoi prodotti per Pinterest. Al momento, disponiamo delle integrazioni con GoDataFeed e Productsup. Puoi anche promuovere i tuoi contenuti in altri modi su Pinterest.

Panoramica sulla fonte dei dati

Cos'è una fonte dei dati?

Una fonte dati (chiamata anche catalogo prodotti, feed prodotti o data feed) è un file contenente un elenco di prodotti con i relativi attributi strutturati in maniera specifica. Questo file viene elaborato giornalmente per creare Pin in modo dinamico dai tuoi prodotti.

Come funziona una fonte dati

Per inviare una fonte dati a Pinterest, forniscici un link URL per accedere al file. Convalideremo il file e creeremo un Pin prodotto per ogni elemento convalidato. Ulteriori informazioni sulle Specifiche della fonte dati.

Mantenimento di una fonte dati

L'hosting di una fonte dati consente di ricevere continuamente informazioni aggiornate sui prodotti disponibili. Pinterest creerà giornalmente la fonte dati e ti avviserà di eventuali errori. È importante rivedere e correggere gli errori il più rapidamente possibile per garantire che le informazioni sul prodotto siano accurate e aggiornate.

In base al tipo di errore, il feed e alcuni elementi del feed potrebbero non aggiornarsi o potrebbe essere necessario apportare alcune modifiche per allinearsi alle best practice. Ulteriori informazioni sui messaggi di errore per la risoluzione dei problemi.

Maggiori informazioni sulle fonti dati:

  • Aggiorna quotidianamente. Creiamo la tua fonte dati ogni 24 ore. Rendi disponibile la tua fonte dati aggiornata ogni giorno affinché i dettagli prodotto siano aggiornati. Non supportiamo la pianificazione o la creazione on demand.
  • Fornisci un host della tua fonte dati. Fornisci un host della tua fonte dati su un server FTP/SFTO o con un link HTTP/HTTPS per il download diretto. Questo deve essere accessibile da uno user-agent e non richiedere whitelisting di IP o chiavi SSH. Se utilizzi un link per il download diretto, non deve presentare richieste di ulteriore navigazione per consentire a Pinterest di accedere al file. Non forniamo un host della fonte dati.
  • Massimo 5 milioni di prodotti.  Possiamo elaborare fino a 5 milioni di prodotti per account. Se la tua fonte dati ha più di 5 milioni di prodotti, elaboreremo le prime 5 milioni di righe.
  • Una fonte dati per account aziendale.

Aggiungi un sito web verificato su Pinterest

Tutti gli URL di destinazione nella fonte dei dati devono avere un dominio web registrato come sito web verificato su Pinterest. Un'azienda può verificare più domini, ma ciascun dominio può essere verificato solo da un singolo account per aziende Pinterest. Scopri come verificare il tuo sito web.

Prepara la fonte dei dati

Prima di configurare il tuo feed, devi creare una fonte dati, ovvero un file che contiene un elenco di prodotti con i relativi attributi.

Requisiti per l'hosting della fonte dati dei Cataloghi

È necessario fornire un hosting di proprietà su un server FTP/SFTP o creare un link HTTP/HTTPS per il download diretto. Pinterest non fornisce hosting agli utenti. La posizione della fonte dati deve essere accessibile a uno user-agent e non richiedere alcun whitelisting di IP o chiavi SSH. Se utilizzi un link per il download diretto sotto forma di HTTP/HTTPS, il link non deve presentare richieste di ulteriore navigazione per consentire a Pinterest di accedere al file.

Requisiti per il formato della fonte dati dei Cataloghi

Formati supportati:

Suggerimenti per la formattazione:

  • Se utilizzi un file csv, racchiuderemo tutti i valori tra virgolette per evitare qualsiasi problema di parsing
  • Altri delimitatori mobili (virgola, tabulazione) possono impedire la corretta elaborazione dell'articolo o del file
  • Assicurati che i delimitatori delle colonne e delle righe siano impostati correttamente verificando di avere lo stesso numero di delimitatori in tutte le righe.
  • Le specifiche del feed devono seguire l'inglese americano standard per i valori richiesti e impostati.
  • Per i file delimitati da tabulazioni o virgole, il file della fonte dati deve essere in puro formato testuale, codifica UTF-8 o Latin1.

Requisiti dei dati prodotto

Accertati di seguire le nostre Linee guida per commercianti. Rimuoveremo i prodotti o gli account che violano queste linee guida.

Campi obbligatori e opzionali

Sono previsti 7 campi obbligatori. Se uno di questi campi è mancante o non formattato correttamente, sarà impossibile creare l'intero feed.

Campi obbligatori:

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

Puoi aggiungere anche campi opzionali per aiutare Pinterest a mappare meglio i tuoi prodotti per gli utenti. Più informazioni fornirai, più i tuoi Pin saranno rilevanti per gli utenti che li visualizzano. Ti consigliamo di compilare anche i campi opzionali per aggiungere più dettagli al tuo feed e migliorare la pertinenza.

Campi obbligatori

Nome colonna Descrizione Sintassi/valori supportati Esempio Requisiti
id

L'ID univoco creato dall'utente che rappresenta il prodotto.

Si accettano solo caratteri Unicode.

Massimo 127 caratteri DS0294-L obbligatorio
title Il nome del prodotto. Deve essere lo stesso nome del prodotto della pagina di destinazione. Include dettagli della variante, come colore e taglia. Massimo 500 caratteri Camicia denim donna, large obbligatorio
description Descrizione del prodotto. Per un'esperienza ottimale, questo campo non supporta l'HTML e deve essere in testo semplice. Massimo 10.000 caratteri Camicia di jeans dal taglio casual, realizzata usando tessuto jeans giapponese di ottima qualità.  obbligatorio
link La pagina di destinazione del prodotto. Il link deve condurre direttamente allo stesso prodotto e mostrare gli stessi dati. Consigliamo di non usare gli hardwall. L'URL deve iniziare con http:// o https://  Massimo 511 caratteri https://www.esempio.com/cat/vestiti-da-donna/camicia-jeans-0294 obbligatorio
image_link

Il link all'immagine del prodotto. L'URL deve essere accessibile agli user-agent e inviare l'immagine giusta. Assicurati che al link non siano associate immagini di template o di placeholder. Deve iniziare con http:// o https://

Se parte di un link immagine, le virgole vanno codificate o rimosse perché non siamo attualmente in grado di elaborare link immagine contenenti virgole.

  https://scene.esempio.com/immagine/immagine.jpg obbligatorio
price Il prezzo del prodotto. Se la valuta non è il dollaro statunitense, è necessario includere la valuta secondo gli standard ISO-4217. Qualora la valuta non sia inclusa, il prezzo sarà indicato automaticamente in dollari statunitensi. Accettiamo la valuta dopo il valore numerico, con o senza spazio. Le valute devono seguire il codice standard ISO-4217. Non accettiamo 0 come valore per il prezzo. Non utilizzare simboli di valuta.

<numeric>

<ISO 4217>

24,99 USD
24,99USD
24,99
24,99 GBP
obbligatorio
availability La disponibilità del prodotto Deve indicare uno dei seguenti valori: "in stock", "out of stock", "preorder". in stock
out of stock
preorder
in stock obbligatorio

Attributi generali opzionali

Nome colonna Descrizione Sintassi/valori supportati Esempio Requisiti
product_type La categorizzazione del prodotto in base alla tassonomia dei prodotti. Le sottocategorie devono essere separate da ">". Le > devono essere circondate da spazi. Non riconosciamo come validi altri delimitatori, come virgole o pipe.

L0 > L1 > L2 > L3 > L4

Massimo 1000 caratteri

Abbigliamento > Donna > Camicie > Denim opzionale
additional_image_link

Il link alle immagini aggiuntive del prodotto. Separa ciascuna immagine aggiuntiva con una virgola. Consigliamo di racchiudere l'intera stringa tra apici. Deve iniziare con http:// o https://

Se parte di un link immagine, le virgole vanno codificate o rimosse perché non siamo attualmente in grado di elaborare link immagine contenenti virgole.
 

Creiamo un nuovo Pin per ciascun link immagine aggiuntivo inviato.

  "https://scene.esempio.com/immagine/immagine_v2.jpg, https://scene.esempio.com/immagine/immagine_v3.jpg" opzionale
mobile_link La versione della pagina di destinazione ottimizzata per dispositivi mobili. Deve iniziare con http:// o https://   https://m.example.com/cat/womens-clothing/denim-shirt-0294 opzionale
sale_price Il prezzo scontato del prodotto. Il valore indicato in sale_price deve essere inferiore al prezzo pieno. Includi la valuta secondo le impostazioni indicate per il prezzo. Se la valuta non è il dollaro statunitense, è necessario includere la valuta secondo gli standard ISO-4217. Qualora la valuta non sia inclusa, il prezzo sarà indicato automaticamente in dollari statunitensi. Accettiamo la valuta dopo il valore numerico, con o senza spazio. Non accettiamo 0 come valore. Non utilizzare simboli di valuta.

<numeric>

<ISO 4217>

14,99 USD
14,99USD
14,99
14,99 GBP
opzionale

Identificatori opzionali per il prodotto

Nome colonna Descrizione Sintassi/valori supportati Esempio Requisiti
item_group_id L'ID della famiglia di prodotti.  Massimo 127 caratteri DS0294 Obbligatorio per articoli con più varianti

brand

Il brand del prodotto.   Josie’s Denim opzionale
gtin L'identificatore univoco universale del prodotto. Numerico 3234567890126 opzionale
mpn Il codice componente del produttore è un codice alfanumerico creato dal produttore dell'articolo per identificarlo in maniera univoca tra tutti i suoi prodotti.  Alfanumerico "mpn":
"PI12345NTEREST"
opzionale

Caratteristiche opzionali del prodotto

Nome colonna Descrizione Sintassi/valori supportati Esempio Requisiti

color

Il colore principale del prodotto   blu opzionale
gender Il genere associato al prodotto. Se utilizzato, deve essere uno dei seguenti valori: "male", "female", "unisex" male
female
unisex
female opzionale
age_group La fascia d'età per specificare la fascia demografica a cui si rivolge un prodotto. Deve rientrare tra i seguenti valori: "newborn", "infant", "toddler", "kids", "adult" newborn
infant
toddler
kids
adult
adult opzionale
material Il materiale utilizzato per realizzare il prodotto.   cotone opzionale
pattern Descrizione della fantasia utilizzata per il prodotto.   quadretti opzionale
size La taglia del prodotto.   M opzionale
size_type Ulteriore descrizione della taglia. Se utilizzato, deve essere uno dei seguenti valori: "regular", "petite", "plus", "big_and_tall", "maternity" regular
petite
plus
big_and_tall
maternity
regular opzionale
size_system Indica il sistema di taglie del prodotto inviato. Codice paese

US
UK

opzionale

Dati opzionali su spedizione e dazi

Nome colonna Descrizione Sintassi/valori supportati Esempio Requisiti
tax Ciascun gruppo di attributi fiscali può contenere 4 sottoattributi: country:region:rate (obbligatorio):tax_ship
Sono sempre obbligatori i due punti di separazione, anche per i dati non inseriti.
country:region:rate(required):tax_ship US:1025433:6.00:y opzionale
shipping Ciascun gruppo di attributi di consegna è composto da 4 sottoattributi: country, region, service e price (obbligatorio).
Sono sempre obbligatori i due punti di separazione, anche per i dati non inseriti.
country:region:service:price(obbligatorio)

US:CA:Ground:0 USD

US::Express:13.12

opzionale

shipping_weight

Il peso del prodotto. Assicurati di lasciare uno spazio tra la stringa numerica e quella metrica. <numeric> <metric> 3 kg
5 lb
opzionale
shipping_width La larghezza del pacco del prodotto spedito. Assicurati di lasciare uno spazio tra la stringa numerica e quella metrica. <numeric> <metric> 40 cm opzionale
shipping_height L'altezza del pacco del prodotto spedito. Assicurati di lasciare uno spazio tra la stringa numerica e quella metrica. <numeric> <metric> 30 cm opzionale

Segnalazione opzionale prodotto per adulti

Nome colonna Descrizione Sintassi/valori supportati Esempio Requisiti
adult Imposta questo attributo su TRUE se gli articoli sono considerati "adult". Questi non appariranno su Pinterest. TRUE
FALSE
true opzionale

Etichette personalizzate facoltative

Raggruppamenti personalizzati dei prodotti. Possono essere utilizzati per tantissimi scopi diversi, ad esempio saldi, promozioni, best seller. Si accettano fino a 5 etichette personalizzate diverse.

Usando le etichette personalizzate, potrai creare gruppi prodotti in Cataloghi.

Nome colonna Descrizione Sintassi/valori supportati Esempio Requisiti
custom_label_0 Raggruppamenti personalizzati dei prodotti. Massimo 1000 caratteri

Best seller

Promozione estiva

opzionale
custom_label_1 Raggruppamenti personalizzati dei prodotti. Massimo 1000 caratteri   opzionale
custom_label_2 Raggruppamenti personalizzati dei prodotti. Massimo 1000 caratteri   opzionale
custom_label_3 Raggruppamenti personalizzati dei prodotti. Massimo 1000 caratteri   opzionale
custom_label_4 Raggruppamenti personalizzati dei prodotti. Massimo 1000 caratteri   opzionale

Campi Shopping Ad facoltativi

Nome colonna Descrizione Sintassi/valori supportati Esempio Requisiti
ad_link Consente agli inserzionisti di indicare un URL separato, utilizzabile per monitorare il traffico proveniente dalle inserzioni per lo shopping di Pinterest. Devi inviare l'URL completo, non solo i parametri di tracciamento. Al momento non supportiamo il tracciamento delle impression. Deve iniziare con http:// o https:// URL stringa https://www.esempio.com/cat/camicia-denim/articolo012?utm_source=Pinter… opzionale
condition Le condizioni del prodotto. Deve indicare uno dei seguenti valori: "new", "used", "refurbished". new
used
refurbished
new opzionale
google_product_category La categorizzazione dei prodotti in base alla tassonomia standardizzata dei prodotti di Google. Si tratta di una tassonomia fissa. Sono validi sia i valori testuali sia i codici numerici. Tassonomia completa Abiti e accessori> Abbigliamento> Camicie e top
212
opzionale

 

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

 

Configura il tag di Pinterest

Il tag di Pinterest è un pezzo di codice JavaScript che aggiungi al sito web per raccogliere dati sulle conversioni e costruire un pubblico in base alle azioni che hanno intrapreso sul sito.

Assicurati di inviare campi specifici per gli acquisti con il tag di Pinterest.

  • È necessario aver implementato il tag di Pinterest con i seguenti tipi di conversione: PageVisits, AddToCart e Checkouts 
  • È necessario passare i dati degli eventi di “product_id” come attributo per PageVisit, AddToCart e Checkouts
    • Product_id deve passare sotto un elemento (non sarà visibile nella pagina di visualizzazione Conversioni).
    • Utilizza l'estensione Assistente tag per Chrome per verificare che gli ID prodotto stiano tornando sulle pagine dei dettagli dei prodotti.
  • I dati product_id passati nel tag devono corrispondere ai dati "item_group_id" o "id" forniti nella fonte dei dati
  • Almeno 100K tra eventi PageVisit e AddtoCart che hanno restituito gli ID prodotto negli ultimi 7 giorni
     

Qual è il passaggio successivo?

Consulta la nostra guida Creazione della fonte dati per scoprire come collegare il tuo feed di prodotti a Pinterest.

Hai ancora bisogno di aiuto?
Contattaci