Înainte de a începe lucrul cu Cataloage

Se pare că vezi acest lucru dintr-o regiune în care nu sunt disponibile deocamdată Cataloage. Vezi unde sunt disponibile Cataloage pentru conturi Pinterest Business.

Mai multe

Înainte de a putea configura Cataloage, trebuie să urmezi acești pași. Fă clic pe un link de mai jos pentru a accesa secțiunea de care ai nevoie:

Este cazul să folosești Cataloage?

Cataloage este un instrument de ingestie a fluxurilor proiectat pentru firmele care își vând produsele pe site-urile lor. Folosirea instrumentului Cataloage necesită:

  • Un cont business Pinterest
  • O sursă de date – un fișier care conține o listă cu produsele tale și atributele lor corespunzătoare poate fi, de asemenea, numit catalog de produse sau flux de produse
  • Un site revendicat
  • Un site care îndeplinește Cerințele pentru comercianți, cu o politică de expediere clară și ușor de găsit, cu o politică privind rambursările și cu detalii de contact
  • Găzduirea sursei de date – o modalitate de a găzdui și a stoca în mod constant o sursă de date a produselor tale, pe care să o poți trimite zilnic la Pinterest

Dacă nu îndeplinești aceste condiții și dorești să creezi Pinuri de cumpărături, poți intra în parteneriat cu un site de comerț electronic pentru a-ți formata produsele pentru Pinterest. În prezent, avem integrări cu GoDataFeed și Productsup. Mai există și alte modalități prin care îți poți promova conținutul pe Pinterest.

Prezentarea generală a sursei de date

Ce este o sursă de date?

O sursă de date (cunoscută și sub numele de „catalog de produse”, „flux de produse” sau „flux de date”) este un fișier cu o listă a produselor tale și atributele lor corespunzătoare, structurate într-un mod specific. Acest fișier este procesat zilnic, pentru a crea în mod dinamic Pinuri de la produsele tale.

Cum funcționează o sursă de date

Pentru a trimite o sursă de date la Pinterest, furnizezi o adresă URL la care să îți putem accesa fișierul sursă de date. Vom valida fișierul și vom crea un Pin de produs pentru fiecare articol care trece de validarea noastră. Află mai multe despre Specificațiile privind sursele de date.

Întreținerea unei surse de date

Găzduirea unei surse de date presupune un efort permanent de a oferi informații actualizate despre produsele care sunt disponibile. Pinterest se va ocupa zilnic de ingestia sursei tale de date și îți va trimite alerte în cazul în care apar erori. Este important să examinezi și să remediezi erorile cât mai rapid posibil, pentru a te asigura că informațiile despre produsele tale sunt corecte și actualizate.

În funcție de tipul de eroare, o eroare poate însemna că întregul flux nu se actualizează, că anumite articole din flux nu se actualizează sau că trebuie să faci câteva modificări în acord cu exemplele de bună practică.  Află mai multe despre depanarea mesajelor de eroare.

Mai multe despre sursele de date:

  • Actualizare zilnică. Ingestia sursei tare de date se face o dată la fiecare 24 de ore. Pentru a menține la zi detaliile produsului tău, sursa de date completă actualizată trebuie să fie disponibilă zilnic. Nu acceptăm ingestiile planificate sau la cerere.
  • Găzduirea sursei de date. Găzduiește-ți sursa de date proprie pe un server FTP/SFTP sau cu un link de descărcare directă HTTP/HTTPS. Aceasta trebuie să accesibilă unui agent utilizator și nu poate solicita permisiuni pentru IP-uri sau chei SSH. Dacă folosești un link de descărcare directă, nu se poate solicita nicio altă navigare suplimentară pentru ca Pinterest să acceseze fișierul. Nu oferim găzduire pentru surse de date.
  • Maximum 5 milioane de produse.  Putem procesa până la 5 milioane de produse pentru fiecare cont. Dacă sursa ta de date are mai mult de 5 milioane de produse, vom procesa primele 5 milioane de rânduri.
  • O singură sursă de date pentru fiecare cont business.

Cum poți avea un site revendicat pe Pinterest

Toate adresele URL de destinație din sursa de date trebuie să aibă un domeniu web înregistrat ca site revendicat pe Pinterest. O firmă poate revendica mai multe domenii, însă fiecare domeniu poate fi revendicat de un singur cont business Pinterest. Află cum să îți revendici site-ul.

Pregătirea sursei de date

Înainte de a-ți configura fluxul, trebuie să creezi o sursă de date – un fișier care conține o listă cu produsele tale și atributele lor corespunzătoare.

Cerințe pentru găzduirea surselor de date de Cataloage

Trebuie să furnizezi o găzduire proprie pe un server FTP/SFTP sau să configurezi un link de descărcare directă HTTP/HTTPS. Pinterest nu oferă găzduire pentru utilizatori. Locația sursei tale de date trebuie să permită accesarea de către un agent utilizator și să nu solicite niciun fel de permisiune de IP sau cheie SSH. Dacă folosești un link de descărcare directă de tipul HTTP/HTTPS, linkul nu trebuie să solicite nicio navigare suplimentară pentru ca Pinterest să acceseze fișierul.

Cerințe privind formatul sursei de date pentru Cataloage

Formate acceptate:

Sfaturi privind formatarea:

  • Dacă folosești un csv, îți încadrăm valorile între ghilimele duble, pentru a evita orice erori posibile de analiză
  • Folosirea unui delimitator flotant suplimentar (virgulă, tabulator) poate avea drept consecință procesarea incorectă a articolului sau a fișierului
  • Pentru a verifica dacă delimitatorii tuturor coloanelor și rândurilor sunt configurați corect, asigură-te că ai același număr de delimitatori în fiecare rând.
  • Specificațiile pentru flux trebuie să respecte engleza americană standardizată pentru valorile obligatorii și setate.
  • Pentru fișierele delimitate prin tabulatori și pentru cele delimitate prin virgulă, fișierul sursă de date trebuie să fie codificat ca text simplu, UTF-8 sau Latin1.

Cerințe privind datele de produs

Asigură-te că respecți Regulile noastre pentru comercianți. Este posibil să eliminăm produsele sau conturile care încalcă aceste reguli.

Câmpuri obligatorii și opționale

Există 7 câmpuri obligatorii. Dacă oricare dintre aceste câmpuri lipsește sau nu este formatat în mod corespunzător, ingestia va eșua pentru întregul flux.

Câmpuri obligatorii:

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

De asemenea, există câmpuri opționale pe care le poți adăuga pentru a ajuta platforma Pinterest să îți coreleze mai bine produsele cu Pinnerii. Cu cât oferi mai multe informații, cu atât vor fi mai relevante Pinurile tale pentru Pinnerii care le văd. Îți recomandăm cu tărie să adaugi câmpurile noastre opționale, precum detalii suplimentare la fluxul tău și să îmbunătățești relevanța.

Câmpuri obligatorii

Numele coloanei Descriere Sintaxă/valori acceptate Exemplu Cerință
id

ID-ul unic creat de utilizator ce reprezintă produsul.

Doar caracterele unicode sunt acceptate.

Maximum 127 de caractere DS0294-L obligatoriu
title Numele produsului. Trebuie să fie același nume ca cel al produsului din pagina de destinație. Include detalii privind variantele, cum ar fi culoarea și dimensiunea. Maximum 500 de caractere Fustă denim de damă, mărimea L obligatoriu
description Descrierea produsului. Acest câmp nu acceptă HTML și trebuie să fie text simplu pentru o experiență optimă. Maximum 10.000 de caractere Cămașă denim pentru bărbați, confecționată cu denim japonez de cea mai bună calitate.  obligatoriu
link Pagina de destinație a produsului. Linkul trebuie să conducă direct la produs și să prezinte aceleași date. Îți recomandăm să nu folosești hardwalluri. Adresa URL trebuie să înceapă cu http:// or https://  Maximum 511 caractere https://www.example.com/cat/womens-clothing/denim-shirt-0294 obligatoriu
image_link

Linkul către imaginea produsului. URL-ul trebuie să fie accesibil unui agent utilizator și să trimită imaginea corectă. Asigură-te că nu există imagini șablon sau substituent în link. Trebuie să înceapă cu http:// sau https://

Virgulele trebuie să fie codificate sau eliminate în cazul în care fac parte din link, deoarece momentan nu putem să procesăm valori image link ce conțin virgule.

  https://scene.example.com/image/image.jpg obligatoriu
price Prețul produsului. Prețul ar trebui să includă moneda în ISO-4217 dacă nu este exprimat în dolari americani. Dacă moneda nu este inclusă, se va folosi implicit dolarul american. Acceptăm moneda după valoarea numerică pentru preț, cu sau fără spațiu. Moneda trebuie să urmeze codul ISO-4217 standard. Nu acceptăm valoarea 0 pentru preț. Nu folosi simboluri valutare.

<numeric>

<ISO 4217>

24,99 USD
24,99USD
24,99
24,99 GBP
obligatoriu
availability Disponibilitatea produsului. Trebuie să aibă una dintre următoarele valori: „in stock”, „out of stock”, „preorder”. in stock
out of stock
preorder
in stock obligatoriu

Atribute generale opționale

Numele coloanei Descriere Sintaxă/valori acceptate Exemplu Cerință
product_type Clasificarea produsului pe baza taxonomiei de produs personalizate. Subcategoriile trebuie trimise separate prin “ > “. Simbolul > trebuie încadrat cu spații. Nu recunoaștem niciun alt delimitator, cum ar fi virgula sau bara dreaptă.

L0 > L1 > L2 > L3 > L4

Maximum 1.000 de caractere

Îmbrăcăminte > Damă > Cămăși > Denim opțional
additional_image_link

Linkuri către imagini suplimentare pentru produsul tău. Separă fiecare imagine suplimentară prin virgulă. Îți recomandăm să încadrezi întregul șir între ghilimele. Trebuie să înceapă cu http:// sau https://

Virgulele trebuie să fie codificate și eliminate în cazul în care fac parte din link, deoarece momentan nu putem să procesăm valori image link ce conțin virgule.
 

Vom crea un Pin nou pentru fiecare link suplimentar de imagine trimis.

  https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg opțional
mobile_link Versiunea optimizată pentru mobil a paginii tale de destinație. Trebuie să înceapă cu http:// sau https://   https://m.example.com/cat/womens-clothing/denim-shirt-0294 opțional
sale_price Prețul redus al produsului. Valoarea sale_price trebuie să fie mai mică decât valoarea price. Include moneda în aceeași configurație ca prețul. Ar trebui să includă moneda în ISO-4217 dacă moneda nu este dolarul american. Dacă moneda nu este inclusă, se va folosi implicit dolarul american. Acceptăm moneda după valoarea numerică pentru preț, cu sau fără spațiu. Nu acceptăm valoarea 0. Nu folosi simboluri valutare.

<numeric>

<ISO 4217>

14,99 USD
14,99USD
14,99
14,99 GBP
opțional

Identificatorul de produs suplimentar

Numele coloanei Descriere Sintaxă/valori acceptate Exemplu Cerință
item_group_id ID-ul părinte al produsului.  Maximum 127 de caractere DS0294 obligatoriu pentru articolele cu mai multe variante

brand

Brandul produsului.   Josie’s Denim opțional
gtin Identificatorul de produs universal unic. Numeric 3234567890126 opțional
mpn Numărul piesei de producător este alcătuit din coduri alfanumerice create de producătorul unui produs pentru a identifica în mod unic produsul între alte produse ale sale.  Alfanumeric "mpn":
"PI12345NTEREST"
opțional

Caracteristici ale produsului opționale

Numele coloanei Descriere Sintaxă/valori acceptate Exemplu Cerință

color

Culoarea principală a produsului   blue opțional
gender Genul asociat produsului. Dacă este trimis, trebuie să aibă una dintre valorile următoare: „male”, „female”, „unisex” male
female
unisex
female opțional
age_group Grupa de vârstă pentru a aplica un interval demografic pentru produs. Trebuie să aibă una dintre următoarele valori: „newborn”, „infant”, „toddler”, „kids”, „adult” newborn
infant
toddler
kids
adult
adult opțional
material Materialul folosit pentru fabricarea produsului.   cotton opțional
pattern Descrierea modelului folosit pentru produs.   plaid opțional
size Mărimea produsului.   M opțional
size_type Descriere suplimentară pentru dimensiune. Dacă este trimis, trebuie să aibă una dintre valorile următoare: „regular”, „petite”, „plus”, „big_and_tall”, „maternity” regular
petite
plus
big_and_tall
maternity
regular opțional
size_system Indică sistemul de mărimi a țării în care trimiteți produsul. Cod de țară

US
UK

opțional

Date opționale privind taxele și expedierea

Numele coloanei Descriere Sintaxă/valori acceptate Exemplu Cerință
tax Fiecare grup de atribute pentru taxe poate fi format din 4 atribute secundare: country:region:rate (required):tax_ship
Toate coloanele, chiar și cele pentru valori necompletate, sunt obligatorii.
country:region:rate(required):tax_ship US:1025433:6.00:y opțional
shipping Fiecare grup de atribute de expediere poate fi alcătuit din 4 atribute secundare: country, region, service și price (obligatoriu).
Toate coloanele, chiar cele și pentru valori necompletate, sunt obligatorii.
country:region:service:price(required)

US:CA:Ground:0 USD

US::Express:13.12

opțional

shipping_weight

Greutatea produsului. Asigură-te că există un spațiu între șirul numeric și unitatea de măsură. <numeric> <metric> 3 kg
5 g
opțional
shipping_width Lățimea pachetului necesar pentru expedierea produsului. Asigură-te că există un spațiu între șirul numeric și unitatea de măsură. <numeric> <metric> 16 cm opțional
shipping_height Înălțimea pachetului necesar pentru expedierea produsului. Asigură-te că există un spațiu între șirul numeric și unitatea de măsură. <numeric> <metric> 12 cm opțional

Semnalizare opțională de produs pentru adulți

Numele coloanei Descriere Sintaxă/valori acceptate Exemplu Cerință
adult Setează acest atribut ca TRUE dacă trimiți articole care sunt considerate „pentru adulți”. Acestea nu vor fi afișate pe Pinterest. TRUE
FALSE
true opțional

Etichete personalizate opționale

Gruparea personalizată a produselor. Acestea pot fi folosite în diverse scopuri, cum ar fi sezonul, promoțiile, cele mai bine vândute. Acceptăm până la 5 etichete personalizate diferite.

Vei putea crea grupuri de produse în Cataloage folosind etichete personalizate.

Numele coloanei Descriere Sintaxă/valori acceptate Exemplu Cerință
custom_label_0 Gruparea personalizată a produselor. Maximum 1.000 de caractere

Cele mai vândute

Promoție de vară

opțional
custom_label_1 Gruparea personalizată a produselor. Maximum 1.000 de caractere   opțional
custom_label_2 Gruparea personalizată a produselor. Maximum 1.000 de caractere   opțional
custom_label_3 Gruparea personalizată a produselor. Maximum 1.000 de caractere   opțional
custom_label_4 Gruparea personalizată a produselor. Maximum 1.000 de caractere   opțional

Câmpuri de reclame de cumpărături opționale

Numele coloanei Descriere Sintaxă/valori acceptate Exemplu Cerință
ad_link Le permite publicitarilor să specifice un URL separat care poate fi folosit pentru a urmări traficul provenit de la reclame de cumpărături de pe Pinterest. Trebuie să trimită URL-ul complet, inclusiv urmărirea, nu doar parametrii de urmărire. Momentan, nu acceptăm urmărirea afișărilor. Trebuie să înceapă cu http:// sau https:// URL șir https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest opțional
condition Starea produsului. Trebuie să aibă una dintre următoarele valori: „new”, „used”, „refurbished”. new
used
refurbished
new opțional
google_product_category Clasificarea produselor pe baza taxonomiei standardizate a produselor Google. Aceasta este o taxonomie stabilită. Sunt acceptate atât valorile text, cât și codurile numerice. Taxonomie completă Îmbrăcăminte și accesorii > Îmbrăcăminte > Cămăși și topuri
212
opțional

 

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

 

Configurarea marcajului Pinterest

Marcajul Pinterest este un fragment de cod JavaScript pe care îl incluzi pe site-ul tău pentru a colecta detalii despre conversii și a crea segmente de public de vizat, pe baza acțiunilor pe care le-au efectuat pe site-ul tău.

Nu uita să trimiți câmpuri de cumpărături specifice prin marcajul Pinterest.

  • Trebuie să implementezi marcajul Pinterest cu următoarele tipuri de conversii: PageVisits, AddToCart și Checkouts 
  • Trebuie să transmiți datele de eveniment pentru „product_id” ca atribut pentru PageVisit, AddToCart și Checkouts
    • Product_id trebuie să treacă sub un element de rând (nu va fi vizibil în pagina de vizualizare Conversii).
    • Folosește extensia Chrome Ajutor pentru marcaje pentru a te asigura că ID-urile de produse sunt transmise înapoi pe paginile cu detalii despre produse.
  • Datele pentru product_id transmise în marcaje trebuie să corespundă valorii „item_group_id” sau „id” furnizate în sursa de date
  • Minimum 100.000 de evenimente PageVisit și AddtoCart combinate din ultimele 7 zile care transmit înapoi ID-uri de produse
     

Care este pasul următor?

Consultă ghidul nostru Ingestia sursei de date pentru a afla cum să îți conectezi fluxul de produse la Pinterest.

Încă mai ai nevoie de asistență?
Contactează-ne