同步中繼欄位
AI 概覽
瞭解如何在 Tipo Sync 中,將商品與款式的 metafield 從 Source store 同步到 Destination store。您需要在 Source store 開啟 metafield 分享,並在 Destination store 開啟 metafield 同步,然後使用 namespace.key 選擇要同步的 metafield。兩間商店的資料類型必須完全一致。
查看更多收合
- 不支援 Reference 類型與 MetaObject;兩間商店的 metafield 資料類型必須一致。
- 在 Source store 中開啟 Settings,開啟 Share Metafields,選擇 Product 或 Variant 資源,並以 namespace.key 新增定義。
- 在 Destination store 中開啟 Stores,開啟連線詳細資料,開啟 Metafields sync 並選擇資源。
- 點選 Save;缺少的定義會自動在 Destination store 建立。
- Source 的空值絕不會覆寫 Destination 既有的值。
由 AI 產生的摘要,可能有錯誤,請參閱下方的完整指南。
本指南說明如何在 Tipo 應用程式中,將中繼欄位從 Source 商店同步到 Destination 商店。
ℹ️ 什麼是中繼欄位?
Section titled “ℹ️ 什麼是中繼欄位?”- 商品中繼欄位
- 款式中繼欄位(若您啟用此功能)
Tipo 應用程式可以同步以下內容的中繼欄位:
- 材質、尺寸表、規格
- 自訂徽章(例如「best_seller」)
- 佈景主題或應用程式使用的額外商品詳細資料
中繼欄位是 Shopify 中用來儲存額外商品資料的自訂欄位,例如:
✅ 支援的中繼欄位類型
Section titled “✅ 支援的中繼欄位類型”- 多行文字
- 格式化文字
- 整數
- 小數
- 日期和時間
- 日期
- 尺寸
- 體積
- 重量
- 是或否
- 評分
- URL
- 金額
- 連結
- JSON
🚫 目前尚未支援:
參照類型(例如商品參照、商品系列參照)目前尚未支援。
🛠️ 步驟 1:在 Source 商店設定中繼欄位
Section titled “🛠️ 步驟 1:在 Source 商店設定中繼欄位”- 開啟應用程式 > 點選 Settings > 開啟 Share Metafields
- 選擇您想分享的資源:
- Product resource – 分享商品中繼欄位。
- Variant resource – 分享款式中繼欄位。
- 新增特定的中繼欄位定義,以限制要分享哪些中繼欄位。
-
點選 Browse metafields 圖示,或
-
依下列格式輸入中繼欄位定義:
namespace.key
-
例如:
``` custom.materialseo.titlespecifications.weight ```4. Click Save to update the changes


🛠️ 步驟 2:在 Destination 商店設定中繼欄位
Section titled “🛠️ 步驟 2:在 Destination 商店設定中繼欄位”- 開啟應用程式 > 點選 Stores > 點選來源商店的網址,開啟連線詳細資料

- 開啟 Metafields sync
- 選擇要同步的內容
在 Allow data 下,選擇其中一項或兩項皆選:
- Product Resource → 同步商品中繼欄位
- Variant Resource → 同步款式中繼欄位
- 點選右側的搜尋圖示,查看所有支援的中繼欄位 > 點選 Select valid metafield to sync 按鈕


- 點選 Save 以更新變更
🔄 同步期間會發生什麼事
Section titled “ 🔄 同步期間會發生什麼事”1) 如果 Destination 商店沒有該中繼欄位定義
Section titled “1) 如果 Destination 商店沒有該中繼欄位定義”應用程式會在需要時,自動在 Destination 商店中建立該中繼欄位定義。
建立完成後,同步的中繼欄位值就會顯示在 Destination 商店的商品/款式上。
2) 如果中繼欄位存在,但尚未「結構化」(非結構化中繼欄位)
Section titled “2) 如果中繼欄位存在,但尚未「結構化」(非結構化中繼欄位)”在某些情況下,即使中繼欄位尚未在 Destination 商店中完整定義或結構化,也可能會被同步。
若要在 Shopify Admin 中查看這些中繼欄位:
- 開啟商店 Settings → Metafields and metaobjects
- 選擇 Product(或 Variant)
- 開啟 View unstructured metafields
💡 提示:您之後可以手動定義/結構化這些中繼欄位,讓商店資料保持整潔一致。

3) 如果 Source 商店沒有值,Destination 不會被覆寫
Section titled “3) 如果 Source 商店沒有值,Destination 不會被覆寫”如果中繼欄位存在於 Destination,但 Source 的值是空的,Tipo Sync 不會覆寫 Destination 的值。
4) 資料類型必須相符(非常重要)
Section titled “4) 資料類型必須相符(非常重要)”Source 與 Destination 之間的中繼欄位資料類型必須完全相符。
資料類型不相符的範例:
single_line_text_field與multi_line_text_fieldnumber_integer與number_decimalproduct_reference與text
⚠️ 如果資料類型不相符,同步可能會失敗,或略過該中繼欄位。
📌 範例:同步商品中繼欄位「Material」
Section titled “📌 範例:同步商品中繼欄位「Material」”您想使用我們的應用程式,將名為 Material 的自訂商品中繼欄位(例如「Cotton」、「Leather」、「Wool」)從 Source Store 同步到 Destination Store。
步驟 1:在 Shopify 中定義中繼欄位
Section titled “步驟 1:在 Shopify 中定義中繼欄位”在您的 Source Store 中:
- 前往 Shopify Admin > 開啟商店 Settings > Metafields and metaobjects > 選擇 Product(或 Variant)
- 點選 Add definition(若尚未建立)> 填寫中繼欄位定義:
- Name:Material
- Namespace:
custom - Key:
material - Type:Single line text
=> 這會得到完整的中繼欄位鍵值:custom.material
請在您的 Destination Store 中重複此步驟(鍵值和類型必須相同)。

步驟 2:為商品新增中繼欄位資料
Section titled “步驟 2:為商品新增中繼欄位資料”在您的 Source Store 中,前往某項商品並向下捲動至 Metafields > 在 Material 下輸入:Cotton
這項商品現在擁有中繼欄位 custom.material = "Cotton"。

步驟 3:在 Tipo 應用程式中設定同步
Section titled “步驟 3:在 Tipo 應用程式中設定同步 ”- 在 Destination Store 中開啟我們的應用程式 > 前往 Connect Configuration > Metafield Sync
- 選擇 Specific Metafields > 輸入完全一致的中繼欄位鍵值:
custom.material

結果
- 我們的應用程式會在 Source Store 中找到
custom.material - 如果 Destination 的商品中不存在該欄位,應用程式會建立它
=> 結果:兩間商店都會有custom.material = "Cotton" - 如果 Destination 已存在該欄位但 Source 為空,我們不會覆寫該值
Q1:如何在您的商店中設定 namespace.key?
Section titled “Q1:如何在您的商店中設定 namespace.key?”若要同步特定的中繼欄位,您需要以此格式輸入中繼欄位定義鍵值:namespace.key(例如:custom.color)。
以下是在 Shopify 管理後台中找到它的方式:
- 前往 Shopify Admin >,進入 Settings > Custom Data > Products
- 點選您想同步的中繼欄位
→ 您會看到 Namespace 與 Key 的值 - 將兩者以此格式組合:
namespace.key
→ 範例:custom.description
Q2:為什麼我的中繼欄位沒有同步?
Section titled “Q2:為什麼我的中繼欄位沒有同步?”如果您的中繼欄位沒有正確同步,可能是下列其中一個原因:
- 未啟用中繼欄位同步
請確認兩間商店都已開啟中繼欄位同步:- 在 Source Store 中啟用 Share Metafields。
- 在 Destination Store 中啟用 Receive Metafields。

- 尚未新增中繼欄位定義鍵值
除了啟用中繼欄位同步之外,您還必須新增想要同步的中繼欄位定義鍵值(namespace.key)。
- 前往 Settings → Share Metafields
- 確認已勾選 Enable
- 在 Allow data 下,以此格式新增中繼欄位定義:
namespace.key
範例:custom.material

- 不支援的中繼欄位類型
部分中繼欄位資料類型不受支援,例如 Reference types 或 MetaObjects。
紅色:應用程式無法同步的不支援中繼欄位

- 兩間商店的中繼欄位類型不相符
Source 與 Destination 的中繼欄位必須具有相同的資料類型和結構。
常見的不相符情況包括:
- 其中一個中繼欄位是 Single line text,另一個卻是 Multi-line text。
- 其中一個中繼欄位使用 Single value,另一個卻使用 List of values。
若要解決這些問題,請確認兩間商店的中繼欄位具有相同的 namespace、key 和資料類型,然後再試著同步一次。
🙋 還需要協助嗎?
如果您仍需要協助,歡迎隨時寄信至 hi@tipo.io 與我們聯繫,我們很樂意為您提供進一步的協助。