運作原理

使用這個應用程式並不需要了解這些內容，開啟應用程式嵌入就是全部的設定。不過，如果您想知道倒數計時器為什麼會有這樣的表現，或是正在排查問題，這裡說明了背後的運作方式。

應用程式嵌入會在每個商店前台頁面上執行

Countdown Timer Bar Samita 透過 Shopify 的佈景主題應用程式擴充功能嵌入來連接您的商店前台，在佈景主題編輯器中顯示為 Samita Countdown Timer Bar。一旦在某個佈景主題中啟用，應用程式的一小段指令碼就會在顧客於該佈景主題載入的每個頁面上執行。

在大多數頁面瀏覽中，它不需要做任何事。它的首要工作是判斷您設定的內容是否適用於目前頁面；對大多數商店的大多數頁面而言，答案是否定的，因此它會直接退出。

由於倒數計時器存在於應用程式中，而不是您的佈景主題裡，所以您儲存的變更會直接顯示在商店前台，無需重新發佈佈景主題。

它對頁面了解哪些資訊

除了您的倒數計時器設定之外，嵌入還會從 Shopify 所渲染的頁面本身取得一些資訊：

• 頁面類型：商品頁面、商品系列、購物車、部落格等。Page 條件就是以此進行比對。
• 顧客瀏覽時使用的商店前台語言，它同時決定 Language 條件與翻譯後的文字。
• 已登入的顧客（如果有的話），包括他們的標籤。Customer 與 Customer tag 條件會讀取這些資料。
• 在商品頁面上，顧客正在檢視的商品。

這些資料全都來自顧客已載入的頁面，因此顧客與語言條件能立即得出結果。

尋找顯示位置

倒數計時器有兩種方式取得頁面上的位置。

**商品頁面上的自動放置。**如果勾選了 Product page，指令碼會尋找佈景主題的加入購物車區域，並將倒數計時器插入其正下方。它能辨識大量佈景主題所使用的模式，但經過大幅自訂的佈景主題可能讓它失效，此時就不會顯示任何內容。這是自動放置失敗的常見原因。

**短代碼區塊。**透過 Samita Countdown 應用程式區塊放置的 <div class="samita-countdown" ...> 已經存在於頁面上，因此指令碼只需填入內容。這種方式不受佈景主題影響，所以是可靠的備用方案。

購物車倒數計時器會在購物車中有商品時，自行放置在購物車頁面與購物車側邊欄的購物車表單頂端。銷售彈出視窗則會加入頁面，並浮動在您設定的位置。

決定是否顯示

對於每個可能適用的倒數計時器，應用程式會將其條件與它所掌握的頁面、商品及顧客資訊進行比對。大多數條件可以當場判斷。

有兩項需要查詢資料：

• Collections：應用程式無法僅從頁面得知商品所屬的商品系列，因此會使用啟用 Collection 條件中所述的範本檔案來取得。沒有該檔案就無法判斷此條件，因此不會比對到任何結果。
• Country：透過查詢顧客的 IP 位址來判斷，而不是讀取他們的帳號資料。使用 VPN 或代理伺服器會改變結果。

計算剩餘時間

剩餘時間是在顧客的瀏覽器中計算的，方法是將您的設定與他們裝置的時鐘進行比對，沒有伺服器計時。

這讓應用程式對您的頁面影響很小，同時也帶來三個值得了解的結果：

• 如果顧客的裝置時鐘嚴重不準，看到的計時器也會不準。
• Daily recurring timer 的時段是依顧客的本地時鐘計算，因此「上午 9 點到 11 點」指的是他們所在地的上午 9 點。
• Countdown to a date 計時器會倒數到您設定的時刻，每位顧客看到的都是以自身時間計算的正確剩餘時間。

記住 Fixed minutes 計時器

Fixed minutes 計時器必須能在換頁後延續，因此顧客第一次看到它時，應用程式會將他們專屬的結束時間寫入瀏覽器的 Cookie。之後瀏覽頁面時，它會讀回該 Cookie 並繼續計時。

因此，這是依瀏覽器與裝置各自計算的，清除 Cookie 後就會消失；如果您更改了設定的分鐘數，所有人的計時都會重設。

應用程式不會做的事

• **它不會更改您的商品。**不會動到價格、庫存或供貨狀況。計時器歸零只會移除計時器，不會有其他影響。
• **它不會保留庫存。**購物車倒數計時器是提醒，不是保留。
• **它不會編輯您佈景主題的範本。**開啟嵌入只會加入應用程式的指令碼；應用程式區塊則和其他區塊一樣，在佈景主題編輯器中新增與移除。唯一的例外是用於 Collection 條件的選用範本檔案，需要由您自行新增。

後續步驟

• 權限與資料
• 倒數計時器的運作方式
• 倒數計時器未顯示
• 顯示概覽