# 開始使用 cPixel {#doc-title}

作者：[B2B Gold](/about/#how-we-write) 更新日期：2026年9月25日 [使用 AI 工具從英文翻譯](/docs/cpixel/getting-started/) [cPixel 頁面](/shopify/cpixel/) [Shopify App Store 上的 cPixel](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=zh-tw/docs/cpixel/getting-started&utm_term=docs-header)

## 如何設定 cPixel？ {#how-do-i-set-up-cpixel}

從 Shopify App Store 安裝 cPixel 後，會開啟**設定 cPixel**畫面，共有四個步驟：開啟應用程式嵌入、連接第一個平台、選擇方案，以及確認第一批事件送達。最後一個步驟會在工作階段已經執行的狀態下開啟**即時**，讓你在完成設定前就能看到真實事件送出。

在你完成或略過設定之前，開啟任何頁面都會顯示設定畫面，選單也只會顯示**設定 cPixel**。

1. **開啟應用程式嵌入**：點擊**開啟佈景主題編輯器**會開啟你目前發布中的佈景主題，畫面停留在**App embeds**，且**cPixel 追蹤**已經開啟。在那裡點擊**儲存**，這個步驟就會自動勾選完成。只有這個步驟才有**略過這個步驟**。
2. **連接第一個平台**：**選擇平台**會列出全部七個平台，不過內文只提到其中四個。
3. **選擇你的方案**：選擇**免費開始**，或挑選一個付費方案（例如**選擇 Starter**），然後在 Shopify 的畫面上核准（[比較方案](/shopify/cpixel/#pricing)）。
4. **確認第一批事件送達**：點擊**開始觀看**會完成設定，並在工作階段執行中的狀態下開啟**即時**；在 Free 方案上，這會使用掉一次你的即時工作階段。

**略過設定**會前往**首頁**，你可以在那裡點擊**完成設定**回到設定畫面。側邊面板**cPixel 的兩種追蹤方式**說明了這兩種途徑。

> **注意：** 在你儲存平台之前，商店不會註冊任何項目；儲存後，像素 **cPixel** 就會出現在 **Settings** → **Customer events** 底下。

## cPixel 會傳送到哪些平台？從哪裡傳送？ {#which-platforms-does-cpixel-send-to-and-from-where}

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 存取權杖** |
| Pinterest | 應用程式嵌入：頁面造訪、加入購物車 | initiate_checkout、checkout | 伺服器 | **標記 ID**、**廣告帳戶 ID**、**Conversions API 存取權杖** |
| Google Ads | 網頁像素，僅限感謝頁面 | 無 | 瀏覽器 | **轉換 ID**、**轉換標籤** |

- 每個方案都會執行伺服器端傳送；只有 Free 方案會在達到每月訂單額度時暫停，且安裝後最初幾天不受此限（[定價](/shopify/cpixel/#pricing)）。瀏覽器追蹤永遠不計入額度。
- 如果 GA4、OpenAI Ads、Snapchat 或 Pinterest 的瀏覽器事件未能從裝置送出，cPixel 會改由伺服器傳送。
- Snapchat 與 Pinterest 的伺服器端傳送是新功能：自 2026 年 9 月起已在正式環境運作，但尚未在實際廣告帳戶上完成驗證。
- 退款只會送達 GA4。目前不提供 Microsoft Advertising 與 X。

## cPixel 為什麼需要應用程式嵌入？ {#why-does-cpixel-need-its-app-embed}

應用程式嵌入**cPixel 追蹤**會載入 TikTok、OpenAI Ads、Snapchat 與 Pinterest 的商店前台標記，並讓 cPixel 得知顧客瀏覽的內容，讓更多事件能夠比對到顧客身分。

關閉時，結帳、購買事件、所有伺服器端途徑，以及 Meta、GA4 與 Google Ads 的瀏覽器事件仍會繼續運作。會停止的是：這四個商店前台標記、TikTok 瀏覽器與伺服器頁面瀏覽的配對、OpenAI 的點擊 Cookie，以及依系列或標籤設定的商店前台目標鎖定。**首頁**會顯示**你的商店前台尚未開啟強化追蹤**。

### 開啟應用程式嵌入 {#turn-on-the-app-embed}

1. 在**首頁**點擊**立即開啟**，或點擊**應用程式嵌入**旁的**開啟**。你的佈景主題編輯器會開啟，並在 **App embeds** 底下已經開啟**cPixel 追蹤**（[Shopify 的指南](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/apps)）。
2. 點擊**儲存**，然後回到 cPixel：**應用程式嵌入**會顯示**開啟**。

> **重要：** 應用程式嵌入只屬於一個佈景主題。發布另一個佈景主題後，也要在那裡開啟**cPixel 追蹤**；如果你忘記了，cPixel 會提醒你。

## 我要如何連接第一個平台？ {#how-do-i-connect-my-first-platform}

開啟**目的地**，在**連接平台**底下選擇一個平台，然後依照精靈操作：**貼上你的 ID**、**選擇選項**與**測試連線**。每個平台的指南都會說明對應數值的所在位置，可以從[連接 Meta](/zh-tw/docs/cpixel/connect-meta/) 與[連接 OpenAI Ads](/zh-tw/docs/cpixel/connect-openai-ads/) 開始。

你不需要一次完成一個平台的設定：Meta 與 GA4 只要有 ID 就能接受，狀態會顯示為**僅瀏覽器**，直到你加入權杖或密鑰為止。TikTok、OpenAI Ads、Snapchat 與 Pinterest 則從一開始就需要權杖。

## 我要怎麼知道事件有送達？ {#how-do-i-know-events-are-arriving}

開啟**即時**，點擊**開始工作階段**，然後在另一個分頁瀏覽你的商店。在 10 分鐘內，事件會在送出時即時顯示，伺服器送出的事件還會顯示平台的回應：[在即時中確認你的第一批事件](/zh-tw/docs/cpixel/live-events/)。

在**目的地**頁面，**已驗證**代表伺服器端傳送已成功，**憑證正常**代表**測試連線**已通過，**僅瀏覽器**則代表只有 ID、沒有權杖。**首頁**的**顯示檢查項目**會列出六項健康檢查。每份連接指南都會說明如何在對應平台上檢查。

> **提示：** cPixel 預設會略過測試訂單，包含開發商店上的每一筆訂單，即時畫面會將它們標示為**已略過**；如果要查看購買事件，請以真實方式付款，或取消勾選**設定** → **測試訂單**。

## 接下來該設定什麼？ {#what-should-i-set-up-next}

接著連接其他平台。你可以[繼續使用 Facebook 與 Instagram App](/zh-tw/docs/cpixel/official-channel-apps/)，以及其他平台自己的 App 來處理目錄與購物功能，只要每個像素維持一個傳送來源即可。

- 如果購買事件遺失，請參閱[購買未顯示](/zh-tw/docs/cpixel/purchases-missing/)；關於額度，請參閱 [cPixel 方案](/zh-tw/docs/cpixel/plans/)；關於貨到付款，請參閱[訂單規則](/zh-tw/docs/cpixel/order-rules/)。
- 需要協助：**首頁** → **取得協助** → **聯絡支援團隊**，通常會在一個工作天內回覆。

### 移除 cPixel {#removing-cpixel}

cPixel 不會編輯任何佈景主題檔案，也無法新增指令碼標記，因此不需要手動清理。

1. 如果是付費方案，請先在**方案** → **取消方案**中取消，費用會按比例計算；[解除安裝](https://help.shopify.com/en/manual/apps/uninstalling-apps)仍可能會收取目前週期的費用。
2. 在 Shopify 中前往 **Settings** → **Apps**，點擊 cPixel 旁的 **…**，然後選擇 **Uninstall**。Shopify 會自動移除 cPixel 的像素與[應用程式嵌入](https://shopify.dev/docs/apps/build/online-store/theme-app-extensions/ux)。

cPixel 會立即刪除你的存取權杖，其餘資料則約在 48 小時後刪除；若在此之前重新安裝，設定會恢復，但權杖不會。

## 相關頁面 {#related}

- [連接 Meta](/zh-tw/docs/cpixel/connect-meta/)
- [連接 OpenAI Ads](/zh-tw/docs/cpixel/connect-openai-ads/)
- [在即時中確認你的第一批事件](/zh-tw/docs/cpixel/live-events/)
- [繼續使用 Facebook 與 Instagram App](/zh-tw/docs/cpixel/official-channel-apps/)

[cPixel Facebook Pixel CAPI GA4](/shopify/cpixel/)

[從 Shopify App Store 免費安裝](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=zh-tw/docs/cpixel/getting-started&utm_term=card) [方案與價格](/shopify/cpixel/#pricing)

需要 cPixel 的相關協助嗎？請寄送電子郵件至 [support@b2bgold.app](mailto:support@b2bgold.app)。