WooCommerce 美安整合

最新版本:v2.2.3 (changelog) 若您使用 1.0.x 版本請先見 changelog 的說明

美安串接技術文件版本:20200218

美安整合大致分為幾個階段,您的美安窗口人員應該會給予您相關的資訊

  1. 準備產品 XML, 提交給美安,進行商品上架
  2. 測試 RID 和 Click_ID 能否正確被記錄
  3. 測試完成訂單後,於訂單完成頁面有正確內嵌程式碼。
  4. 測試取消訂單
  5. 以上經過美安技術人員測試無誤後,等待正式開通

執行環境需求:

PHP > 5.4

WooCommerce 3.x

**主機需要有固定IP***

請將網站時區設為台灣(UTC+8)

0.請將此外掛上傳到 WP 網站,並啟用license。

1.設定 Offer ID 和 Advertiser ID,以及 Commission Rate

美安會提供  Offer ID 和  Advertiser  ID請於設定頁面輸入並儲存設定。

image

2.產生產品xml

啟用後請先隨意儲存一個商品。

image

3.提交產品 XML

儲存後在以下路徑可以找到產品xml,更新產品資訊後,將此網址提供給美安

提交網址範例:  https://www.yoursite.com.tw/wp-content/uploads/wooshop/products.xml  (請將 www.yoursite.com.tw 替換為您的網址)

ps.若無法產生此檔案,請確認uploads資料夾有建立資料夾和寫入的權限,若權限不足,請調整網站目錄權限,或是手動建立wooshop資料夾。

4.更新產品資料

若您要更新產品資料,可在後台產品編輯頁找到以下內容,其他內容則為WooCommerce內建內容

例如產品名稱、分類、價格、特價、簡短說明和特色圖片(不可為 png 格式,請使用 jpg 格式)等

編輯完按下更新,即會更新產品 XML,完成後即可將產品 XML 網址提交給美安窗口。

image

4.1 將可變商品分開顯示

若您的商品為可變商品,可將可變商品的不同變化規格分開於xml中顯示,請在 Shop.com 的設定中,將 Seperate Variation Display in XML 打勾。

image

4.2 客製化商品說明

有些主題在商品內容的部分,可能會透過一些短代碼(shortcode)來顯示內容,但是這樣的短代碼在美安的平台是無法顯示的。

所以如果您的商品內容包含短代碼(shortcode),或是透過page builder(Visual Composer、Elementor等)來製作的,建議您另外新增商品說明,避免美安的商品頁無法正確顯示您的商品內容。

另外要注意的是,美安規定產品清單xml中的商品描述內容,最多只能有4000字元(包含文字內容,程式碼標籤等等),所以如果您的商品內容過長,建議還是手動新增商品說明。

image

5.檢視 RID 與 Click_ID

消費者透過美安網站進到官網時,會透過美安網站上設定好的url進入官網。例如 https://www.yoursite.com.tw?RID=R6230296-u2854156120-v260209&Click_ID=102eb2f7d72c0ad7c4c38e1cd197a4

測試時可直接在網址列輸入您的網站網址,並在網址後加上 ?RID=123&Click_ID=456,來進行測試。

當使用者完成訂單後,RID 和 Click_ID 會被記錄起來,管理者在後台的訂單內容頁可以找到此資訊

若此訂單因某種因素取消,請手動執行訂單未完成交易。若客戶只部分款款,可自行輸入退款金額。

image

退款動作會記錄於備註,方便店家日後查詢

image

6.匯出報表

(2.x版本開始,測試階段需匯出報表,正式上線後不用匯出報表,美安會直接對帳)

注意:此外掛不包含訂單匯出功能

美安測試驗證時需匯出訂單報表,其中報表需包含 RID 與 Click_ID 資訊。

您可以使用任何支援自訂欄位(custom field)的匯出工具,像是 WP All Export (付費外掛) 或是  Advanced Order Export For WooCommerce (免費外掛)

這邊我們以 WP All Export 為範例。

選擇匯出的資料類型為 WooCommerce 訂單,並設定過濾條件。這邊我們要匯出的是包含 RID 與 Click_ID 的訂單,所以在篩選條件中選擇 _wooshop_rid 和 _wooshop_click_id 這兩個欄位

條件為不為空值(is not empty),過濾後顯示有9筆訂單資料,接著就可以進行匯出。

請注意每個外掛的操作方式都不太一樣,請確認您使用的外掛支援客製化欄位。

image