WooCommerce
WooCommerce 串接教學
填商店網址、在自己的商店後台按「核准」就能串接 WooCommerce 訂單,不用自己產生或複製 API 金鑰。
在 Admetry 串接 WooCommerce 不用自己產生或複製 API 金鑰:到「連接器」頁的 WooCommerce 卡片點「立即連接」,選好資料歸屬客戶、填商店首頁網址(https://),按「前往商店授權」;畫面會跳到你商店的 WordPress 後台,以商店管理員登入後按「核准」唯讀存取,就會自動回到 Admetry 並開始第一次訂單同步。Admetry 只申請唯讀權限,不會修改商店任何資料;若主機或安全性外掛擋下授權,也可在連接視窗改用手動貼上唯讀金鑰。串好後訂單營收可與廣告成效放在同一儀表板比對。
確認帳號與網址
用能登入 WordPress 後台、且可管理 WooCommerce 的帳號(通常是商店管理員)操作;商店網址必須是 https:// 開頭。
官方文件官方授權畫面
WooCommerce
畫面會離開 Admetry 前往官方平台。請使用擁有廣告、分析或商店讀取權限的帳號登入。
填商店網址並前往授權
在「連接器」頁的 WooCommerce 卡片點「立即連接」,選好資料歸屬客戶、填商店首頁網址(例:https://shop.example.com),按「前往商店授權」。
官方授權畫面
WooCommerce
畫面會離開 Admetry 前往官方平台。請使用擁有廣告、分析或商店讀取權限的帳號登入。
在商店後台按「核准」
畫面會跳到你商店的 WordPress 後台(未登入會先要求登入),列出「Admetry(組織代碼 XXXXXXXX)」申請的唯讀(Read)權限:檢視訂單、商品、顧客、優惠券等,這是 WooCommerce 唯讀金鑰的固定範圍,Admetry 只用來讀訂單。組織代碼是你 Admetry 組織的 8 碼編號(連接視窗裡會寫出來)。核准畫面上的名稱與組織代碼只是授權網址裡的一段文字、拿到網址的人都能改,所以單看名稱或組織代碼證明不了請求是誰發出的。只核准你自己剛從自己的 Admetry 帳號按下「前往商店授權」所開啟的畫面,並確認畫面上的組織代碼與連接視窗顯示的一致,再按「核准」(英文介面為 Approve);不是你剛發起的、組織代碼對不上或有任何疑問,就不要按「核准」、直接關掉那個頁面。Admetry 不會修改商店任何資料。
官方授權畫面
WooCommerce
畫面會離開 Admetry 前往官方平台。請使用擁有廣告、分析或商店讀取權限的帳號登入。
自動回到 Admetry 開始同步
核准後會自動回到 Admetry,連接已建立、第一次訂單同步已在背景開始。目前為手動同步:之後要更新資料,請到連接器頁按「同步」;排程自動同步開發中。
同步與資料驗證畫面
WooCommerce
Admetry 會檢查日期、金額、必要欄位、幣別、客戶歸屬與去重;失敗資料不應混入正式報表。
訂單核心欄位
目前支援範圍與限制
目前為手動同步:連接完成時自動首次同步,之後按「同步」更新。目前同步 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 付款。
免費註冊