美安串接技術文件版本:20200218
美安整合大致分為幾個階段,您的美安窗口人員應該會給予您相關的資訊
- 準備產品 XML, 提交給美安,進行商品上架
- 測試 RID 和 Click_ID 能否正確被記錄
- 測試完成訂單後,於訂單完成頁面有正確內嵌程式碼。
- 測試取消訂單
- 以上經過美安技術人員測試無誤後,等待正式開通
執行環境需求:
PHP > 5.4
WooCommerce 3.x
**主機需要有固定IP***
請將網站時區設為台灣(UTC+8)
0.請將此外掛上傳到 WP 網站,並啟用license。
1.設定 Offer ID 和 Advertiser ID,以及 Commission Rate
美安會提供 Offer ID 和 Advertiser ID,請於設定頁面輸入並儲存設定。
2.產生產品xml
啟用後請先隨意儲存一個商品。
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 網址提交給美安窗口。
4.1 將可變商品分開顯示
若您的商品為可變商品,可將可變商品的不同變化規格分開於xml中顯示,請在 Shop.com 的設定中,將 Seperate Variation Display in XML 打勾。
4.2 客製化商品說明
有些主題在商品內容的部分,可能會透過一些短代碼(shortcode)來顯示內容,但是這樣的短代碼在美安的平台是無法顯示的。
所以如果您的商品內容包含短代碼(shortcode),或是透過page builder(Visual Composer、Elementor等)來製作的,建議您另外新增商品說明,避免美安的商品頁無法正確顯示您的商品內容。
另外要注意的是,美安規定產品清單xml中的商品描述內容,最多只能有4000字元(包含文字內容,程式碼標籤等等),所以如果您的商品內容過長,建議還是手動新增商品說明。
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 會被記錄起來,管理者在後台的訂單內容頁可以找到此資訊
若此訂單因某種因素取消,請手動執行訂單未完成交易。若客戶只部分款款,可自行輸入退款金額。
退款動作會記錄於備註,方便店家日後查詢
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筆訂單資料,接著就可以進行匯出。
請注意每個外掛的操作方式都不太一樣,請確認您使用的外掛支援客製化欄位。