WooCommerce 美安整合

基本流程說明

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

  1. 設定基本資料 Offer ID 和 Advertiser ID，以及 Commission Rate
  2. 設定防詐騙提示訊息於頁面和結帳完成頁面(此功能不包含在外掛中)
  3. 準備產品 XML，提交給美安，進行商品上架
  4. 測試 RID 和 Click_ID 能否正確被記錄
  5. 測試完成訂單後，於訂單完成頁面有正確內嵌程式碼。
  6. 測試取消訂單
  7. 以上經過美安技術人員測試無誤後，等待正式開通

執行環境需求

PHP > 7.4

WooCommerce 3.x

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

💡
執行美安 API 需要綁定 IP，因此建議主機需要有固定 IP，若沒有固定 IP，當 IP 變動時，您需要重新請美安進行允許名單的 IP 設定，功能才能正常運作。

詳細設定說明

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

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

所在國家請選擇您商店所在的國家或地區，不同國家或地區所使用的美安 API 會不一樣。

image

2.設定防詐騙宣導訊息 (台灣)

若您是美安台灣的的夥伴商店，需設置防詐騙宣導訊息。

防詐騙訊息主要有兩個部份：一般頁面和結帳完成感謝頁面

2.1 一般頁面

請先建立一個空白頁面，並加入防詐騙宣導內容。防詐騙宣導內容可參考此範例：防詐騙宣導

2.2 感謝頁面

您可以使用 Code Snippets 或是 FluentSnippets  來插入程式碼片段，您可以自行修改文字內容

add_action('woocommerce_thankyou', 'shopcom_add_content_thankyou', 5);

function shopcom_add_content_thankyou(){
	echo '<h2 class="h2thanks">提醒您：</h2><p class="pthanks">以下都是詐騙:訂單設錯、訂單金額有誤、設成分期每月扣款、重覆訂購多筆、宅配或超商出錯、簽收單牽成簽帳單、條碼刷錯、重複扣款。歹徒會以更改訂單要求退費給您為由，要求您操作ATM，這些都是詐騙手法。若遇可疑來電，隨時可撥打165反詐騙諮詢專線或與客服聯繫。</p>';
}

3.產生產品 XML 檔案

若要產生產品 XML 檔案，請先隨意儲存一次產品，即可產生。請注意產品主圖格式需要為 jpg，且每一個產品皆需要有貨號(SKU)，和產品說明。

image

4.提交商品 XML

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

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

您可以在設定頁面中的商品設定找到商品XML連結。

image
💡
ps.若無法產生此檔案，請確認uploads資料夾有建立資料夾和寫入的權限，若權限不足，請調整網站目錄權限，或是手動建立wooshop資料夾。
💡
注意1: 請注意產品主圖格式需為 jpg，若圖片為 png，該產品將不會包含在 XML 檔案中
💡
注意2: 每個商品皆需要設定貨號 (SKU)和產品說明

4.1 將可變商品分開顯示

若您的商品為可變商品，可將可變商品的不同變化規格分開於xml中顯示，請在商品設定中，將變化類型分開顯示在XML檔案中選項打勾。

4.2 客製化商品說明

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

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

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

image

4.3 自訂商品資料

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

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

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

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

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

image

6.訂單設定

請分別設定要執行美安訂單建立和取消的訂單狀態。當訂單狀態改變為設定的狀態，就會自動執行美安相關操作。若您希望當執行美安 API 失敗時收到通知，請啟用 Email 通知功能。

image

操作成功或失敗都會再訂單備註中找到訊息

image

7.匯出報表

(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

設定排除 Varnish 快取

若你的網站安裝在 Cloudways 主機，預設會啟用 Varnish 快取，會導致外掛紀錄的 cookie 無法正常被讀取。請設定排除 cookie 在 Varnish 快取中。外掛紀錄的 cookie 名稱如下：

  • wooshop_rid
  • wooshop_click_id