Înainte de a începe lucrul cu Cataloage

Î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
  • 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ă 9 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
  • condition
  • google_product_category

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 128 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 500 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
condition Starea produsului. Trebuie să aibă una dintre următoarele valori: „new”, „used”, „refurbished”. new
used
refurbished
new obligatoriu
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
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 Î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:// Maximum 511 caractere 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
identifier_exists Obligatoriu atunci când nu există identificatori de produs unici (GTIN sau MPN). Când atributul nu este specificat, valoarea implicită va fi TRUE. true
false
yes
no
true 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.  

Cele mai vândute

Promoție de vară

opțional
custom_label_1 Gruparea personalizată a produselor.     opțional
custom_label_2 Gruparea personalizată a produselor.     opțional
custom_label_3 Gruparea personalizată a produselor.     opțional
custom_label_4 Gruparea personalizată a produselor.     opțional

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

Numele coloanei Descriere Sintaxă/valori acceptate Exemplu Cerință
adwords_redirect 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

 

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