商家可能會想將產品化為產品 Pin，上傳到 Pinterest。產品 Pin 採用特別格式，告知在 Pinterest 上瀏覽內容的使用者可從中購買產品。產品 Pin 內包含產品標題和說明，以及價格和供應情況資訊。
將零售目錄的資料來源新增至 Pinterest，以產品 Pin 的形式一次上傳許多產品。接著，您就能透過購物廣告在 Pinterest 宣傳產品。您可以選擇提供託管資料來源的網址連結，或手動上傳資料來源。
新增零售目錄前，您必須先完成以下事項：
如果您不符合上述規定，請深入瞭解
零售目錄的運作方式取決於您如何新增資料來源，系統會從您新增的資料來源存取您的零售目錄。
如果您提供託管資料來源的網址連結，系統會每日存取您的資料來源，為零售目錄中的各個產品動態建立產品 Pin。請確認更新後的資料來源每天都能順利存取，以便將產品詳細資料維持於最新狀態。您甚至可以事先排定資料擷取時間。
如果您手動上傳資料來源，系統會在您上傳及更新資料來源時加以存取，為您零售目錄中的各個產品建立產品 Pin 或更新現有 Pin 的中繼資料。
如有錯誤，我們會立即通知您。您必須盡快檢查並修正錯誤，以確保產品資訊正確無誤且維持於最新狀態。發生錯誤的原因不盡相同，可能是整個動態未更新、動態的某些品項未更新，或您必須變更部分格式。
每個零售目錄最多可處理 2 千萬件產品。如果您有超過 2 千萬件產品，請
唯有您選擇託管資料來源，才需留意這項資訊。如果您選擇手動上傳資料來源，可略過這個區段的內容。
資料來源必須託管於您自有的 FTP/SFTP/WebDAV 伺服器，或使用 HTTP/HTTPS 直接下載連結。該連結必須可由使用者代理程式存取，而且不得設有 IP 或 SSH 金鑰白名單。如果使用直接下載連結，不能要求存取者必須額外瀏覽才能存取檔案。
您的零售目錄必須包含以下欄位，格式必須與實際呈現時相同。如果缺少欄位或格式不正確，系統將無法順利擷取整個零售目錄。
| 直欄名稱 | 說明 | 語法/支援的值 | 範例 |
|---|---|---|---|
| id |
代表產品的專屬 ID。 |
最多 127 個字元。 | DS0294-L |
| title | 產品名稱 (必須與登陸頁面的產品名稱相同，包含款式的詳細資料，例如顏色和尺寸)。 | 最多 500 個字元。 | 女裝丹寧襯衫，L 碼 |
| description | 產品說明。 | 純文字 (非 HTML) 最多允許 10,000 個字元。 | 以頂級日本丹寧布製成的休閒合身牛仔襯衫。 |
| 連結 | 產品登陸頁面 (需直接導向同一產品並顯示相同資料)。 |
字串網址 最多不超過 511 個字元，且網址必須以 http:// 開頭 (不建議強制阻擋存取行為)。 |
https://www.example.com/cat/womens-clothing/denim-shirt-0294 |
| image_link |
主要產品圖片連結 (至少 75x75 像素，可由我們的使用者代理程式存取，且非範本或預留位置圖片)。 如果之後變更圖片，便必須使用不同連結，否則圖片無法更新。 |
字串網址 最多 2,000 個字元，開頭必須是 http:// 或 https:// (編碼或移除逗號)。 建議：以引號包住字串。 |
https://scene.example.com/image/image.jpg |
| price |
產品價格 (應反映產品的真實成本，如果價格的幣別不是美元，則須以 ISO-4217 代碼標明，否則會預設為美元)。 |
<numeric> <ISO 4217> 幣別可放在價格數值前方或後方，加上空格或不含空格皆可，並採用 ISO-4217 標準代碼。請勿使用數值 0 或幣別符號。 |
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 | 產品的供應情況。 |
應為以下任一值： in stock |
in stock |
| item_group_id (唯有產品具有多種款式時才須提供) | 產品的母 ID。 | 最多 127 個字元。 | DS0294 |
您可為零售目錄新增選填欄位，以協助提升產品和使用者的對應準確度。您提供的資訊越詳細，使用者就能看見與其相關程度越高的 Pin。如要深入瞭解選填欄位，請查看下方資訊。
| 直欄名稱 | 說明 | 語法/支援的值 | 範例 |
|---|---|---|---|
| product_type | 依據自訂產品分類給予產品的分類。 |
最多可包含 5 個子類別，以 1,000 個字元為限，必須以 > 分隔，並在前後加上空格 (系統無法辨識逗號或垂直線等其他分隔符號)。 |
服裝 > 女裝 > 襯衫 > 丹寧 |
| additional_image_link |
最多可連結產品的其他 10 張圖片 (至少 75x75 像素，可由我們的使用者代理程式存取，且非範本或預留位置圖片)。 系統會為每張額外的圖片連結建立新的 Pin。如果之後變更圖片，便必須使用不同連結，否則圖片無法更新。 |
每張最多 2,000 個字元，開頭必須是 http:// 或 https:// (編碼或移除逗號)。 建議：以引號包住字串。 |
"https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg" |
| mobile_link | 針對行動裝置完成最佳化的登陸頁面版本。 | 開頭必須是 http:// 或 https://。 | https://m.example.com/cat/womens-clothing/denim-shirt-0294 |
| sale_price |
產品的折扣價格 (應低於原價，如果價格的幣別不是美元，則須以 ISO-4217 代碼標明，否則會預設為美元)。 如果提供此欄位資料，則特價將會被視為品項的目前價格。 |
<numeric> <ISO 4217> 幣別可放在價格數值前方或後方，加上空格或不含空格皆可，並採用 ISO-4217 標準代碼。請勿使用數值 0 或幣別符號。 |
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 | 產品的平均評分。 |
<numeric> 介於 1 到 5 之間。 |
5 |
| number_of_ratings | 產品的評分數。 | <numeric> | 2 |
| number_of_reviews | 產品的評價數。 | <numeric> | 4 |
| description_html |
產品的 HTML 說明。 建議：如果說明超過 200 個字元，建議您使用這種方法。 如果您提供此欄位，系統會使用該欄位，而非必填的說明欄位。 |
HTML 格式 | <body> <h1>我的產品</h1> <p>立即購買</p> </body> |
| video_link |
產品影片的託管連結。 連結影片的檔案類型是 .mp4、.mov或 .m4v。 檔案大小須為 2GB 以內。 |
字串網址 最多 2,000 個字元 (字元數應計入開頭的 http:// 或 https://) |
https://www.example.com/example.mp4 |
| 直欄名稱 | 說明 | 語法/支援的值 | 範例 |
|---|---|---|---|
| item_group_id | 產品的母 ID。 | 最多 127 個字元。 | DS0294 |
|
brand |
產品的品牌。 | 最多 100 個字元。 | Josie’s Denim |
| gtin | 不重複的通用產品識別碼。 | 數值 須遵循 GTIN 準則 | 3234567890126 |
| mpn | 產品的製造商零件編號 |
最多 70 個英數字元 |
"mpn": "PI12345NTEREST" |
| 直欄名稱 | 說明 | 語法/支援的值 | 範例 |
|---|---|---|---|
|
color |
產品主要顏色。 | 最多 30 個字元。 | blue |
| gender | 產品適合的性別。 | 應為以下任一值： male female unisex |
male |
| age_group | 產品適合的年齡。 |
應為以下任一值： newborn |
newborn |
| material | 產品的製作材料。 | 最多 30 個字元。 | cotton |
| pattern | 產品的樣式。 | 最多 30 個字元。 | plaid |
| size | 產品的尺寸。 | 最多 30 個字元。 | M |
| size_type | 產品尺寸的其他說明。 |
應為以下任一值： regular |
regular |
| size_system | 產品所採用的尺寸系統。 | 國家/地區代碼。 |
美國 |
| alt_text | 產品主要圖片的說明。 | 一或多個替代文字值，以半形逗號分隔。替代文字值的數量應與符合 image_link 欄位中的圖片數量。逗號編碼應為 ,。如果替換文字包含逗號，請將其移除。逗號只能用來分隔多個替代文字。 | 淺藍色的針織流蘇嬰兒帽 |
| variant_names | 此產品的款式選項 (Pinterest 使用者會在 Pin 旁邊看到這些選項，並能加以選擇)。 | 依您希望的順序排列並以逗號分隔的文字。 | 顏色，尺寸 |
| variant_values | 產品此款式的值選項 (Pinterest 使用者會在 Pin 旁邊看到這些選項，如果有需要可自行選取)。 |
依您希望的順序排列並以逗號分隔的文字。 順序應與 variant_names 欄位一致。 |
紅色，小 |
| adult | 產品是否為成人產品。成人產品不會顯示於 Pinterest。 |
應為以下任一值： true |
False |
| 直欄名稱 | 說明 | 語法/支援的值 | 範例 |
|---|---|---|---|
| tax | 產品的稅務詳細資料 |
最多可包含四個元素：country、region、rate (以上三項為必填資訊) 以及 tax_ship (選填)。即便未選擇任何值也必須保留冒號。 country:region:rate(required):tax_ship |
US:1025433:6.00:y |
| shipping | 產品運送的詳細資料 |
最多可包含四個元素：country、region、service (以上三項為必填資訊) 以及 price (選填)。即便未選擇任何值也必須保留冒號。 country:region:service:price(必填) |
US::Express:13.12 |
|
shipping_weight |
產品的重量。 |
<numeric> <metric> 數值和單位之間務必要有空格。 |
5 磅 |
| shipping_width | 運送產品所需的包裝寬度。 |
<numeric> <metric> 數值和單位之間務必要有空格。 |
16 in |
| shipping_height | 運送產品所需的包裝高度。 |
<numeric> <metric> 數值和單位之間務必要有空格。 |
12 in |
| free_shipping_label |
是否要為產品提供免運費優惠。 如果要，請在 free_shipping_limit 欄位輸入 0。如果您只想在買家花費特定金額後才提供免運費優惠，請在 free_shipping_limit 欄位中輸入該金額。 |
應為以下任一值： true |
true |
| free_shipping_limit | 享產品免運費的最低訂購量。 |
<numeric> <ISO 4217> |
35USD |
| 直欄名稱 | 說明 | 語法/支援的值 | 範例 |
|---|---|---|---|
| custom_label_0 | 自訂產品群組 (最多五個) | 最多 200 個字元 |
夏季促銷 |
| custom_label_1 | 自訂產品群組 (最多五個) | 最多 200 個字元 | 暢銷商品 |
| custom_label_2 | 自訂產品群組 (最多五個) | 最多 200 個字元 | 新產品 |
| custom_label_3 | 自訂產品群組 (最多五個) | 最多 200 個字元 | 促銷中 |
| custom_label_4 | 自訂產品群組 (最多五個) | 最多 200 個字元 | 半價 |
| 直欄名稱 | 說明 | 語法/支援的值 | 範例 |
|---|---|---|---|
| ad_link | 可用來追蹤來自 Pinterest 購物廣告流量的連結。 |
字串網址 應傳送內含追蹤參數的完整網址，並非只有追蹤參數。 目前不支援追蹤曝光次數。 必須以 http:// 或 https:// 開頭 |
https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest |
| condition | 產品的狀態。 |
應為以下任一值： new |
new |
| google_product_category | 依據標準化 Google 產品分類給予產品的分類。 |
請參閱英文版完整分類。如需其他語言的分類，請前往 Google 支援中心。 文字值和數字代碼均可接受。 |
服飾配件 > 服裝 > 襯衫和上衣 21 |
請務必遵守我們的
瞭解如何