WordPress龍霄加盟推廣系統 —— 數據一目了然，結算一步到位：多語系電商推廣管理後台

一、開發背景與定位

龍霄加盟推廣外掛（LongXiao Affiliate）由薩龍網路出品，是一款深度 WordPress 電商加盟推廣管理外掛，100% 為龍霄主題（LongXiao Theme）量身訂製。傳統 WordPress 生態中的加盟推廣外掛——如 AffiliateWP、WooCommerce Affiliate 等——雖然功能強大，但它們面向通用場景設計，與龍霄主題高度解耦的前後端架構（WordPress 後端 + Vue.js/Nuxt.js 前端）、WPGraphQL 資料層、多語系多幣種體系、積分餘額系統等特色功能無法原生適配。龍霄加盟推廣外掛正是為解決這一斷層而生。

外掛採用純自訂資料表架構，不依賴任何 WordPress 自訂文章類型（CPT），所有加盟商資訊、推廣記錄、造訪日誌、創意素材和連結資料均儲存在獨立的資料表中，效能優異且與主題的前端 GraphQL 查詢層無縫對接。外掛後台預設了完整的「加盟推廣」主選單及八大子選單，涵蓋從加盟商管理、佣金結算到資料報表的全鏈路營運需求。無論你是經營垂直電商平台、內容變現社群，還是跨境多語系商店，這套外掛都能提供精準、高效、可自訂的加盟推廣管理體驗。

二、核心選單功能詳解

2.1 概述（Overview）—— 資料駕駛艙

概述頁面是外掛的儀表板，以十個核心統計卡片快速呈現全域營運狀態：加盟使用者數（含總計與活躍數）、總素材數、總連結數、總推廣數、總造訪量、總轉換數、轉換率、累計佣金、累計已付佣金、累計未付佣金。十大數據讓管理者一屏掌握平台推廣業務的整體健康度。

統計卡片下方是四組資料表格構成的營運看板，呈 2×2 版面配置：

• 最優推廣使用者排行：依收益和推廣次數排序，識別高價值加盟商。
• 近期註冊使用者：展示新加盟使用者的審核狀態，支援快速跟進。
• 最近造訪記錄：展示推廣連結的來源管道和 URL 參數，協助分析引流效果。
• 最新推廣動態：展示最新的訂單轉換記錄，含狀態標籤（已支付/未支付/已拒絕/已退款）。

這套看板的設計初衷是讓管理者無需跳轉多個子頁面即可完成日常巡檢，快速發現異常（如被拒加盟申請激增、造訪量突降等）。

2.2 加盟管理（Affiliates）—— 加盟商全生命週期管理

加盟管理頁面是外掛的核心營運陣地，採用 WordPress 標準列表表格（WP_List_Table）呈現所有加盟商記錄。每一行展示加盟商 ID、使用者 ID、狀態、佣金比例、累積收益、未支付收益、推廣次數、造訪次數、註冊時間和審核時間。

表格支援依使用者 ID 搜尋和批次刪除操作。外掛預設了四種加盟商狀態：

• 待審核（pending）：新提交申請，需營運人員人工審核，操作欄提供綠色的「通過」和紅色的「拒絕」按鈕。
• 已通過（active）：正常推廣中的加盟商，可執行停用、編輯、刪除操作。
• 已停用（inactive）：被暫時凍結的加盟商，支援一鍵恢復為活躍狀態。
• 已拒絕（rejected）：未通過審核的申請，支援重新啟用（被拒絕的加盟商可自行在前端重新提交申請，狀態重置為待審核並觸發新通知）。

編輯頁面支援修改狀態（下拉選單）、傭金比例（百分比或固定金額）、傭金類型、網站網址、申請原因、累積收益、未支付收益、推廣次數、造訪次數和註冊時間等資訊。所有狀態變更均會自動觸發龍霄主題的通知系統（系統內支援站內通知、郵件通知、微信通知三種管道獨立開關），確保加盟商在個人中心即時收到審核結果通知。

表格上方新增了統計彙總列，分「當前頁」和「總計」展示當前篩選條件下的關鍵數據，包括造訪量、推廣數、轉換數，以及按語言區域拆分的累計收益和未付收益（多幣種場景下分別以對應貨幣符號顯示），幫助管理者快速了解數據分布而不需要逐行加總。

2.3 推廣記錄（Referrals）—— 訂單級佣金明細

推廣記錄頁面管理所有透過加盟連結產生的訂單轉換資料。表格列包含：ID、加盟商、客戶、訂單 ID、金額、狀態、描述、時間和語言區域（多語系場景下顯示）。

頁面頂部提供篩選器，支援依訂單 ID、加盟商 ID、客戶 ID 和狀態（全部/未支付/已支付/已拒絕/已退款）快速定位記錄。內建批次操作（接受、拒絕、刪除）大幅提升審核效率。造訪日誌、創意素材和連結管理頁面同樣支援批次刪除操作；所有列表表格均支援透過介面選項自訂每頁顯示筆數（預設 20 筆）。

表格上方增設統計彙總列，分「當前頁」和「總計」展示已付佣金和未付佣金的金額彙總，多語系環境下按語言區域分別顯示對應幣種的合計值，方便管理者即時掌握推廣成本的全貌。

新增和編輯推廣記錄的表單包含完整欄位：加盟商使用者 ID（必填）、客戶 ID、訂單 ID（必填）、金額（必填）、語言區域（多語系場景）、造訪 ID、狀態、參考資訊、上下文和描述。外掛內建並發鎖機制（基於 WordPress Transient API），防止同筆訂單重複建立佣金記錄。當狀態變更為「已支付」時，外掛自動呼叫龍霄主題的餘額系統，將佣金打入加盟商帳戶餘額並發送站內通知和站外郵件（含微信）通知；當訂單發生退款時，系統自動從餘額扣除對應金額並從積分中扣除相應推廣積分，實現全自動的佣金帳務閉環。

2.4 造訪日誌（Visits）—— 全鏈路引流溯源

造訪日誌頁面記錄了每一次透過加盟連結造訪網站的完整資料。表格包含：ID、加盟商、訪客、造訪 URL、來源（Referrer）、Campaign、裝置類型（桌面/手機/平板）、瀏覽器、作業系統、是否已轉換、時間和 IP 位址。

資料顆粒極細，支援依 URL 或來源搜尋，以及批次刪除和單條刪除。每條記錄都精準記錄了裝置指紋資訊，這在反刷單場景中至關重要——結合外掛後台的防刷設定，管理者可以輕鬆識別來自同一裝置或 IP 的高頻異常造訪。

更重要的是，「已轉換」標記將造訪記錄與推廣記錄打通，管理者可以追溯每一筆佣金是從哪個管道、哪個 Campaign、哪個創意素材引流而來，實現推廣 ROI 的精細化歸因分析。外掛內建系統日誌（salong_affiliate_logs），自動記錄佣金跳過、發放失敗等異常事件，為排查問題提供完整稽核鏈路。

2.5 創意素材（Creatives）—— 標準化推廣物料庫

創意素材頁面用於管理提供給加盟商的推廣物料。支援三種素材類型：圖片、QR Code、連結。表格展示：ID、類型（附圖片縮圖）、名稱、Campaign、URL、狀態（已上線/已下線）、建立時間和更新時間。

外掛內建 QR Code 產生功能（對接 api.qrserver.com 外部 API），輸入的 URL 和名稱可以一鍵產生 QR Code 圖片並自動上傳到 WordPress 媒體庫。三種素材類型在編輯表單中透過 JavaScript 動態切換欄位顯示，互動體驗流暢。

每個素材支援上下線切換（上線/下線），管理者可以配合行銷活動節奏靈活控制物料的可使用狀態。在龍霄主題前端，加盟商在「創意素材」頁面中只能看到狀態為「已上線」的物料，確保推廣物料的可控性和時效性。

2.6 連結管理（URLs）—— 加盟商推廣連結看板

連結管理頁面展示系統中所有加盟推廣連結記錄，包含 ID、使用者 ID、URL、Campaign、造訪次數、轉換次數、建立時間和更新時間。此頁面與龍霄主題前端加盟商自行建立的連結形成對應關係——營運人員可以在此處集中管理所有手動建立的推廣連結並檢視每條連結的即時造訪和轉換資料。

其中「造訪次數」和「轉換次數」是直接從造訪日誌表中即時查詢的統計結果，管理者能夠直觀判斷哪些連結的引流效果最好，為後續的 Campaign 投放決策提供一手資料支撐。

2.7 資料報表（Reports）—— 多維度經營分析

資料報表是外掛中最具深度的功能模組。採用標籤頁導航 + 日期範圍篩選的互動模式，支援依加盟商 ID、Campaign 和語言區域進一步向下分析。四大標籤頁各具側重：

加盟報表（Affiliates Tab）：展示歷史全部加盟總數、週期內新增加盟數、最佳轉換率加盟商及其轉換率。趨勢圖以日為單位展示加盟商註冊曲線，Top 10 轉換率排行榜讓管理者快速識別高績效群體。

推廣報表（Referrals Tab）：依幣種（多語系多幣種場景）展示歷史已支付總額、歷史未支付總額、週期內已支付/未支付金額及均值。每日趨勢圖可視化佣金支出曲線，多語系區域的透視矩陣和 Top 10 排行榜幫助分析不同語言市場的佣金分佈。

造訪報表（Visits Tab）：展示歷史總造訪量、週期內造訪量、週期內轉換量、歷史轉換率、最佳來源管道。每日趨勢圖結合來源排名表格，為流量管道最佳化提供量化依據。

活動報表（Campaigns Tab）：展示歷史 Campaign 總數、最佳轉換 Campaign、週期內最活躍 Campaign、週期內最佳推廣 Campaign。每日趨勢圖和 Top 10 排行榜提供 Campaign 粒度的效果對比。

所有報表圖表均基於 Chart.js v4.5.1 渲染，搭配外掛自研的資料快取版本控制機制，在大量資料場景下依然保持流暢載入。

2.8 加盟設定（Settings）—— 靈活可配的業務規則

加盟設定頁面由 Codestar Framework 驅動，分為四大設定區塊：

一般設定：開放/關閉自主註冊開關、允許/禁止自推廣、是否啟用人工審核、選擇加盟協議頁面、設定推廣連結參數（預設 ref）、設定申請原因長度（預設 6-50 字元）及敏感詞過濾。

佣金設定：支援百分比佣金或固定金額兩種計費模式，每個加盟商可單獨設定佣金比例覆蓋全域預設值（新加盟商自動繼承全域設定）。可設定佣金比例、固定金額和 Cookie 有效天數（預設 30 天）。注意：純積分支付的訂單不計推廣轉換。

排除規則：未付款訂單不計佣金、免費/零元訂單不計佣金、最後推薦計佣金、優惠券訂單不計佣金、運費不計佣金、排除指定商品、積分支付訂單不計佣金——七項規則為精細化佣金策略提供全面保障。

防刷設定：全域防刷機制開關、裝置指紋偵測、裝置頻率限制、IP 頻率限制、時間區間設定。四維防護體系有效遏制惡意刷單行為，保護平台佣金支出的安全性。

三、與龍霄主題的協同適配優勢

龍霄加盟推廣外掛與龍霄主題的協同絕非簡單的「相容」，而是深度、雙向的原生融合：

1. GraphQL 資料層完全打通：外掛註冊了完整的 WPGraphQL 查詢和變更（Mutation）類型，龍霄主題前端透過 salongGetAuthorContent 一個 GraphQL 查詢即可取得所有加盟頁面資料，無需額外 REST API 開發。
2. 餘額系統整合：佣金發放不需要單獨開發提現模組，資料自動匯入龍霄主題的餘額系統，與平台會員餘額一體化管理。
3. 通知與動態系統融合：加盟申請審核、佣金入帳、訂單退款等事件自動觸發龍霄主題的站內通知、郵件通知、微信通知（三種管道可獨立開關）和動態日誌，加盟商在個人中心的「通知」和「動態」頻道即可接收所有推廣相關訊息。
4. 多語系多幣種原生支援：透過龍霄主題的 Polylang 整合層，每筆推廣記錄、每個創意素材、每條連結均可關聯語言區域，資料報表支援依幣種拆分統計，滿足跨境多語系電商的複雜需求。
5. 積分系統聯動：推廣轉換成功後，主題的積分系統可自動獎勵推廣積分（預設 100 分，可在主題積分設定中自訂）；退款時系統同步扣除相應積分，形成「佣金 + 積分」的雙重激勵機制。
6. 前端路由無縫嵌入：外掛不需要建立任何前端範本，龍霄主題的 /user/{id}/affiliate/* 路由體系原生解析外掛資料，加盟商在個人中心即可完成申請、檢視資料、管理連結和素材等全部操作。

四、實操價值與使用者收益

從營運視角來看，外掛解決了電商加盟推廣中最核心的三個問題：

效率提升：從加盟申請審核到佣金結算，所有操作無需離開 WordPress 後台。列表表格的批次操作、搜尋篩選和快速狀態切換，將日常營運效率提升數倍。

資料驅動：八大選單涵蓋了「拉新→追蹤→轉換→結算→分析」的全鏈路資料，管理者不是在「憑感覺營運」，每一筆佣金支出都有完整的造訪→轉換→結算鏈路可追溯。

風險控制：防刷設定、排除規則和造訪日誌的裝置指紋資訊，從規則層面和技術層面雙重保障平台利益，有效降低惡意刷單帶來的經濟損失。

五、適用人群

龍霄加盟推廣外掛最適合以下場景：正在使用龍霄主題建置多語系電商平台（如跨境獨立站、垂直品類電商、數位商品平台）的站點管理者，尤其是那些希望建立自有加盟推廣體系、降低行銷獲客成本、精細化追蹤推廣效果的營運團隊。外掛同時也適用於需要為內容創作者、KOL 和社群團長提供標準化推廣工具和佣金結算機制的平台型站點。