返回教學中心

WooCommerce

WooCommerce 串接教學

填商店網址、在自己的商店後台按「核准」就能串接 WooCommerce 訂單,不用自己產生或複製 API 金鑰。

預計 3 分鐘難度:簡單

在 Admetry 串接 WooCommerce 不用自己產生或複製 API 金鑰:到「連接器」頁的 WooCommerce 卡片點「立即連接」,選好資料歸屬客戶、填商店首頁網址(https://),按「前往商店授權」;畫面會跳到你商店的 WordPress 後台,以商店管理員登入後按「核准」唯讀存取,就會自動回到 Admetry 並開始第一次訂單同步。Admetry 只申請唯讀權限,不會修改商店任何資料;若主機或安全性外掛擋下授權,也可在連接視窗改用手動貼上唯讀金鑰。串好後訂單營收可與廣告成效放在同一儀表板比對。

1

確認帳號與網址

用能登入 WordPress 後台、且可管理 WooCommerce 的帳號(通常是商店管理員)操作;商店網址必須是 https:// 開頭。

官方文件

官方授權畫面

WooCommerce

步驟 1
1建立客戶
2準備權限
3授權/填欄位
4同步驗證
確認使用正確平台帳號授權

畫面會離開 Admetry 前往官方平台。請使用擁有廣告、分析或商店讀取權限的帳號登入。

授權帳號屬於正確客戶
只同意這個功能需要的權限
授權後會自動回到 Admetry
WooCommerce 權限不足時不要硬接
往下一步前確認: 官方授權頁顯示同意成功,並回到 Admetry。
2

填商店網址並前往授權

在「連接器」頁的 WooCommerce 卡片點「立即連接」,選好資料歸屬客戶、填商店首頁網址(例:https://shop.example.com),按「前往商店授權」。

官方授權畫面

WooCommerce

步驟 2
1建立客戶
2準備權限
3授權/填欄位
4同步驗證
確認使用正確平台帳號授權

畫面會離開 Admetry 前往官方平台。請使用擁有廣告、分析或商店讀取權限的帳號登入。

授權帳號屬於正確客戶
只同意這個功能需要的權限
授權後會自動回到 Admetry
WooCommerce 權限不足時不要硬接
往下一步前確認: 官方授權頁顯示同意成功,並回到 Admetry。
3

在商店後台按「核准」

畫面會跳到你商店的 WordPress 後台(未登入會先要求登入),列出「Admetry(組織代碼 XXXXXXXX)」申請的唯讀(Read)權限:檢視訂單、商品、顧客、優惠券等,這是 WooCommerce 唯讀金鑰的固定範圍,Admetry 只用來讀訂單。組織代碼是你 Admetry 組織的 8 碼編號(連接視窗裡會寫出來)。核准畫面上的名稱與組織代碼只是授權網址裡的一段文字、拿到網址的人都能改,所以單看名稱或組織代碼證明不了請求是誰發出的。只核准你自己剛從自己的 Admetry 帳號按下「前往商店授權」所開啟的畫面,並確認畫面上的組織代碼與連接視窗顯示的一致,再按「核准」(英文介面為 Approve);不是你剛發起的、組織代碼對不上或有任何疑問,就不要按「核准」、直接關掉那個頁面。Admetry 不會修改商店任何資料。

官方授權畫面

WooCommerce

步驟 3
1建立客戶
2準備權限
3授權/填欄位
4同步驗證
確認使用正確平台帳號授權

畫面會離開 Admetry 前往官方平台。請使用擁有廣告、分析或商店讀取權限的帳號登入。

授權帳號屬於正確客戶
只同意這個功能需要的權限
授權後會自動回到 Admetry
WooCommerce 權限不足時不要硬接
往下一步前確認: 官方授權頁顯示同意成功,並回到 Admetry。
4

自動回到 Admetry 開始同步

核准後會自動回到 Admetry,連接已建立、第一次訂單同步已在背景開始。目前為手動同步:之後要更新資料,請到連接器頁按「同步」;排程自動同步開發中。

同步與資料驗證畫面

WooCommerce

步驟 4
1建立客戶
2準備權限
3授權/填欄位
4同步驗證
先看品質檢查,再看正式儀表板

Admetry 會檢查日期、金額、必要欄位、幣別、客戶歸屬與去重;失敗資料不應混入正式報表。

沒有出現需重新授權或權杖錯誤
寫入筆數大於 0 才代表資料進了儀表板(標示入庫開發中的平台目前寫入 0 筆)
沒有高風險 quality warning
目前為手動同步:之後要更新數字請再按「同步」
往下一步前確認: 看得懂同步結果的寫入筆數與品質警示。

訂單核心欄位

目前支援範圍與限制

目前為手動同步:連接完成時自動首次同步,之後按「同步」更新。目前同步 WooCommerce REST API orders;商品/顧客/退款/webhook 即時同步仍需後續擴充。

目前同步資料

  • • orders

必要權限 / 欄位

  • • WooCommerce 唯讀(Read)存取授權
  • • shop_url

資料驗證

  • • order id 去重
  • • HTTPS/API 可用性
  • • 客戶歸屬檢查

歸因限制

  • • 目前不是完整 products/customers/refunds/webhooks。
  • • UTM 欄位依商店外掛與追蹤設定而定。

常見問題

需要安裝額外外掛嗎?
不需要。使用 WooCommerce 內建的授權頁與 REST API 即可。
按了核准卻出現錯誤、沒有回到 Admetry?
部分主機或安全性外掛會擋下 WooCommerce 對外傳送金鑰(此時 WooCommerce 會自動刪掉剛產生的金鑰)。可改用手動方式:到 WordPress 後台「WooCommerce → 設定 → 進階 → REST API」新增一組權限為「讀取」的金鑰,回到 Admetry 連接視窗點「已經有 API 金鑰?改用手動貼上」貼上即可。
目前會同步哪些資料?
目前同步訂單(編號、時間、金額、幣別、狀態、品項數);商品、顧客、退款、UTM 來源與即時 webhook 尚未支援。
支援多店嗎?
支援。每間店各建一個連接。

準備好開始了?

7 天免費體驗,正式訂閱透過綠界 ECPay 付款。

免費註冊