In qualità di commerciante, potresti aver bisogno di caricare i tuoi prodotti su Pinterest come Pin prodotto. I Pin prodotto sono formattati appositamente per far sapere alle persone che navigano su Pinterest che possono essere acquistati. Contengono il titolo e la descrizione del prodotto e le informazioni sui prezzi e sulla disponibilità.
Aggiungi la fonte dati del tuo catalogo retail su Pinterest per caricare più prodotti come Pin prodotto contemporaneamente. Successivamente, puoi promuoverli su Pinterest come Shopping Ad. Puoi decidere di fornire il link URL della fonte dati in hosting oppure caricarla manualmente.
Prima di aggiungere il catalogo retail dovrai:
Se non soddisfi i requisiti indicati sopra,
Il funzionamento dei cataloghi retail dipende dalla modalità di aggiunta della tua fonte dati, dalla quale possiamo accedere al tuo catalogo retail.
Se fornisci il link URL della tua fonte dati in hosting, accederemo quotidianamente alla fonte dati in modo da poter creare Pin prodotto in modo dinamico per ogni prodotto presente nel tuo catalogo retail. Rendi disponibile ogni giorno la fonte dati per mantenere i dettagli prodotto sempre aggiornati. Puoi anche programmare in anticipo la creazione di dati.
Se carichi la fonte dati manualmente, accederemo alla fonte dati durante l'upload e ogni volta che ne carichi una aggiornata, in modo da poter creare Pin prodotto o aggiornare i metadati dei Pin esistenti per ciascun prodotto nel tuo catalogo retail.
Ti avviseremo in caso di errori. È importante rivedere e correggere gli errori il più rapidamente possibile per garantire che le informazioni sul prodotto siano accurate e aggiornate. A causa di un errore, il feed e alcuni articoli del feed potrebbero non aggiornarsi o potrebbe essere necessario apportare alcune modifiche alla formattazione.
Possiamo elaborare fino a 20 milioni di prodotti per catalogo retail. Se hai più di 20 milioni di prodotti,
Consulta questa sezione solo se hai la fonte dati in hosting. Se effettui il caricamento manuale della tua fonte dati, puoi saltarla.
Dovrai ospitare la tua fonte dati su un server FTP/SFTP/WebDAV o tramite 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, questo non deve presentare richieste di ulteriore navigazione, altrimenti non saremo in grado di accedere al file.
Supportiamo i seguenti formati:
Valori separati da tabulazione (Tab-separated values, TSV) | (Scarica il modello TSV) |
Valori separati da virgola (Comma-separated values, CSV) | (Scarica il modello CSV) |
XML (RSS 2.0, ATOM 1.0) | (Scarica il modello XML) |
Nota: accettiamo file zippati (.zip, .giz, .gz, .bz2 e altri), ma attualmente non supportiamo i file crittografati, protetti da password e compressi né i file di Google Drive o di Dropbox.
Il tuo catalogo retail deve includere i campi seguenti, formattati esattamente secondo le indicazioni di seguito. Se i campi non vengono inseriti o sono formattati in modo errato, sarà impossibile creare l'intero catalogo retail.
Nome colonna | Descrizione | Sintassi/valori supportati | Esempio |
---|---|---|---|
id |
L'ID univoco che rappresenta il prodotto. |
Massimo 127 caratteri. | DS0294-L |
title | Il nome del prodotto (lo stesso nome del prodotto della pagina di destinazione, inclusi i dettagli delle varianti come colore e taglia). | Massimo 500 caratteri. | Camicia denim donna, large |
description | Descrizione del prodotto. | Massimo 10.000 caratteri in formato di solo testo (non HTML). | Camicia di jeans dal fit casual realizzata utilizzando denim giapponese della miglior qualità |
link | La pagina di destinazione del prodotto (il link deve essere indirizzato direttamente allo stesso prodotto e mostrare gli stessi dati). |
Stringa URL. Massimo 511 caratteri. L'URL deve iniziare con http:// (sconsigliamo di usare gli hardwall). |
|
image_link |
Link all'immagine principale del prodotto (deve avere dimensioni minime di 75 x 75 pixel, essere accessibile dal nostro user-agent e non includere immagini di template o immagini segnaposto). Se modifichi l'immagine in un secondo momento, dovrai utilizzare un link diverso, altrimenti non verrà aggiornata. |
Stringa URL. Massimo 2.000 caratteri. Il link deve iniziare con http:// o https:// (codifica o rimuovi le virgole). Suggerimento: racchiudi la stringa tra apici. |
|
price |
Il prezzo del prodotto (deve corrispondere al costo effettivo del prodotto e, se la valuta non è il dollaro statunitense, deve includere la valuta secondo gli standard ISO-4217, altrimenti verrà utilizzato il dollaro statunitense per impostazione predefinita). |
<numeric> <ISO 4217> La valuta può essere inserita prima o dopo il valore numerico, con o senza spazio e seguire lo standard del codice ISO-4217. Non utilizzare 0 come valore né simboli di valuta. |
24,99 USD 24,99USD 24,99 USD 24,99USD 24,99 24,99 GBP24,99 GBP 24,99 GBP24,99 GBP 24,99 |
availability | La disponibilità del prodotto. |
Deve essere uno dei seguenti valori: in stock |
in stock |
item_group_id (obbligatorio solo se i prodotti hanno più varianti) | L'ID della famiglia di prodotti. | Massimo 127 caratteri. | DS0294 |
Puoi aggiungere campi opzionali al tuo catalogo retail per aiutarci a mappare meglio i prodotti per gli utenti. Più informazioni fornirai, più i tuoi Pin saranno pertinenti per le persone che li visualizzano.
Nome colonna | Descrizione | Sintassi/valori supportati | Esempio |
---|---|---|---|
product_type | La categorizzazione del prodotto in base alla tassonomia dei prodotti. |
Puoi inserire fino a cinque sottocategorie, per un massimo di 1.000 caratteri, separate da simboli > circondati da spazi. Altri delimitatori, come virgole o barre verticali, non verranno riconosciuti. |
Abbigliamento > Donna > Camicie > Denim |
additional_image_link |
Link fino a 10 immagini aggiuntive del prodotto (devono avere dimensioni minime di 75 x 75 pixel, essere accessibili dal nostro user-agent e non includere immagini di template o immagini segnaposto). Creiamo un nuovo Pin per ciascun link a un'immagine aggiuntiva. Se modifichi l'immagine in un secondo momento, dovrai utilizzare un link diverso, altrimenti non verrà aggiornata. |
Massimo 2.000 caratteri per link. I link devono iniziare con http:// o https:// (codifica o rimuovi le virgole). Suggerimento: racchiudi la stringa tra apici. |
"https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg" |
mobile_link | La versione della pagina di destinazione ottimizzata per dispositivi mobili. | Il link deve iniziare con http:// o https:// | https://m.example.com/cat/womens-clothing/denim-shirt-0294 |
sale_price |
Il prezzo scontato del prodotto (deve essere inferiore al prezzo e, se la valuta non è il dollaro statunitense, è necessario includere la valuta secondo gli standard ISO-4217, altrimenti verrà utilizzato il dollaro statunitense per impostazione predefinita). Se fornito, il prezzo scontato sarà considerato il prezzo corrente dell'articolo. |
<numeric> <ISO 4217> La valuta può essere inserita prima o dopo il valore numerico, con o senza spazio e seguire lo standard del codice ISO-4217. Non utilizzare 0 come valore né simboli di valuta. |
14,99 USD 14,99USD 14,99 USD 14,99USD 14,99 14,99 GBP 14,99 GBP14,99 GBP 14,99 GBP14,99 |
average_review_rating | La quantità media di recensioni sul prodotto. |
<numeric> Tra 1 e 5 |
5 |
number_of_ratings | Il numero di valutazioni sul prodotto. | <numeric> | 2 |
number_of_reviews | Il numero di recensioni sul prodotto. | <numeric> | 4 |
description_html |
La descrizione HTML del prodotto. Suggerimento: utilizza questo campo se la descrizione contiene più di 200 caratteri. Se viene fornito questo campo, lo useremo al posto del campo della descrizione obbligatorio. |
Formattazione HTML | <body> <h1>Il mio prodotto</h1> <p>Compra ora</p> </body> |
Nome colonna | Descrizione | Sintassi/valori supportati | Esempio |
---|---|---|---|
item_group_id | L'ID della famiglia di prodotti. | Massimo 127 caratteri | DS0294 |
brand |
Il brand del prodotto. | Massimo 100 caratteri | Josie’s Denim |
gtin | L'identificativo universale univoco del prodotto. | Valori numerici che seguono le linee guida del GTIN | 3234567890126 |
mpn | Il codice componente del produttore. |
Massimo 70 caratteri alfanumerici |
"mpn": "PI12345NTEREST" |
Nome colonna | Descrizione | Sintassi/valori supportati | Esempio |
---|---|---|---|
color |
Il colore principale del prodotto. | Massimo 30 caratteri. | blu |
gender | Il genere associato al prodotto. | Deve essere uno dei seguenti valori: male female unisex |
male |
age_group | L'età associata al prodotto. |
Deve essere uno dei seguenti valori: newborn |
newborn |
material | Il materiale utilizzato per realizzare il prodotto. | Massimo 30 caratteri. | cotone |
pattern | La fantasia utilizzata per il prodotto. | Massimo 30 caratteri. | quadretti |
size | La taglia del prodotto. | Massimo 30 caratteri. | M |
size_type | Ulteriore descrizione della taglia del prodotto. |
Deve essere uno dei seguenti valori: regular |
regular |
size_system | Il sistema di taglie del prodotto inviato. | Codice Paese. |
(Solo USA) |
alt_text | La descrizione di ciò che appare nelle immagini principali del prodotto. | Uno o più valori di testo alternativo, separati da virgole. Il numero di valori di testo alternativo deve corrispondere al numero di immagini nel campo image_link. Se sono parte di un testo alternativo, le virgole vanno codificate con , oppure rimosse. Le virgole devono essere usate solo per separare più testi alternativi. | Un cappello blu chiaro all'uncinetto con nappe |
variant_names | Le opzioni per questa versione del prodotto (gli utenti di Pinterest vedranno le diverse opzioni accanto al tuo Pin e potranno selezionare quella che preferiscono). | Testi separati da virgole nell'ordine in cui vuoi che le opzioni vengano mostrate. | Colore,taglia |
variant_values | Le opzioni di valore per questa variante del prodotto (gli utenti di Pinterest vedranno le diverse opzioni accanto al tuo Pin e potranno selezionare quella che preferiscono). |
Testi separati da virgole nell'ordine in cui vuoi che le opzioni vengano mostrate. È necessario mantenere lo stesso ordine del campo variant_names. |
Rosso,Small |
adult | Eventuale indicazione che si tratta di un prodotto per adulti. I prodotti per adulti non appariranno su Pinterest. |
Deve essere uno dei seguenti valori: TRUE |
false |
Nome colonna | Descrizione | Sintassi/valori supportati | Esempio |
---|---|---|---|
tax | I dettagli fiscali per il prodotto. |
Contiene un gruppo con al massimo quattro elementi: country, region, rate (tutti obbligatori) e tax_ship (facoltativo). Sono sempre richiesti i due punti, anche per i valori non inseriti. country:region:rate(required):tax_ship |
US:1025433:6.00:y |
shipping | I dati di spedizione per il prodotto. |
Contiene un gruppo con al massimo quattro elementi: country, region, service (tutti opzionali) e price (obbligatorio). Sono sempre richiesti i due punti, anche per i valori non inseriti. country:region:service:price(obbligatorio) |
US::Express:13.12 |
shipping_weight |
Il peso del prodotto. |
<numeric> <metric> Assicurati di lasciare uno spazio tra la stringa numerica e quella dell'unità di misura. |
5 libbre |
shipping_width | La larghezza minima del pacco per la spedizione del prodotto. |
<numeric> <metric> Assicurati di lasciare uno spazio tra la stringa numerica e quella dell'unità di misura. |
40 cm |
shipping_height | L'altezza minima del pacco per la spedizione del prodotto. |
<numeric> <metric> Assicurati di lasciare uno spazio tra la stringa numerica e quella dell'unità di misura. |
30 cm |
free_shipping_label |
Se offri la spedizione gratuita per il prodotto o meno. Se sì, inserisci 0 nel campo free_shipping_limit. Se offri la spedizione gratuita solo a partire da un dato importo, inserisci quell'importo nel campo free_shipping_limit. |
Deve essere uno dei seguenti valori: TRUE |
true |
free_shipping_limit | L'acquisto minimo necessario per ottenere la spedizione gratuita del prodotto. |
<numeric> <ISO 4217> |
35 USD |
Nome colonna | Descrizione | Sintassi/valori supportati | Esempio |
---|---|---|---|
custom_label_0 | Raggruppamenti personalizzati dei prodotti (fino a cinque). | Massimo 200 caratteri |
Promozione estiva |
custom_label_1 | Raggruppamenti personalizzati dei prodotti (fino a cinque). | Massimo 200 caratteri | Best seller |
Nome colonna | Descrizione | Sintassi/valori supportati | Esempio |
---|---|---|---|
ad_link | Un link utilizzabile per monitorare il traffico proveniente dagli Shopping Ad di Pinterest. |
Stringa URL. Devi inviare l'URL completo con il tracciamento, non solo i parametri di tracciamento. Al momento non supportiamo il tracciamento delle impression. Deve iniziare con http:// o https:// |
https://www.esempio.com/cat/camicia-denim/articolo012?utm_source=Pinterest |
condition | Le condizioni del prodotto. |
Deve essere uno dei seguenti valori: new |
new |
google_product_category | La categorizzazione dei prodotti in base alla tassonomia standardizzata dei prodotti di Google. |
Consulta la tassonomia completa in inglese. Visita il Centro assistenza di Google per accedere alle tassonomie per altre lingue. Sono validi sia valori testuali che codici numerici. |
Abiti e accessori > Abbigliamento > Camicie e top 21 |
Accertati di rispettare le nostre
Scopri come