贊助罐與目標計量器指南

贊助模式或熱度計分？

模式	計入的內容	適合
一般贊助罐	Super Chat、Cheers/Bits、小費及其他附帶贊助金額的資料	金額或原生單位目標
贊助次數	每個符合條件的付費事件計為一次，不考慮金額	例如 7 / 20 次 Super Chat 的目標
熱度杯計分（Hype Cup Scoring）	贊助、會員/訂閱、續費及贈送會員/訂閱	統一的支持者點數目標

將 Jar 改為 Bar 僅變更外觀。 若會員或訂閱應推進目標，請啟用 Hype Cup Scoring。

贊助罐疊加畫面用彩紙慶祝 $20 贊助，提示中顯示 Ryu 贊助了 $20.00 — Jar 樣式：每次符合條件的贊助都會觸發慶祝效果並更新目標總額。

目標計量條疊加畫面顯示 $100 目標中的 $63.50，下方列出近期支持者 — 進度條樣式（`style=meter`）：將同一目標顯示為進度條，並列出近期支持者。

選擇樣式

開啟安全的樣式預覽圖庫，比較淺色或深色背景上的範例版面。預覽不會連接至即時疊加畫面，也不會讀取或儲存贊助總額。在圖庫中貼上現有贊助罐連結，即可複製帶樣式的連結，並保留工作階段、目標及篩選器設定。

現有樣式預設保留原外觀。啟用 新版外觀 (&refresh），僅在想使用更新的間距、顏色及排版時啟用。下方的新樣式可單獨選擇。

所有樣式使用相同的贊助總額、篩選器、計數目標、熱度計分及循環目標。可在以下位置選擇： 樣式、目標與篩選器 → 顯示樣式（Style, Goal, and Filters → Display Style）.

啟用 隱藏美元符號 在同一區段中（或加入 &hidecurrency 至疊加畫面 URL）以顯示 0.00 / 500 而不是 $0.00 / $500。此選項預設關閉，僅變更目標顯示；贊助值、換算以及 Bits 或其他單位標籤維持不變。

罐子（Jar）：帶掉落物品的經典杯子。
目標計量器（Goal Meter）：深色面板中顯示進度條及近期支持者。
流動目標條（Fluid Goal Bar）：寬幅動畫條，適合醒目展示目標。
精簡條（Compact Bar）：適合角落的小進度條； 垂直條（Vertical Bar）：適合側邊欄的溫度計。
極低：大字總額及百分比； 僅文字（Text Only）：簡單的文字讀數。
目標卡片（Goal Card） (style=card）：帶有大字總額及細進度條的精簡面板。
進度環（Progress Ring） (style=ring）：在目標總額上方顯示圓形百分比。
下三分之一字幕條（Lower Third） (style=lowerthird）：寬而矮的面板，標題位於總額旁。
分段條（Segmented Bar） (style=segmented）：帶有二十個進度分段的目標面板。

新面板支援 Default、Neon 和 Gold 主題。現有填滿顏色設定也適用；進度環使用隨進度變化的純色描邊。疊加畫面以外的背景為 OBS 保持透明。

四種新面板的選用控制項包含 panelopacity=0.5 (0–1), accent=%2366d9b2 （六位十六進位顏色）， amountsize=32 （12–96 像素），以及 hidepercent。進度填滿的明確起始/結束顏色優先於強調色。留空則使用各樣式的預設值。進度條文字大小及「僅進度條」適用於 Fluid Goal Bar；自訂罐子圖片僅適用於 Jar。

進行設定

在 Social Stream Ninja 中啟用 YouTube、Twitch 或其他來源。
開啟 贊助罐和目標進度條，然後開啟其選項。
僅贊助目標應關閉 Hype Cup Scoring。混合支持者目標則啟用它。
選擇目標衡量贊助金額或符合條件的贊助次數。
選擇顯示樣式、目標、標題、來源/事件篩選器及持續儲存行為。
複製更新後的 Tip Jar 連結，並將其新增為 OBS 瀏覽器來源。

工作階段檢查： 來源和複製的疊加畫面 URL 必須使用相同的工作階段 ID。請將工作階段和密碼值保密。

統計 YouTube Super Chat 次數，而非金額

將 熱度杯計分（Hype Cup Scoring） 關閉。
設定 目標衡量方式 為 符合條件的贊助次數.
設定 來源篩選器 為 YouTube.
設定 付費事件篩選器 為 僅 Super Chat（Super Chats only）.
設定目標值，例如 20。疊加畫面顯示的進度範例為 7 / 20 Super Chats.

Super Chat 金額不影響計數目標：$1 與 $100 的 Super Chat 都各增加一次。會員、贈送會員、Super Sticker 與 YouTube Gifts 不會推進僅限 Super Chat 的目標。

其他計數目標： 付費事件篩選器可僅統計 Super Sticker，或合併 Super Chat 與 Super Sticker。使用 計數單位標籤 以覆寫自動標籤。

熱度分值如何計算

訂閱/會員點數： 為每次新會員/訂閱或續費指定固定點數。
贈送訂閱/會員點數： 為每份禮物指定固定點數。5 份的組合貢獻 5 × giftpoints.
每 USD 贊助點數： 是支援的現金贊助換算為 USD 後套用的倍數。
點數單位標籤： 會變更顯示標籤。使用 $ 不會讓會員點數變成確切現金價值。

混合目標篩選器： 將 贊助類型篩選器 在 所有贊助（All donations） ，讓會員與禮物也計入。指定贊助單位篩選器目前會將熱度計分限制為相符的贊助列。

YouTube 禮物並非全都相同

YouTube 事件	含義	計數方式
Super Chat / Super Sticker	附帶貨幣金額的付費訊息	一般或熱度模式
贈送會員	有人為其他觀眾購買了會員	熱度模式使用禮物數量 × 設定的禮物點數
禮物接收者	一位觀眾從贈送組合中獲得一份會員	預設不計分，以防重複計數
Jewels / 虛擬禮物	具有原生單位數量的獨立虛擬禮物事件	使用相符的原生單位篩選器

贈送會員事件提供會員數量及會員等級，但不提供購買價格或創作者淨收入。無法從該事件計算其確切現金價值。

避免重複計數： 啟用 也統計每位禮物接收者 僅在應將接收者點數加到原始贈禮組合之上時使用。

目標完成與已儲存總額

一般贊助目標會保留總額，除非要求重設。
熱度目標預設在完成後重設；完成延遲控制完成數值保持可見的時間。
保留超額點數（Carry extra points） 會保留超出已完成目標的點數。
保留總額並推進目標 會建立累計滾動目標。
循環目標增量 會建立循環等級。
在工作階段之間保留金額 會將金額和歷史儲存在該瀏覽器或 OBS 設定檔中。

持續儲存的總額依一般/熱度模式及目前來源/單位篩選器分開儲存，但不依 Social Stream 工作階段 ID 區分。重複使用同一瀏覽器設定檔於不同目標前，請重設已儲存金額。

疑難排解

症狀	檢查內容
沒有任何更新	來源已啟用、疊加畫面已開啟、工作階段 ID 一致，且篩選器符合該事件。
Super Chat 被計入，但會員不計入	啟用 Hype Cup Scoring，並將贊助類型保持為 All donations。
贈送會員增加的數值低於預期	它們使用固定禮物點數，而非無法取得的購買價格。
達到目標後總額下降	熱度預設重設；需要累計總額時使用滾動目標。
舊金額重新出現	已在同一瀏覽器或 OBS 設定檔中啟用持續儲存。
贈送會員出現兩次	停用個別禮物接收者計數。
Super Chat 計數包含 Super Sticker	將 Paid event filter 設為 Super Chats only。
贈送會員推進熱度目標	啟用 Exclude YouTube gifted memberships，或從熱度計分中排除所有贈禮。

彈出選單的測試按鈕目前只測試贊助列。遇到會員或禮物問題時，先用同一工作階段的 Dock 或 Events Dashboard 確認事件已到達，再排查目標。