📦 Tag Lite API 文件:取得使用者標籤教學

透過 JavaScript 事件,你可以在網站前端即時取得目前使用者的標籤資訊,並根據其內容進行個人化推薦或商品呈現。

📥 一、前置設定

請於頁面內嵌入以下兩段 JS:

<script src="https://cdn.taglite.com.tw/js/core.js"></script>
<script src="https://cdn.taglite.com.tw/js/get-info.js" defer></script>
⚠️ 注意:
本推薦功能依賴網頁中正確的 SEO 標籤(例如 <meta name="keywords"><meta property="og:title"><meta property="article:tag"> 等),系統才能針對內容進行標籤分析與推薦。
請確認您的每篇文章或商品頁面中,已正確填寫這些標籤,以確保推薦結果的準確性。

📡 二、事件監聽方式

當系統完成標籤解析時,會觸發 TagLiteInfos 事件:

<script>
window.addEventListener('TagLiteInfos', function(e) {
  const userTags = e.detail;
  console.log('[使用者標籤]', userTags);
});
</script>

📘 三、回傳資料格式(範例)

{
  "onsite_tags": {
    "tag": [
      { "tag": "奇幻", "score": 120 },
      { "tag": "小說", "score": 80 }
    ],
    "custom_tag": [
      { "custom_tag": "專題A", "tag_count": 6 }
    ]
  },
  "offsite_tag": {
    "main": [
      { "tag": "影視", "score": 53 }
    ],
    "sub": [
      { "tag": "原創小說", "score": 55 }
    ]
  }
}

📌 onsite_tags 說明(站內標籤)

  • tag:本網站內容自動萃取的 SEO 標籤(免費)
  • custom_tag:你透過 taglite_customize() 主動貼上的標籤(免費)

📌 說明:只要每日平均查詢不超過 3,000 次,以上標籤皆可 永久免費 使用。

💰 五、offsite_tag 說明(跨站標籤)

  • offsite_tag:該使用者於其他網站累積的標籤(推薦系統可能參考) 授權後可用
  • 例如:使用者曾在其他網站點過「宅文化」類文章,即可於你站內辨識該興趣
用途說明:
本 JS API 適合用於動態載入個人化文章、商品列表、推播建議等模組,無需後端串接,即可使用。