WooCommerce 美安整合

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

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

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

執行環境需求：

PHP > 5.4

WooCommerce 3.x

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

(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筆訂單資料，接著就可以進行匯出。

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