跳至主內容

設定教學｜SDK 官網行為追蹤工具

  • 更新於

    本文說明如何為您的網站安裝漸強 Web SDK，適合行銷人員或專案負責人閱讀，用於了解整體流程與協調工程師執行安裝。

    📋 技術夥伴請看這裡：事件資料格式規範（必填欄位、程式碼範例、驗證方法）
    請參考：技術規格｜SDK 事件資料格式與驗證指南

    安裝漸強 Web SDK 後，您可以即時收集官網訪客的行為資料，包括：

    • 訪客瀏覽了哪些商品頁面
    • 哪些訪客將商品加入購物車但未完成結帳
    • 哪些訪客完成了購買

    這些資料將成為 MAAC 自動化行銷與 CAAC 官網互動工具的行為觸發依據，例如購物車再行銷、個人化推播等功能。

    ⚠️ SDK 安裝需要技術團隊協助。請在閱讀本文後，將安裝任務交派給您的技術團隊執行。

    開始前確認

    請確認以下條件都已具備，再開始安裝流程：

    確認項目 說明
    ✅ 方案確認 使用 MAAC 成長版以上，或 CAAC 入門方案以上
    ✅ 網站類型確認 確認您的網站屬於：自建官網、SHOPLINE、CYBERBIZ、Shopify 或 91APP
    ✅ 技術資源 備妥可協助完成 SDK 安裝的技術人員

    # 安裝步驟說明

    Step 1：取得 SDK 專屬代碼

    您可以在 Admin Center 中自行取得 SDK 代碼，取得後再交給工程師進行安裝。

    1. 進入 Admin Center
      • MAAC 路徑：擴充市集 > Admin Center
      • CAAC 路徑：設定 > 組織管理 > 應用中心
    2. Admin Center > 渠道設定 > 新增渠道
    3. 選擇「網站」> 繼續
    4. 渠道設定 > 編輯
    5. 網頁工具 > 開啟要安裝的項目
    6. 點擊安裝 > 輸入網域 > 選擇 EC 平台
    7. 取得 SDK 專屬代碼，將代碼交給工程師，進行下一步安裝。

    Step 2： SDK 程式碼安裝

    取得代碼後，請依照您的網站類型，將代碼與對應的安裝說明一併交給技術夥伴。

    網站類型 安裝方式 誰來執行
    自建官網 透過 Google Tag Manager（GTM）安裝，或直接埋入網站原始碼 品牌技術夥伴
    SHOPLINE 透過 GTM 安裝，再於 SHOPLINE 後台填入 GTM 代碼 品牌技術夥伴
    CYBERBIZ 透過 GTM 安裝，再於 CYBERBIZ 後台填入 GTM 代碼 品牌技術夥伴
    Shopify 使用 Shopify 專屬安裝方式（共兩段代碼），不需設定 GTM 品牌技術夥伴
    91APP 需由漸強協助申請 GTM 權限並完成設定 請聯繫漸強客戶成功團隊
    📌 技術細節（事件格式規範、程式碼範例）請參考：技術規格｜SDK 事件資料格式與驗證指南
    📌 安裝完成後建議再檢查：教學｜Web SDK 安裝與事件追蹤狀態檢查

     

     

    各平台安裝重點說明

    → 自建官網

    依照您要使用的功能，安裝需求不同：

    使用功能 安裝需求
    只使用 CAAC 官網對話插件 透過 GTM 安裝 SDK 即可，不需額外埋碼
    使用 MAAC 網站足跡追蹤（加入購物車、完成購買等電商事件）以及 CAAC 商業表現追蹤 透過 GTM 安裝 SDK，並由工程師在網站對應頁面額外埋設事件追蹤碼
    使用 WebSDK Identify（會員登入、註冊後進行身分識別） 除安裝 SDK 外，還需由工程師在網站已確認身分的流程後完成 WebSDK Identify 串接
    📌 需要額外埋設事件追蹤碼的工程師，請參考：技術規格｜SDK 事件資料格式與驗證指南
    📌 若您要使用 WebSDK Identify，請安排工程師在會員登入、註冊或其他已確認身分的流程完成後進行串接。

     

    GTM 安裝步驟（自建官網、SHOPLINE、CYBERBIZ 共用）

    1. 設定觸發條件
      1. 登入 GTM 管理頁面，點擊「新增」>「觸發條件設定」
      2. 觸發條件類型選擇「DOM 就緒」
      3. 輸入名稱 > 啟動時機選擇「所有的 DOM Ready 事件」> 儲存
    2. 設定代碼
      1. 點擊「新增代碼」
      2. 設定代碼名稱（例如：漸強 SDK）
      3. 點擊「代碼設定」，選擇「自訂 HTML」
      4. 將漸強 SDK 代碼貼入 HTML 欄位
      5. 點擊「觸發條件」，選擇剛才建立的「DOM 就緒」
      6. 點擊右上方「儲存」
    3. 發布：點擊右上方「提交」>「發布」
    4. 記下 GTM 代碼，備用於後續平台設定

    → SHOPLINE

    透過 GTM 安裝 SDK 後，電商事件（加入購物車、完成購買等）由 SHOPLINE 平台自動觸發，工程師不需額外埋設事件追蹤碼。

    完成上方 GTM 設定並取得 GTM 代碼後，請至 SHOPLINE 後台填入：

    1. 登入 SHOPLINE 商店管理後台
    2. 前往 網店行銷與追蹤 > 追蹤設定
    3. 選擇「Google 代碼管理工具」
    4. 在「我的 Google 代碼管理工具編號」欄位填入 GTM 代碼

    → CYBERBIZ

    透過 GTM 安裝 SDK 後，電商事件（加入購物車、完成購買等）由 CYBERBIZ 平台自動觸發，工程師不需額外埋設事件追蹤碼。

    完成上方 GTM 設定並取得 GTM 代碼後，請至 CYBERBIZ 後台填入：

    1. 登入 CYBERBIZ 商店管理後台
    2. 前往 第三方整合 > 谷歌 Google 設定，在 Google Tag Manager 欄位貼上 GTM 代碼 > 點擊「新增 GTM container ID」

    → Shopify

    Shopify 使用專屬安裝方式，共需設定兩個位置，不需設定 GTM。電商事件由 Shopify 平台自動觸發，工程師不需額外埋設事件追蹤碼。請工程師依序完成：

    1. 佈景主題設定：將第 1 段代碼放入 theme.liquid 的 </body> 前，並發布佈景主題

    2. 顧客事件設定：於 設定 > 顧客事件 中新增自訂像素，填入第 2 段代碼並點擊連結

      ⚠️ 請確認【權限】中「行銷」與「分析」皆已勾選

    → 91APP

    91APP 需由漸強協助申請 GTM 權限才能安裝，請依以下流程處理：

    1. 聯繫漸強客戶成功團隊，告知需要開通 GTM 權限
    2. 91APP 授予 GTM 權限後，漸強團隊將協助完成 SDK 埋設
    3. 安裝完成後，漸強團隊會通知您，請登入 CAAC 後台確認 Web Channel 是否成功安裝
    ⚠️ 91APP 的安裝時程取決於您與 91APP 夥伴的溝通進度，請預留足夠的處理時間。

     

    Step 3：確認安裝是否成功

    安裝完成後，請使用 SDK 狀態檢查工具確認安裝是否正確，並確認系統有收到事件。

    📌 請參考：[教學｜Web SDK 安裝與事件追蹤狀態檢查]

     

    💬 需要協助？
    安裝過程中如有任何問題，請聯繫漸強實驗室客戶成功團隊。
    若使用自架網站，請提供 SDK 代碼畫面截圖；若使用 GTM，請提供觸發條件與代碼設定截圖，以便加快排查。

    相關文章