建置一個串接美安的購物網站(2021年4月版)

串接美安並不是簡單的工程,所以有些原本有提供串接美安的開店平台,也都陸續停止提供串接美安的服務。

由於串接美安的工程難度頗高,所以在經歷多次美安串接工程,協助很多網路工作室完成轉包的美安案件之後,我決定對於串美安的工程,作經驗豐分享,讓商家有一些了解,以便尋找廠商時能找到有能力完成任務的合作對象,所以整理了這篇文章。如果您也需要建置一個能串接美安的購物網站,請與我聯絡(Email : 24cc.com@gmail.com),我將採用 OpenCart 幫您建置,無須平台年費、無須交易手續費,可以百分之百取得原始程式碼。

美安的串接,需要進行的工程主要有五大項:

一、擷取參數

所謂擷取參數,是指當美安推薦了買家到您的網站時,連結網址會附帶美安的推薦參數 RID 及 Click_ID,所以合作商家的網站程式,必須能承接這兩組參數,寫入到 Cookie,即使買家進到網站後,瀏覽了多個頁面,仍得保留參數 RID 及 Click_ID,並在買家結帳時,將這兩組參數記錄到訂單資料,這就是所謂的擷取參數。

舉例來說:
編號 882516 美安會員或顧客透過 SHOP.COM 網站,要進入家樂福線上購物網站,則美安會在家樂福線上購物的網址 https://online.carrefour.com.tw 後方加上參數變成如下所示:

https://online.carrefour.com.tw?RID=C8825168-t6666666666666666666&Click_ID=102eb2f7d72c0ad7c4c38e1cd197a4

不過這兩組參數必須設定在買家離開您的網站時就移除,在買家下一次再來到您的網站時,都不應該套用前一次的參數。

二、訂單成立紀錄

當買家透過美安相關網站或 APP 進入您網站,並完成訂單時,商家網站需要回傳訂單成立資料給美安。由於傳送訂單紀錄功能有安全性設定,因此商家必須提供至少一組屆時會用來傳送取消紀錄的主機 IP Address 給美安,以便美安將商家網站 IP 加入白名單。
交易紀錄回拋 API 網址如下:

https://api.hasoffers.com/Api?Format=json&Target=Conversion&Method=create&Service=HasOffers&Version=2&NetworkId=marktamerica&NetworkToken=NETPYKNAYOswzsboApxaL6GPQRiY2s&data[offer_id]=&data[advertiser_id]=&data[sale_amount]=&data[affiliate_id]=12&data[payout]=<Commission_Amount>&data[revenue]=&data[advertiser_info]=&data[affiliate_info1]=&data[ad_id]=&data[session_datetime]=<Date>

三、失效訂單及訂單取消紀錄回傳

在前一步驟訂單成立時將訂單紀錄回傳美安之後,但若有以下狀況發生時,則必須透過 API,將訂單取消紀錄回傳給美安。由於取消訂單功能有安全性設定,因此必須提供至少一組屆時會用來傳送取消紀錄的主機 IP Address 給美安。

  1. 訂單因使用者未付款造成訂單失效
  2. 消費者自行取消訂單
  3. 網站管理者取消訂單
  4. 日後消費者退訂訂單。
  5. 其他造成訂單失效的各種原因。

交易取消 API 網址如下:
https://api.hasoffers.com/Api?Format=json&Target=Conversion&Method=create&Service=HasOffers&Version=2&NetworkId=marktamerica&NetworkToken=NETPYKNAYOswzsboApxaL6GPQRiY2s&data[offer_id]=&data[advertiser_id]=&data[sale_amount]=&data[affiliate_id]=12&data[payout]=&data[revenue]=&data[advertiser_info]=&data[affiliate_info1]=&data[ad_id]=&data[is_adjustment]=1&data[session_datetime]=

四、產品銷售資料表 XML 檔案

美安會將商家的商品資料匯入到 TW.SHOP.COM 中呈現,供買家瀏覽,故商家必須準備產品資料 XML 檔,以供美安系統自行撈取商品資料。

當商家網站上的商品資訊有任何異動,須再次產生一份更新後的產品資料檔,並放置於同一路徑及檔名,美安的主機會於每天自動檢查商家的資料內容是否更新,並於更新後的約 24 小時同步到 TW.SHOP.COM。

五、加入防詐騙宣導資訊

由於近年網路詐騙案件頻傳,除民眾本身要提高警覺之外,內政部警政署也呼籲購物網站業者應主動於網站中加入防詐騙宣導相關資訊提醒消費者。所以美安要求,當買家透過 TW.SHOP.COM 連結至商家網站時,必須在網站中顯示防詐騙宣導訊息,包含四項。

(一)、訂單完成頁面:

[此為雙方合作之必要功能] 當美安的優惠顧客會透過 TW.SHOP.COM 連結進入商家網站並完成訂單時,須於訂單完成頁面中顯示防詐騙資訊。可參考以下內容:
「提醒您,以下都是詐騙:訂單設錯、訂單金額有誤、設成分期每月扣款、重覆訂購多筆、宅配或超商出錯、簽收單簽成簽帳單、條碼刷錯、重覆扣款。歹徒會以更改訂單要求退費給您為由,要求您操作 ATM,這些都是詐騙手法。若遇可疑來電,隨時可撥打 165 反詐騙諮詢專線。」

(二)、防詐騙宣導專頁:

[此為雙方合作之必要功能] 請於網站中加入宣導防詐騙相關資訊之專屬頁面。

(三)、網站進入頁:

[此為建議選項] 當美安的優惠顧客會透過 TW.SHOP.COM 連結進入貴網站時,請使用新視窗顯示防詐騙資訊。並請於該視窗中增加一個關閉按鈕,將畫面顯示至消費者點下關閉按鈕為止。您可參考以下內容:
「防詐騙!我們不會要求並指示您至 ATM 操作。ATM 只有匯款及轉帳功能,無法解除分期付款或訂單錯誤問題。隨時可撥打 165 反詐騙諮詢專線。」

(四)、發送電子郵件提醒:

[此為建議選項] 定期寄送防詐騙宣導資訊給消費者。