Sebelum Anda mulai menggunakan Katalog

Sepertinya Anda melihat artikel ini dari wilayah yang belum mendukung Katalog. Lihat di wilayah mana saja Katalog tersedia untuk akun Pinterest Business.

Pelajari selengkapnya

Sebelum dapat menyiapkan Katalog, Anda harus menyelesaikan langkah-langkah ini. Klik tautan di bawah untuk menuju ke bagian yang Anda butuhkan:

Apakah Katalog cocok untuk Anda?

Katalog adalah alat penyerap sajian yang dirancang untuk bisnis yang menjual produk di situs webnya. Untuk menggunakan Katalog, Anda memerlukan:

  • Akun bisnis Pinterest
  • Sumber data - file yang berisi daftar produk Anda dan atributnya yang sesuai, yang juga disebut katalog produk atau sajian produk
  • Situs web yang diklaim
  • Situs web yang memenuhi Pedoman Pedagang, dengan kebijakan pengiriman, kebijakan pengembalian uang, dan detail kontak yang jelas dan mudah ditemukan
  • Hosting sumber data - cara untuk menyediakan host dan menyimpan sumber data produk Anda secara konsisten sehingga Anda dapat mengirimkannya ke Pinterest setiap hari

Jika tidak memenuhi ketentuan ini dan ingin membuat Pin Belanja, Anda dapat bermitra dengan situs web e-commerce untuk memformat produk Anda untuk Pinterest. Sejauh ini, kami memiliki integrasi dengan GoDataFeed dan Productsup. Anda juga dapat mempromosikan konten Anda dengan cara lain di Pinterest.

Ringkasan sumber data

Apa itu sumber data?

Sumber data (umumnya juga dikenal sebagai katalog produk, sajian produk, atau sajian data) adalah file yang berisi daftar produk dan atribut yang sesuai yang disusun dengan cara tertentu. File ini diproses tiap hari untuk membuat pin dari produk Anda secara dinamis.

Cara kerja sumber data

Untuk mengirimkan sumber data ke Pinterest, sediakan tautan url ke tempat kami dapat mengakses file sumber data Anda. Kami akan memvalidasi file dan membuat pin produk untuk setiap item yang lolos validasi kami. Lihat selengkapnya tentang Spesifikasi Sumber Data.

Mengelola sumber data

Hosting sumber data adalah awal dari upaya yang berkelanjutan untuk memberikan informasi terbaru tentang produk yang Anda miliki. Pinterest akan menyerap sumber data Anda setiap hari, dan memberi tahu jika ada kesalahan. Anda perlu meninjau dan memperbaiki kesalahan secepat mungkin untuk memastikan info produk Anda akurat dan mutakhir.

Tergantung pada jenis kesalahan, suatu kesalahan dapat menyebabkan seluruh sajian Anda tidak diperbarui, beberapa item pada sajian Anda tidak diperbarui, atau Anda perlu membuat perubahan untuk menyesuaikan dengan praktik terbaik. Pelajari selengkapnya tentang pemecahan masalah pesan kesalahan.

Selengkapnya tentang sumber data:

  • Perbarui setiap hari. Kami menyerap sumber data Anda setiap 24 jam sekali. Perbarui sumber data Anda setiap hari agar detail produk Anda selalu mutakhir. Kami tidak mendukung penjadwalan atau penyerapan sesuai permintaan.
  • Hosting sumber data Anda. Sediakan hosting sumber data Anda sendiri di server FTP/SFTP atau dengan tautan unduhan langsung HTTP/HTTPS. Hosting ini harus dapat diakses oleh agen-pengguna, dan tidak memerlukan daftar SSH atau IP yang diizinkan. Jika Anda menggunakan tautan unduhan langsung, tidak boleh ada navigasi tambahan yang diperlukan Pinterest untuk mengakses file. Kami tidak menyediakan hosting sumber data.
  • Maksimal 5 juta produk. Kami dapat memproses hingga 5 juta produk per akun. Jika sumber data Anda memiliki lebih dari 5 juta produk, kami akan memproses 5 juta baris pertama.
  • Satu sumber data per akun bisnis.

Memiliki situs web yang sudah diklaim di Pinterest

Semua URL tujuan di sumber data Anda harus memiliki domain web yang terdaftar sebagai situs web yang diklaim di Pinterest. Satu bisnis dapat mengklaim beberapa domain, tetapi setiap domain hanya dapat diklaim oleh satu akun bisnis Pinterest. Pelajari cara mengklaim situs web Anda.

Persiapkan sumber data Anda

Sebelum dapat menyiapkan sajian, Anda harus membuat sumber data— file yang berisi daftar produk Anda dan atribut yang sesuai.

Persyaratan hosting sumber data Katalog

Anda harus menyediakan hosting sendiri di server FTP/SFTP, atau menyiapkan tautan unduhan langsung HTTP/HTTPS. Pinterest tidak menyediakan hosting untuk pengguna. Lokasi sumber data Anda harus dapat diakses oleh agen-pengguna, dan tidak memerlukan daftar IP atau SSH yang diizinkan. Jika Anda menggunakan tautan unduhan langsung dalam bentuk HTTP/HTTPS, tautan Anda tidak boleh memiliki navigasi tambahan yang diperlukan Pinterest untuk mengakses file.

Persyaratan format sumber data Katalog

Format yang didukung:

Kiat pemformatan:

  • Jika Anda menggunakan csv, kami menempatkan nilai Anda di dalam tanda kutip ganda untuk menghindari masalah penguraian
  • Pembatas mengambang tambahan (koma, tab) dapat menyebabkan item atau file tidak diproses dengan benar
  • Pastikan pembatas untuk semua kolom dan baris Anda diatur dengan benar dengan memeriksa untuk memastikan Anda memiliki jumlah pembatas yang sama di setiap baris.
  • Spesifikasi untuk sajian harus mengikuti Bahasa Inggris Amerika standar untuk nilai yang dibutuhkan dan ditetapkan.
  • Untuk file yang dipisahkan tab atau dipisahkan koma, sumber data harus berupa teks biasa, dienkode UTF-8 atau Latin1.

Persyaratan data produk

Pastikan Anda mengikuti Pedoman Pedagang kami. Kami dapat menghapus produk atau akun yang melanggar pedoman ini.

Bidang yang harus ada dan opsional

Ada 7 bidang yang harus diisi. Jika ada bidang yang tidak diisi atau tidak diformat dengan benar, seluruh sajian Anda akan gagal diserap.

Bidang yang harus ada:

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

Ada juga bidang opsional yang dapat Anda tambahkan untuk membantu Pinterest memetakan produk Anda kepada para pengguna dengan lebih baik. Semakin banyak informasi yang Anda berikan, semakin relevan pin Anda untuk para pengguna yang melihatnya. Kami sangat menyarankan untuk menambahkan bidang opsional agar sajian Anda lebih detail dan untuk meningkatkan relevansi.

Bidang yang harus diisi

Nama kolom Keterangan Sintaks/nilai yang didukung Contoh Persyaratan
id

ID unik yang dibuat oleh pengguna yang mewakili produk.

Hanya karakter unicode yang diterima.

Maksimal 127 karakter DS0294-L harus diisi
title Nama produk. Harus nama yang sama dengan produk dari halaman tujuan. Sertakan detail varian, seperti warna dan ukuran. Maksimal 500 karakter Kemeja denim wanita, besar harus diisi
description Deskripsi produk. Bidang ini tidak mendukung HTML dan harus dalam teks biasa untuk pengalaman yang optimal. Maksimal 10.000 karakter Kemeja kasual denim yang terbuat dari denim Jepang berkualitas.  harus diisi
link Halaman tujuan untuk produk. Tautan harus mengarah langsung ke produk yang sama dan menampilkan data yang sama. Kami tidak merekomendasikan hardwall. URL harus dimulai dengan http:// atau https://  Maksimal 511 karakter https://www.example.com/cat/womens-clothing/denim-shirt-0294 harus diisi
image_link

Tautan ke gambar produk. URL harus dapat diakses oleh agen-pengguna, dan mengirim gambar yang akurat. Pastikan tidak ada template atau gambar placeholder di tautan. Harus dimulai dengan http:// atau https://

Koma harus dienkode atau dihapus jika merupakan bagian dari tautan gambar, karena saat ini kami tidak dapat memproses tautan gambar yang mengandung koma.

  https://scene.example.com/image/image.jpg harus diisi
price Harga produk. Harga harus menyertakan mata uang dalam ISO-4217 jika bukan dolar AS. Jika mata uang tidak disertakan, kami akan menetapkan default ke dolar AS. Kami menerima mata uang setelah nilai harga numerik, dengan atau tanpa spasi. Mata uang harus mengikuti kode ISO-4217 standar. Kami tidak menerima nilai 0 untuk harga. Jangan menggunakan simbol mata uang.

<numeric>

<ISO 4217>

24,99 USD
24,99USD
24,99
24,99 GBP
harus diisi
availability Ketersediaan produk. Harus salah satu dari nilai berikut: 'in stock', 'out of stock', 'preorder'. in stock
out of stock
preorder
in stock harus diisi

Atribut umum opsional

Nama kolom Keterangan Sintaks/nilai yang didukung Contoh Persyaratan
product_type Penetapan kategori produk berdasarkan pada taksonomi produk kustom Anda. Subkategori harus dikirim dengan dipisahkan oleh “>“. Tanda > Harus diapit oleh spasi. Kami tidak mengenali pembatas lain seperti koma atau pipa.

L0 > L1 > L2 > L3 > L4

Maksimal 1000 karakter

Pakaian > Wanita > Kemeja > Denim opsional
additional_image_link

Tautan ke gambar tambahan produk Anda. Pisahkan tiap gambar tambahan dengan koma. Kami sarankan untuk mengapit seluruh string dengan tanda kutip. Harus dimulai dengan http:// atau https://

Koma harus dienkode atau dihapus jika merupakan bagian dari tautan gambar, karena saat ini kami tidak dapat memproses tautan gambar yang mengandung koma.
 

Kami akan membuat pin baru untuk setiap tautan gambar tambahan yang dikirim.

  "https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg" opsional
mobile_link Versi halaman tujuan yang dioptimalkan untuk seluler. Harus dimulai dengan http:// atau https://   https://m.example.com/cat/womens-clothing/denim-shirt-0294 opsional
sale_price Harga diskon produk. sale_price harus lebih rendah dari harga. Sertakan mata uang dalam penyiapan yang sama dengan harga. Harga harus menyertakan mata uang dalam ISO-4217 jika bukan dolar AS. Jika mata uang tidak disertakan, kami akan menetapkan default ke dolar AS. Kami menerima mata uang setelah nilai harga numerik, dengan atau tanpa spasi. Kami tidak menerima nilai 0. Jangan menggunakan simbol mata uang.

<numeric>

<ISO 4217>

14,99 USD
14,99USD
14,99
14,99 GBP
opsional

Kode unik produk opsional

Nama kolom Keterangan Sintaks/nilai yang didukung Contoh Persyaratan
item_group_id ID induk produk.  Maksimal 127 karakter DS0294 harus ada untuk item dengan beberapa varian

brand

Merek produk.   Josie’s Denim opsional
gtin Kode unik produk universal opsional. Numerik 3234567890126 opsional
mpn Nomor Suku Cadang Pabrik adalah kode alfanumerik yang dibuat oleh pabrik dari suatu produk sebagai identifikasi unik di antara semua produk dari pabrik yang sama.  Alfanumerik "mpn":
"PI12345NTEREST"
opsional

Karakteristik produk opsional

Nama kolom Keterangan Sintaks/nilai yang didukung Contoh Persyaratan

color

Warna utama produk   biru opsional
gender Jenis kelamin yang dikaitkan dengan produk. Harus salah satu dari nilai berikut jika dikirim: 'male', 'female', 'unisex' male

female

unisex
female opsional
age_group Kelompok umur untuk menerapkan rentang demografi pada produk. Harus salah satu dari nilai berikut: 'newborn', 'infant', 'toddler', 'kids', 'adult' newborn

infant

toddler

kids

adult
adult opsional
material Bahan yang digunakan untuk membuat produk.   katun opsional
pattern Deskripsi pola yang digunakan untuk produk.   kotak-kotak opsional
size Ukuran produk.   M opsional
size_type Deskripsi tambahan untuk ukuran. Harus salah satu dari nilai berikut jika dikirim: 'regular', 'petite', 'plus', 'big_and_tall', 'maternity' regular
petite
plus
big_and_tall
maternity
reguler opsional
size_system Mengindikasikan sistem ukuran negara tempat Anda mengirimkan produk. Kode negara

AS

Inggris

opsional

Data pengiriman dan pajak opsional

Nama kolom Keterangan Sintaks/nilai yang didukung Contoh Persyaratan
tax Setiap grup atribut pajak dapat terdiri atas 4 subatribut: country:region:rate (harus ada):tax_ship
Semua tanda titik dua harus ada bahkan untuk nilai yang kosong.
country:region:rate(required):tax_ship US:1025433:6.00:y opsional
shipping Setiap grup atribut penayangan dapat terdiri dari 4 subatribut: negara, wilayah, layanan, dan harga (wajib).
Semua titik dua, bahkan untuk nilai kosong bersifat wajib.
country:region:service:price(required)

US:CA:Ground:0 USD

US::Express:13.12

opsional

shipping_weight

Berat produk. Pastikan ada spasi di antara string numerik dan metrik. <numeric> <metric> 3 kg
5 lbs
opsional
shipping_width Lebar paket yang dibutuhkan untuk mengirimkan produk. Pastikan ada spasi di antara string numerik dan metrik. <numeric> <metric> 16 inci opsional
shipping_height Tinggi paket yang dibutuhkan untuk mengirimkan produk. Pastikan ada spasi di antara string numerik dan metrik. <numeric> <metric> 12 inci opsional

Tanda produk dewasa opsional

Nama kolom Keterangan Sintaks/nilai yang didukung Contoh Persyaratan
adult Tetapkan atribut ini ke TRUE jika Anda mengirimkan item yang dianggap "dewasa". Item ini tidak akan ditampilkan di Pinterest. TRUE
FALSE
true opsional

Label kustom opsional

Pengelompokan produk secara kustom. Hal ini dapat digunakan untuk berbagai tujuan seperti musiman, promosi, penjualan terbaik. Kami menerima hingga 5 label kustom yang berbeda.

Anda akan dapat membuat grup produk pada Katalog menggunakan label kustom.

Nama kolom Keterangan Sintaks/nilai yang didukung Contoh Persyaratan
custom_label_0 Pengelompokan produk secara kustom. Maksimal 1000 karakter

Penjualan terbaik

Promosi musim panas

opsional
custom_label_1 Pengelompokan produk secara kustom. Maksimal 1000 karakter   opsional
custom_label_2 Pengelompokan produk secara kustom. Maksimal 1000 karakter   opsional
custom_label_3 Pengelompokan produk secara kustom. Maksimal 1000 karakter   opsional
custom_label_4 Pengelompokan produk secara kustom. Maksimal 1000 karakter   opsional

Bidang iklan shopping opsional

Nama kolom Keterangan Sintaks/nilai yang didukung Contoh Persyaratan
ad_link Memungkinkan pengiklan untuk menentukan URL terpisah yang dapat digunakan untuk melacak lalu lintas dari iklan shopping Pinterest. Harus mengirimkan URL penuh termasuk pelacakan, jangan hanya mengirimkan parameter pelacakannya. Saat ini kami tidak mendukung pelacakan tayangan. Harus dimulai dengan http:// atau https:// string URL https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest opsional
condition Kondisi produk. Harus salah satu dari nilai berikut: 'new', 'used', 'refurbished'. new
used
refurbished
new opsional
google_product_category Penetapan kategori produk berdasarkan pada Taksonomi Produk Google yang distandarkan. Ini merupakan taksonomi yang telah ditetapkan. Baik nilai teks dan kode numerik diterima. Taksonomi lengkap Pakaian & Aksesori > Pakaian > Kemeja & Atasan
212
opsional

 

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

 

Menyiapkan tag Pinterest

Tag Pinterest adalah sebuah kode Javascript yang Anda tempatkan di situs Anda untuk mengumpulkan wawasan konversi dan sekaligus membangun target audiens berdasarkan tindakan yang orang lakukan di situs Anda.

Pastikan untuk mengirim bidang khusus belanja melalui tag Pinterest.

  • Harus memiliki tag Pinterest yang diimplementasikan dengan jenis konversi berikut: PageVisits , AddToCart , dan Checkout 
  • Harus meneruskan data peristiwa untuk “product_id” as sebagai atribut untuk PageVisit, AddToCart, dan Checkouts
    • Product_id harus dilewatkan di bawah item baris (tidak akan terlihat di halaman tampilan Konversi).
    • Gunakan Ekstensi Chrome Tag Helper untuk memeriksa ulang apakah Anda memiliki ID produk yang dilewatkan di halaman detail produk.
  • Data product_id yang dilewatkan di tag harus cocok dengan "item_group_id" atau "id" yang disediakan dalam sumber data
  • Minimal 100K PageVisit gabungan dan peristiwa AddtoCart dalam 7 hari terakhir melewatkan kembali ID produk
     

Apa langkah selanjutnya?

Lihat panduan Menyerap sumber data untuk mempelajari cara menghubungkan sajian produk ke Pinterest.

Masih butuh bantuan?
Hubungi Kami