*最後更新時間:2025-07-12
*預計串接時間:本串接需要和美安系統來回測試資料正確性,大概需要 1-2 個月左右
*本文適用 App 方案:Advanced / Enterprise 並加購美安功能模組(每月 +50 USD)
*若尚未安裝 Ako CVS,請點此安裝

1. Shopify 商家加入美安聯盟基本流程

  1. 商家向 SHOP.COM 美安聯盟的業務窗口聯絡,告知已經有一個購物網站,想做聯盟串接,與美安洽談佣金比例。
  2. 初步申請完畢,美安提供專屬的店家代號等資料給商家。
  3. 商家聯繫 Akohub (service@akohub.com) 並提供上述資料,Ako 將傳送新的訂閱方案連結給您,在您核准新的收費後,我們就會協助設定美安的技術串接。
  4. 串接完畢,商家告知美安,串接已完成並要求審核。
  5. 美安將審核網站(作業時間需數週到數月不等)確認完畢後,您的商品將會顯示於美安網站。
  6. 消費者瀏覽美安網站時,將有機會逛到或找到您的商品,並在您的 Shopify 網站註冊會員下單。

2. Shopify 美安串接流程

2.1 加購與啟用美安功能模組

請先將 Ako CVS 方案調整為 Advanced 以上方案,並來信通知 Akohub 團隊 (service@akohub.com) 需要加購美安串接功能,我們會傳送美安功能的加購連結,收到連結後請於 2 天內核准並完成加購。

⚠️請留意訂閱連結具有時效性,若未在兩天內完成訂閱,連結將會失效。
請再與我們聯繫或來信service@akohub.com,重新索取訂閱連結。

核准新的方案後,請提供以下三項資訊給我們,我們將替您完成系統設定:

  1. Offer ID
  2. Advertiser ID
  3. 您與美安洽談的佣金比例 (%)

2.2 新增產品標籤

針對希望出現在美安網站的商品,請在 Shopify 為這些產品新增 shop.com 與 shop.com/[CATEGORY] 兩組產品標籤。

此 [CATEGORY] 是指該商品對應的美安分類名稱,美安可用的分類可參考此網頁:https://tw.shop.com/departments.xhtml

美安的分類有多階層,例如:SHOP.COM TW  服裝、配件  淑女  襯衫, 上衣  短袖

新增 CATEGORY 時使用最下層的分類即可,以上方的分類為例,只要新增「shop.com/短袖」這個標籤即可。

接著請確認商品在 Shopify 的欄位都有正確填寫以符合美安的規範:

  1. 標題:最多 50 字元
  2. 說明最多 4000 字元
  3. 網址:最多 2000 字元
  4. 圖片:請使用 RGB 模式的 jpg 或 gif 檔案
  5. 價格:最多 10 字元
  6. SKU (存貨單位):最多 50 字元

若該商品有多個子類 (variants),請確認每個子類都有新增對應的圖片(如下圖)。

    以上完成後,請打開此連結:https://app.akocommerce.com/store/shopcom/feeds?shop=<您的網站名稱>.myshopify.com

    檢查該產品要上傳到美安的資料是否都正確,沒有問題後就可以按照相同的步驟處理需要上架到美安網站的產品:

    1. 新增標籤 shop.com 與 shop.com/[CATEGORY] 兩組產品標籤( 如須批次新增產品標籤,可參考此篇說明)
    2. 確認產品欄位皆有填寫正確

    2.3 傳送 XML 連結和取消紀錄的主機 IP 給美安

    產品標籤新增完成後,請將以下兩項資料回傳給您的美安窗口

    1. XML產品資料表連結: https://app.akocommerce.com/store/shopcom/feeds?shop=<您的網站名稱>.myshopify.com
    2. 會送出交易成立和取消紀錄的主機IP:3.113.244.170

    並告知美安串接作業已完成,可以開始請美安人員在您的商店測試下單。

    2.4 請美安下測試訂單

    美安會以「美安測試」的名義下測試訂單,並以 E-mail 通知您。

    下單完成後,請您 Shopify 後台找到該筆訂單,並查看右方「其他詳細資訊」欄位的 RID、Click_ID (如下圖),接著將資料填入至您的 Excel 資料裡(此 Excel 檔美安會提供)。

    一般美安人員會測試三張訂單,如果兩張訂單有帶入值,表示測試成功。

    2.5 回傳測試訂單記錄給美安

    確認訂單有紀錄到美安相關的資訊後,請「手動」將訂單的付款狀態更新為「已付款」,接著系統會將測試訂單的紀錄回傳給美安。

      🔔提醒:請點此查看目前官網後台啟用中的手動付款方式,並請美安人員選擇這些付款方式下測試單(例如:超商取貨付款、銀行轉帳等),這樣才有辦法將測試訂單標示為「已付款」,如果結帳時選 ATM 虛擬帳號會無更新付款狀態喔。

      2.6 回傳取消訂單記錄給美安

      待美安確認測試訂單成功後,會以 E-mail 通知您,請您將美安測試訂單手動進行「取消訂單」的動作,再點選「退款」、完成後再請回覆 E-mail 告知美安。

      訂單回傳與取消訂單回傳紀錄,金額需一致。


      3. 串接完成!

      以下兩點檢查通過後,就正式完成串接囉:

      • 第一步:收到美安來信通知測試訂單&取消訂單兩者的紀錄皆正確。
      • 第二步:聯繫 Akohub 團隊進行最後驗收,為了確保美安的資料皆可正確帶入訂單內,我們會在您的佈景主題內放置一組程式碼讓資料帶入的機制更牢固。

      如果日後需要更換佈景主題,請務必來信 service@akohub.com 由 Akohub 團隊協助調整,避免美安訂單產生異常。

      4. 常見問題

      1. 傳給美安的訂單金額是多少?

      美安接收到的訂單金額 =「顧客付款金額」扣掉「運費」

      2. 我需要填寫 Shopify 商品的「比較售價」欄位嗎?

      不用,填寫價格就好,比較售價目前沒有做串接喔!

      3. 商品要多久才會同步到美安?

      當產品標籤有異動時,步驟 2.2 提到的產品列表 https://app.akocommerce.com/store/shopcom/feeds?shop=<您的網站名稱>.myshopify.com 即會重新生成,美安的主機會於每天自動檢查資料內容是否更新,並於資料更新後的約 24 小時同步到 TW.SHOP.COM。

      若標籤完成調整後,更動尚未呈現在美安官網,可以先檢查 產品列表是否已更新:

      • XML 已更新:請等待 24 小時,待美安更新資料
      • XML 未更新:請聯繫 Ako 客服