Bilang merchant, puwede mong i-upload ang mga produkto mo sa Pinterest bilang mga Pin ng produkto. Espesyal na naka-format ang mga Pin ng Produkto para ipaalam sa mga taong nagba-browse sa Pinterest na mabibili ang mga ito. Mayroong pamagat at paglalarawan ng produkto ang mga ito, pati na rin presyo at impormasyon ng availability.
Idagdag ang pinanggalingan ng data ng iyong retail catalog sa Pinterest para ma-upload ang marami sa iyong mga produkto, bilang mga Pin ng produkto, nang sabay-sabay. Pagkatapos, puwede mong i-promote ang mga ito sa buong Pinterest bilang mga shopping ad. Mayroon kang opsyong magbigay ng URL link para sa iyong naka-host na pinanggalingan ng data, o mano-manong i-upload ang iyong pinanggalingan ng data.
Bago mo idagdag ang iyong retail catalog, kakailanganin mong:
Kung hindi mo natutugunan ang mga kinakailangan sa itaas,
Gumagana ang mga retail catalog depende sa kung paano mo pinipiling idagdag ang iyong pinanggalingan ng data, kung saan maa-access namin ang iyong retail catalog.
Kung ibibigay mo ang URL link para sa iyong naka-host na pinanggalingan ng data, ia-access namin ang iyong pinanggalingan ng data araw-araw para dynamic kaming makagawa ng mga Pin ng produkto para sa bawat produkto sa retail catalog mo. Tiyaking available ang iyong na-update na pinanggalingan ng data araw-araw para up to date ang mga detalye ng iyong produkto. Puwede mo ring iiskedyul nang maaga ang iyong pag-ingest ng data.
Kung mano-mano mong ia-upload ang iyong pinanggalingan ng data, ia-access namin ang iyong pinanggalingan ng data kapag ina-upload ito, at sa tuwing mag-a-upload ka ng na-update na pinanggalingan ng data para makagawa kami ng mga Pin ng produkto, o ma-update ang metadata para sa mga dati nang Pin, para sa bawat produkto sa iyong retail catalog.
Aalertuhan ka namin sa anumang error. Mahalaga na suriin at ayusin ang mga ito nang mabilis hangga't maaari para siguruhin na tumpak at up to date ang impormasyon ng produkto mo. Ang isang error ay puwedeng mangahulugan na hindi nag-a-update ang iyong buong feed, hindi nag-a-update ang ilang item sa feed mo, o kailangan mong gumawa ng ilang pagbabago sa format.
Maaari naming maproseso ang hanggang 20 milyong produkto kada retail catalog. Kung mayroon kang mahigit sa 20 milyong produkto,
May kaugnayan lang ito kung hino-host mo ang iyong pinanggalingan ng data. Kung mano-mano mong ina-upload ang iyong pinanggalingan ng data, puwede mong laktawan ang seksyong ito.
Kakailanganin mong i-host ang sarili mong pinanggalingan ng data sa isang FTP/SFTP/WebDAV server o gamit ang isang HTTP/HTTPS direct-download link. Kailangang naa-access ito ng user-agent, at hindi puwedeng mangailangan ng IP o SSH key na pag-whitelist. Kung gumagamit ka ng direct download link, hindi puwedeng magkaroon ng anumang dagdag na pag-navigate na kinakailangan para ma-access namin ang file.
Sinusuportahan namin ang mga sumusunod na format:
Pinaghihiwalay ng tab (TSV) | ( |
Pinaghihiwalay ng kuwit (CSV) | ( |
XML (RSS 2.0, ATOM 1.0) | ( |
Google Sheets | ( |
Tandaan: Tumatanggap kami ng mga naka-compress na file (.zip, .giz, .gz, .bz2 at iba pa), pero hindi namin sinusuportahan sa kasalukuyan ang mga naka-encrypt at protektado ng password na naka-compress na file, o mga Dropbox file.
Kailangang isama ng retail catalog mo ang mga sumusunod na field, na naka-format kung paano mo mismong nakikita ang mga ito. Kung nawawala ang mga ito, o hindi naka-format nang tama, hindi mai-ingest ang iyong buong retail catalog.
Pangalan ng column | Paglalarawan | Syntax/mga sinusuportahang value | Halimbawa |
---|---|---|---|
id |
Natatanging ID na kumakatawan sa produkto. |
Maximum na 127 character. | DS0294-L |
title | Pangalan ng produkto (pareho sa pangalan ng produkto mula sa landing page, kasama ang mga detalye ng variant, tulad ng kulay at laki). | Maximum na 500 character. | Denim shirt ng mga babae, large |
description | Paglalarawan ng produkto. | Maximum na 10,000 character sa plain text (hindi HTML). | Casual fit na denim shirt na ginawa gamit ang pinakamagandang kalidad na Japanese denim |
link | Landing page para sa produkto (kailangang direktang mapupunta sa parehong produkto at magpapakita ng parehong data) |
URL ng string. Maximum na 511 character at dapat ay nagsisimula ang URL sa http:// (hindi namin inirerekomenda ang mga hardwall). |
|
image_link |
Link sa pangunahing larawan ng produkto (kahit man lang 75x75 pixel, na maa-access ng aming user-agent at walang larawan ng template o placeholder). Kung babaguhin mo ang larawan sa ibang pagkakataon, kakailanganin mong gumamit ng ibang link, kung hindi ay hindi maa-update ang larawan. |
URL ng string. Maximum na 2,000 character, na nagsisimula sa http:// o https:// (i-encode o alisin ang mga kuwit). Inirerekomenda: Paglalagay ng string sa mga quote. |
|
presyo |
Presyo ng produkto (dapat na ipakita ang totoong halaga ng produkto at may currency na nasa ISO-4217 kung hindi ito US dollars, kung hindi ay magde-default kami sa US dollars). |
<numeric> <ISO 4217> Ang currency ay puwedeng bago o pagkatapos ng numeric price value, nang may space o wala, at sumusunod sa standard na ISO-4217 code. Huwag gumamit ng 0 value o mga simbolo ng currency. |
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 | Availability ng produkto. |
Dapat ay isa sa mga sumusunod na value: in stock |
in stock |
item_group_id (kailangan lang kapag maraming variant ang mga produkto) | Parent ID ng produkto. | Maximum na 127 character. | DS0294 |
Puwede kang magdagdag ng mga opsyonal na field sa iyong retail catalog para tulungan kaming mas i-map ang iyong mga produkto sa mga tao. Kapag mas marami kang ibibigay na impormasyon, mas magiging makabuluhan ang iyong mga Pin sa mga taong makakakita sa mga ito.
Pangalan ng column | Paglalarawan | Syntax/mga sinusuportahang value | Halimbawa |
---|---|---|---|
product_type | Pagkakategorya ng produkto mo batay sa iyong custom na taxonomy ng produkto. | Maximum na limang subcategory, na may maximum na 1,000 character na dapat ay paghiwalayin ng > na naka-wrap ayon sa mga space (Hindi namin kinikilala ang iba pang delimiter gaya ng kuwit o pipe). | Damit > Mga Babae > Mga Shirt > Denim |
additional_image_link |
Nagli-link sa hanggang 10 karagdagang larawan ng produkto mo (kahit man lang 75x75 pixel, na maa-access ng aming user-agent at walang larawan ng template o placeholder). Gagawa kami ng bagong pin para sa bawat karagdagang link ng larawan. Kung babaguhin mo ang larawan sa ibang pagkakataon, kakailanganin mong gumamit ng ibang link, kung hindi ay hindi maa-update ang larawan. |
Maximum na 2,000 character bawat isa, na nagsisimula sa http:// o https:// (i-encode o alisin ang mga kuwit). Inirerekomenda: Paglalagay ng string sa mga quote. |
" |
mobile_link | Bersyon na naka-optimize para sa mobile ng iyong landing page. | Kailangang nagsisimula sa http:// o https:// | |
sale_price |
May diskwentong presyo ng produkto (mas mababa dapat sa presyo at may currency na nasa ISO-4217 kung hindi ito US dollars, kung hindi ay magde-default kami sa US dollars) Kung ibinigay, ituturing na kasalukuyang presyo ng item ang presyo ng pagbebenta. |
<numeric> <ISO 4217> Ang currency ay puwedeng bago o pagkatapos ng numeric price value, nang may space o wala, at sumusunod sa standard na ISO-4217 code. Huwag gumamit ng 0 value o mga simbolo ng currency. |
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 | Average na bilang ng mga review para sa produkto. |
<numeric> Sa pagitan ng 1-5 |
5 |
number_of_ratings | Bilang ng mga rating para sa produkto. | <numeric> | 2 |
number_of_reviews | Bilang ng mga review para sa produkto. | <numeric> | 4 |
description_html |
HTML na paglalarawan para sa produkto. Inirerekomenda: Gamitin ito kung mas mahaba sa 200 character ang iyong paglalarawan. Kung ibibigay ang field na ito, gagamitin namin ito sa halip na ang kinakailangang field ng paglalarawan. |
Pag-format ng HTML | <body> <h1>Aking Produkto</h1> <p>Bilhin Na</p> </body> |
video_link |
Naka-host na link sa video ng produkto. Ang mga uri ng file para sa mga naka-link na video ay dapat .mp4, .mov, o .m4v. Hindi puwedeng lumampas sa 2GB ang laki ng file. |
URL ng string. Maximum na 2,000 character, na nagsisimula sa http:// o https:// |
Pangalan ng column | Paglalarawan | Syntax/mga sinusuportahang value | Halimbawa |
---|---|---|---|
item_group_id | Parent ID ng produkto. | Maximum na 127 character | DS0294 |
brand |
Brand ng produkto | Maximum na 100 character | Josie’s Denim |
gtin | Natatanging universal na tagatukoy ng produkto | Numeric na |
3234567890126 |
mpn | Manufacturer part number ng produkto |
Maximum na 70 alphanumeric character |
"mpn": "PI12345NTEREST" |
Pangalan ng column | Paglalarawan | Syntax/mga sinusuportahang value | Halimbawa |
---|---|---|---|
kulay |
Pangunahing kulay ng produkto. | Maximum na 30 character. | asul |
kasarian | Kasarian na nauugnay sa produkto. | Dapat ay isa sa mga sumusunod na value: lalaki babae unisex |
LALAKI |
age_group | Edad na nauugnay sa produkto. |
Dapat ay isa sa mga sumusunod na value: bagong panganak |
bagong panganak |
materyal | Materyal na ginagamit para magawa ang produkto. | Maximum na 30 character. | cotton |
pattern | Pattern na ginagamit para sa produkto. | Maximum na 30 character. | plaid |
sukat | Sukat ng produkto. | Maximum na 30 character. | M |
size_type | Karagdagang paglalarawan para sa laki ng produkto. |
Dapat ay isa sa mga sumusunod na value: regular |
regular |
size_system | Ang sistema sa pagsukat ng bansa kung saan mo isinusumite ang produkto mo. | Code ng bansa. |
US |
alt_text | Paglalarawan ng lumalabas sa mga pangunahing larawan ng produkto. | Isa o higit pang alt text value, na pinaghiwalay ng mga kuwit. Ang bilang ng mga alt text value ay dapat na tumugma sa bilang ng mga larawan sa iyong field na image_link. Dapat na i-encode ang mga kuwit bilang ,, o alisin kung bahagi ang mga ito ng alt text. Dapat na gumamit ng mga kuwit para paghiwalayin ang maraming alt text. | Isang light blue na ginantsilyong sumbrero na pang-baby na may mga tassel |
variant_names | Mga opsyon para sa variant na ito ng produkto (Makikita ng mga tao sa Pinterest ang mga opsyon na ito sa tabi ng iyong Pin at mapipili nila ang gusto nila). | Mga text na pinaghihiwalay ng mga kuwit na nakalista sa ayos na gusto mong ipakita ang mga ito. | Kulay,Sukat |
variant_values | Mga opsyon sa value para sa variant na ito ng produkto (Makikita ng mga tao sa Pinterest ang mga opsyon na ito sa tabi ng iyong Pin at mapipili nila ang gusto nila). |
Mga text na pinaghihiwalay ng mga kuwit na nakalista sa ayos na gusto mong ipakita ang mga ito. Pareho dapat sa pagkakasunod-sunod sa field na variant_names. |
Pula,Maliit |
matanda | Kung para sa nasa hustong gulang o hindi ang produkto. Hindi ipapakita sa Pinterest ang mga produktong para sa nasa hustong gulang. |
Dapat ay isa sa mga sumusunod na value: TAMA |
false |
Pangalan ng column | Paglalarawan | Syntax/mga sinusuportahang value | Halimbawa |
---|---|---|---|
buwis | Mga detalye ng buwis para sa produkto |
Binubuo ng isang grupo ng hanggang apat na element: bansa, rehiyon, rate (kinakailangan lahat) at tax_ship (opsyonal). Kinakailangan ang mga tutuldok, kahit na para sa mga blangkong value. bansa:rehiyon:rate(kailangan):tax_ship |
US:1025433:6.00:y |
shipping | Mga detalye ng shipping para sa produkto |
Binubuo ng isang grupo ng hanggang apat na element: bansa, rehiyon, serbisyo (opsyonal lahat) at presyo (kinakailangan). Kinakailangan ang mga tutuldok, kahit na para sa mga blangkong value. bansa:rehiyon:serbisyo:presyo (kinakailangan) |
US::Express:13.12 |
shipping_weight |
Timbang ng produkto. |
<numeric> <metric> Siguruhin na mayroong space sa pagitan ng numeric string at metric. |
5 lbs |
shipping_width | Lapad ng package na kailangan para i-ship ang produkto. |
<numeric> <metric> Siguruhin na mayroong space sa pagitan ng numeric string at metric. |
16 na pulgada |
shipping_height | Taas ng package na kailangan para i-ship ang produkto. |
<numeric> <metric> Siguruhin na mayroong space sa pagitan ng numeric string at metric. |
12 pulgada |
free_shipping_label |
Kung magbibigay ka ng libreng shipping para sa produkto o hindi. Kung magbibigay ka, ilagay ang 0 sa field na free_shipping_limit. Kung mag-aalok ka lang ng libreng shipping matapos gumastos ang isang tao ng partikular na halaga, ilagay ang halaga sa field na free_shipping_limit. |
Dapat ay isa sa mga sumusunod na value: TAMA |
tama |
free_shipping_limit | Minimum na bibilhing order na kailangan para makakuha ng libreng shipping ng produkto. |
<numeric> <ISO 4217> |
35USD |
Pangalan ng column | Paglalarawan | Syntax/mga sinusuportahang value | Halimbawa |
---|---|---|---|
custom_label_0 | Custom na paggugrupo ng mga produkto (hanggang lima) | Maximum na 511 character | Promotion sa tag-init |
custom_label_1 | Custom na paggugrupo ng mga produkto (hanggang lima) | Maximum na 511 character | Mga best seller |
custom_number_0 | Custom na pagnunumero ng mga produkto (hanggang lima) | Integer number na mas mataas sa o katumbas ng 0, at mas mababa sa o katumbas ng 4294967295 | 1029384 |
custom_number_1 | Custom na pagnunumero ng mga produkto (hanggang lima) | Integer number na mas mataas sa o katumbas ng 0, at mas mababa sa o katumbas ng 4294967295 | 2938 |
Pangalan ng column | Paglalarawan | Syntax/mga sinusuportahang value | Halimbawa |
---|---|---|---|
ad_link | Link na magagamit para mag-track ng traffic na nagmumula sa mga shopping ad sa Pinterest. |
URL ng string. Dapat na magpadala ng kumpletong URL kasama ang pag-track, hindi lang mga parameter sa pag-track. Sa ngayon, hindi namin sinusuportahan ang pag-track ng impression. Dapat magsimula sa http:// o https:// |
|
kondisyon | Kundisyon ng produkto. |
Dapat ay isa sa mga sumusunod na value: bago |
bago |
google_product_category | Pagkakategorya ng produkto batay sa naka-standardize na Google Product Taxonomy. |
Parehong tinatanggap ang mga text value at numeric code. |
Kasuotan at Mga Accessory > Damit > Mga Shirt at Top 21 |
Tiyaking susundin mo ang aming
Alamin kung paano