網址分組

整理並分組您的短網址以便於管理。

概覽

分組功能幫助您將相關的短網址整理成邏輯群組，方便管理、追蹤和分析。可依活動、專案、客戶或任何其他標準進行分組。

建立分組

建立新分組

POST /api/bundles

{
  "name": "Q1 行銷活動",
  "description": "2025 年第一季行銷活動的所有網址",
  "color": "#3B82F6",
  "icon": "rocket"
}

參數：

參數	說明	必填	預設值
name	分組名稱	✅	-
description	分組描述	❌	-
color	顯示顏色（十六進位）	❌	#3B82F6
icon	圖示名稱	❌	folder
urlIds	初始網址 ID	❌	[]

建立時加入網址

建立分組時直接加入網址：

POST /api/bundles

{
  "name": "產品發布",
  "urlIds": ["url_123", "url_456", "url_789"]
}

管理分組

列出所有分組

GET /api/bundles?page=1&pageSize=10&search=marketing&status=ACTIVE

查詢參數：

參數	說明	預設值
page	頁碼	1
pageSize	每頁數量	10
search	搜尋名稱/描述	-
status	狀態篩選	-

取得分組詳情

GET /api/bundles/{id}

回應包含：

• 分組資訊
• 分組內所有網址
• 網址統計資料

更新分組

PUT /api/bundles/{id}

{
  "name": "更新後的名稱",
  "description": "新的描述",
  "color": "#EF4444",
  "icon": "star"
}

刪除分組

DELETE /api/bundles/{id}

INFO

刪除分組只會移除分組本身，分組內的網址會保留。

網址管理

新增單一網址

POST /api/bundles/{id}/urls

{
  "urlId": "url_123"
}

批量新增網址

POST /api/bundles/{id}/urls/batch

{
  "urlIds": ["url_123", "url_456", "url_789"]
}

從分組移除網址

DELETE /api/bundles/{id}/urls/{urlId}

INFO

從分組移除網址只會移除關聯，網址本身仍然有效。

重新排序網址

變更網址在分組內的顯示順序：

PATCH /api/bundles/{id}/urls/{urlId}/order

{
  "order": 0
}

排序規則：

• 從 0 開始的索引
• 0 移動到第一個位置

分組統計

取得分組統計

GET /api/bundles/{id}/stats

回應：

{
  "bundleId": "bundle_123",
  "urlCount": 15,
  "totalClicks": 45000,
  "topUrls": [
    {
      "id": "url_123",
      "slug": "summer-sale",
      "clickCount": 12000
    },
    {
      "id": "url_456",
      "slug": "newsletter-jan",
      "clickCount": 8500
    }
  ],
  "clickTrend": [
    { "date": "2025-01-08", "clicks": 1200 },
    { "date": "2025-01-09", "clicks": 1350 },
    { "date": "2025-01-10", "clicks": 980 }
  ]
}

統計包含：

• 分組內網址總數
• 合併點擊數
• 表現最佳的網址
• 點擊趨勢（近 7 天）

分組狀態

可用狀態

狀態	說明
ACTIVE	分組可見且啟用
ARCHIVED	分組隱藏但保留

封存分組

隱藏分組但不刪除：

POST /api/bundles/{id}/archive

還原分組

取消封存分組：

POST /api/bundles/{id}/restore

使用案例

行銷活動

依活動整理網址：

分組：2025 夏季促銷
├── 首頁橫幅 → /summer-home
├── 電子報 → /summer-email
├── 社群媒體 → /summer-social
├── Google 廣告 → /summer-ads
└── 網紅連結 → /summer-inf-*

客戶專案

依客戶分組：

分組：Acme 企業
├── 主網站 → /acme-main
├── 產品目錄 → /acme-products
├── 客服入口 → /acme-support
└── 人才招募 → /acme-careers

產品發布

追蹤發布相關網址：

分組：產品 X 發布
├── 著陸頁 A（A/B）→ /productx-a
├── 著陸頁 B（A/B）→ /productx-b
├── 新聞稿 → /productx-press
├── 展示影片 → /productx-demo
└── 候補名單 → /productx-waitlist

活動管理

整理活動網址：

分組：2025 科技研討會
├── 報名 → /conf-register
├── 議程 → /conf-schedule
├── 講者介紹 → /conf-speakers
├── 場地資訊 → /conf-venue
└── 直播連結 → /conf-live

最佳實踐

1. 使用描述性名稱

選擇清晰、有意義的分組名稱：

• ✅ 「Q1 2025 電子報活動」
• ❌ 「活動 1」

2. 一致的顏色編碼

使用顏色來分類分組：

• 🔵 藍色 - 行銷
• 🟢 綠色 - 銷售
• 🟣 紫色 - 產品
• 🟠 橘色 - 活動

3. 封存舊分組

不要刪除已完成的活動 - 封存它們：

• 保留歷史資料
• 保持工作區整潔
• 方便未來參考

4. 定期清理

定期檢視分組：

• 移除未使用的網址
• 更新描述
• 封存已完成的活動

5. 使用圖示

選擇相關圖示以便快速識別：

• 📧 電子報活動
• 📱 社群媒體
• 🎯 廣告
• 📊 分析

批量操作與分組

透過批量更新加入分組

PATCH /api/urls/bulk

{
  "urlIds": ["url_1", "url_2", "url_3"],
  "operation": "bundle",
  "value": "bundle_123"
}

一次將多個網址加入分組。

下一步

• 短網址 - 建立更多網址
• 數據分析 - 追蹤分組表現
• A/B 測試 - 在分組內進行測試