- 基本流程說明
- 執行環境需求
- 詳細設定說明
- 1.設定 Offer ID 和 Advertiser ID,以及 Commission Rate
- 2.設定防詐騙宣導訊息 (台灣)
- 2.1 一般頁面
- 2.2 感謝頁面
- 3.產生產品 XML 檔案
- 4.提交商品 XML
- 4.1 將可變商品分開顯示
- 4.2 客製化商品說明
- 4.3 自訂商品資料
- 5.檢視 RID 與 Click_ID
- 6.訂單設定
- 7.匯出報表
- 設定排除 Varnish 快取
基本流程說明
美安整合大致分為幾個階段,您的美安窗口人員應該會給予您相關的資訊
- 設定基本資料 Offer ID 和 Advertiser ID,以及 Commission Rate
- 設定防詐騙提示訊息於頁面和結帳完成頁面(此功能不包含在外掛中)
- 準備產品 XML,提交給美安,進行商品上架
- 測試 RID 和 Click_ID 能否正確被記錄
- 測試完成訂單後,於訂單完成頁面有正確內嵌程式碼。
- 測試取消訂單
- 以上經過美安技術人員測試無誤後,等待正式開通
執行環境需求
PHP > 7.4
WooCommerce 3.x
請將網站時區設為台灣 (UTC+8)
詳細設定說明
1.設定 Offer ID 和 Advertiser ID,以及 Commission Rate
美安會提供 Offer ID 和 Advertiser ID,請於設定頁面輸入並儲存設定。
所在國家請選擇您商店所在的國家或地區,不同國家或地區所使用的美安 API 會不一樣。
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),和產品說明。
4.提交商品 XML
儲存後在以下路徑可以找到商品 XML,更新產品資訊後,將此網址提供給美安
提交網址範例: https://www.yoursite.com.tw/wp-content/uploads/wooshop/products.xml (請將 www.yoursite.com.tw 替換為您的網址)
您可以在設定頁面中的商品設定找到商品XML連結。
4.1 將可變商品分開顯示
若您的商品為可變商品,可將可變商品的不同變化規格分開於xml中顯示,請在商品設定中,將變化類型分開顯示在XML檔案中選項打勾。
4.2 客製化商品說明
有些主題在商品內容的部分,可能會透過一些短代碼(shortcode)來顯示內容,但是這樣的短代碼在美安的平台是無法顯示的。
所以如果您的商品內容包含短代碼(shortcode),或是透過page builder(Visual Composer、Elementor等)來製作的,建議您另外新增商品說明,避免美安的商品頁無法正確顯示您的商品內容。
另外要注意的是,美安規定產品清單xml中的商品描述內容,最多只能有4000字元(包含文字內容,程式碼標籤等等),所以如果您的商品內容過長,建議還是手動新增商品說明。
4.3 自訂商品資料
若您要更新產品資料,可在後台產品編輯頁找到以下內容,其他內容則為 WooCommerce 內建內容
例如產品名稱、分類、價格、特價、簡短說明和特色圖片(不可為 png 格式,請使用 jpg 格式)等
編輯完按下更新,即會更新產品 XML,完成後即可將產品 XML 網址提交給美安窗口。
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.
6.訂單設定
請分別設定要執行美安訂單建立和取消的訂單狀態。當訂單狀態改變為設定的狀態,就會自動執行美安相關操作。若您希望當執行美安 API 失敗時收到通知,請啟用 Email 通知功能。
操作成功或失敗都會再訂單備註中找到訊息
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筆訂單資料,接著就可以進行匯出。
請注意每個外掛的操作方式都不太一樣,請確認您使用的外掛支援客製化欄位。
設定排除 Varnish 快取
若你的網站安裝在 Cloudways 主機,預設會啟用 Varnish 快取,會導致外掛紀錄的 cookie 無法正常被讀取。請設定排除 cookie 在 Varnish 快取中。外掛紀錄的 cookie 名稱如下:
- wooshop_rid
- wooshop_click_id