開始使用 cPixel
如何設定 cPixel？
從 Shopify App Store 安裝 cPixel 後，會開啟設定 cPixel畫面，共有四個步驟：開啟應用程式嵌入、連接第一個平台、選擇方案，以及確認第一批事件送達。最後一個步驟會在工作階段已經執行的狀態下開啟即時，讓你在完成設定前就能看到真實事件送出。
在你完成或略過設定之前，開啟任何頁面都會顯示設定畫面，選單也只會顯示設定 cPixel。
- 開啟應用程式嵌入：點擊開啟佈景主題編輯器會開啟你目前發布中的佈景主題，畫面停留在App embeds，且cPixel 追蹤已經開啟。在那裡點擊儲存，這個步驟就會自動勾選完成。只有這個步驟才有略過這個步驟。
- 連接第一個平台：選擇平台會列出全部七個平台，不過內文只提到其中四個。
- 選擇你的方案：選擇免費開始，或挑選一個付費方案（例如選擇 Starter），然後在 Shopify 的畫面上核准（比較方案）。
- 確認第一批事件送達：點擊開始觀看會完成設定，並在工作階段執行中的狀態下開啟即時；在 Free 方案上，這會使用掉一次你的即時工作階段。
略過設定會前往首頁，你可以在那裡點擊完成設定回到設定畫面。側邊面板cPixel 的兩種追蹤方式說明了這兩種途徑。
注意： 在你儲存平台之前，商店不會註冊任何項目；儲存後，像素 cPixel 就會出現在 Settings → Customer events 底下。
cPixel 會傳送到哪些平台？從哪裡傳送？
cPixel 會傳送到七個平台。其中六個也會從 cPixel 的伺服器接收事件，這些事件是根據 Shopify 訂單建立每筆購買，而非根據感謝頁面；Google Ads 則只有瀏覽器標記。瀏覽器端的追蹤是透過 Shopify 的網頁像素，在包含結帳在內的每一頁執行，或是透過應用程式嵌入載入的商店前台標記執行。
| 平台 | 瀏覽器端 | 伺服器端事件 | 購買事件來源 | 你要貼上的內容 |
|---|---|---|---|---|
| Meta | 網頁像素，所有頁面 | PageView、ViewContent、Search、AddToCart、InitiateCheckout、AddPaymentInfo、Purchase | 伺服器；瀏覽器作為備援 | 像素／資料集 ID；Conversions API 存取權杖（選填） |
| TikTok | 應用程式嵌入：Pageview | Pageview、ViewContent、Search、AddToCart、InitiateCheckout、AddPaymentInfo、CompletePayment | 伺服器 | 像素代碼、Events API 存取權杖 |
| Google Analytics 4 | 網頁像素，所有頁面 | purchase、refund | 伺服器 | 評估 ID；Measurement Protocol API 密鑰（選填；購買事件需要） |
| OpenAI Ads | 應用程式嵌入：頁面瀏覽、商品瀏覽、加入購物車 | checkout_started、order_created | 伺服器 | 像素 ID、Conversions API 金鑰 |
| Snapchat | 應用程式嵌入：頁面瀏覽、加入購物車 | START_CHECKOUT、ADD_BILLING、PURCHASE | 伺服器 | Snap 像素 ID、Conversions API 存取權杖 |
| 應用程式嵌入：頁面造訪、加入購物車 | initiate_checkout、checkout | 伺服器 | 標記 ID、廣告帳戶 ID、Conversions API 存取權杖 | |
| Google Ads | 網頁像素，僅限感謝頁面 | 無 | 瀏覽器 | 轉換 ID、轉換標籤 |
- 每個方案都會執行伺服器端傳送；只有 Free 方案會在達到每月訂單額度時暫停，且安裝後最初幾天不受此限（定價）。瀏覽器追蹤永遠不計入額度。
- 如果 GA4、OpenAI Ads、Snapchat 或 Pinterest 的瀏覽器事件未能從裝置送出，cPixel 會改由伺服器傳送。
- Snapchat 與 Pinterest 的伺服器端傳送是新功能：自 2026 年 9 月起已在正式環境運作，但尚未在實際廣告帳戶上完成驗證。
- 退款只會送達 GA4。目前不提供 Microsoft Advertising 與 X。
cPixel 為什麼需要應用程式嵌入？
應用程式嵌入cPixel 追蹤會載入 TikTok、OpenAI Ads、Snapchat 與 Pinterest 的商店前台標記，並讓 cPixel 得知顧客瀏覽的內容，讓更多事件能夠比對到顧客身分。
關閉時，結帳、購買事件、所有伺服器端途徑，以及 Meta、GA4 與 Google Ads 的瀏覽器事件仍會繼續運作。會停止的是：這四個商店前台標記、TikTok 瀏覽器與伺服器頁面瀏覽的配對、OpenAI 的點擊 Cookie，以及依系列或標籤設定的商店前台目標鎖定。首頁會顯示你的商店前台尚未開啟強化追蹤。
開啟應用程式嵌入
- 在首頁點擊立即開啟，或點擊應用程式嵌入旁的開啟。你的佈景主題編輯器會開啟，並在 App embeds 底下已經開啟cPixel 追蹤（Shopify 的指南）。
- 點擊儲存，然後回到 cPixel：應用程式嵌入會顯示開啟。
重要： 應用程式嵌入只屬於一個佈景主題。發布另一個佈景主題後，也要在那裡開啟cPixel 追蹤；如果你忘記了，cPixel 會提醒你。
我要如何連接第一個平台？
開啟目的地，在連接平台底下選擇一個平台，然後依照精靈操作：貼上你的 ID、選擇選項與測試連線。每個平台的指南都會說明對應數值的所在位置，可以從連接 Meta 與連接 OpenAI Ads 開始。
你不需要一次完成一個平台的設定：Meta 與 GA4 只要有 ID 就能接受，狀態會顯示為僅瀏覽器，直到你加入權杖或密鑰為止。TikTok、OpenAI Ads、Snapchat 與 Pinterest 則從一開始就需要權杖。
我要怎麼知道事件有送達？
開啟即時，點擊開始工作階段，然後在另一個分頁瀏覽你的商店。在 10 分鐘內，事件會在送出時即時顯示，伺服器送出的事件還會顯示平台的回應：在即時中確認你的第一批事件。
在目的地頁面，已驗證代表伺服器端傳送已成功，憑證正常代表測試連線已通過，僅瀏覽器則代表只有 ID、沒有權杖。首頁的顯示檢查項目會列出六項健康檢查。每份連接指南都會說明如何在對應平台上檢查。
提示： cPixel 預設會略過測試訂單，包含開發商店上的每一筆訂單，即時畫面會將它們標示為已略過；如果要查看購買事件，請以真實方式付款，或取消勾選設定 → 測試訂單。
接下來該設定什麼？
接著連接其他平台。你可以繼續使用 Facebook 與 Instagram App，以及其他平台自己的 App 來處理目錄與購物功能，只要每個像素維持一個傳送來源即可。
移除 cPixel
cPixel 不會編輯任何佈景主題檔案，也無法新增指令碼標記，因此不需要手動清理。
- 如果是付費方案，請先在方案 → 取消方案中取消，費用會按比例計算；解除安裝仍可能會收取目前週期的費用。
- 在 Shopify 中前往 Settings → Apps，點擊 cPixel 旁的 …，然後選擇 Uninstall。Shopify 會自動移除 cPixel 的像素與應用程式嵌入。
cPixel 會立即刪除你的存取權杖，其餘資料則約在 48 小時後刪除；若在此之前重新安裝，設定會恢復，但權杖不會。
