將 Snap 像素與 Conversions API 連接到 cPixel

如何將 Snapchat 連接到 cPixel?

在 Snapchat Ads Manager 中,開啟 Events Manager,然後開啟 Event Sources 底下你的 Snap 像素:像素 ID 會印在名稱底下,包含減號。至於權杖,選擇 Set Up Conversions API,再選擇 Manual Setup。將兩者都貼到 cPixel,它會在你的 Shopify 商店前台觸發 Snap 像素,並從伺服器傳送結帳、付款步驟與購買事件。

貼到 cPixel 中

  1. 在 cPixel 中,開啟目的地,點擊連接平台底下的 Snapchat 圖示。設定 Snapchat 會開啟並停在貼上你的 ID。
  2. 填寫 Snap 像素 ID 與 Conversions API 存取權杖,兩者皆為必填。上方灰色提示文字表示不會追蹤購買事件,那是 cPixel 推出 Snapchat 伺服器連線之前的舊說明。如果你想要,可以在為這個帳戶命名(選填)底下命名這個帳戶。
  3. 點擊測試連線:Snapchat 會用這個權杖核對你的像素,但不會記錄事件,確認的是存取權,而不是送達狀況。
  4. 點擊繼續。在選擇選項中,保持從瀏覽器傳送事件與從我們的伺服器傳送事件勾選。除非另一個工具也會傳送到這個像素,否則請保持沒有 — 由 cPixel 負責處理 Snapchat(建議):儘管名稱是這樣,有 — 請保留它,cPixel 將停止對 Snapchat 進行伺服器端傳送會停止 cPixel 對它的瀏覽器與伺服器傳送。
  5. 點擊儲存並繼續。測試連線會確認Snapchat 已連接。

cPixel 的目的地頁面,連接平台列顯示 Meta、TikTok、GA4、OpenAI Ads、Snapchat、Pinterest 與 Google Ads 的圖示

重要: Snapchat 自己的 Shopify App「Snapchat Ads」也會傳送到某個 Snap 像素(Snapchat),因此請保持每個像素一個傳送來源。

我要去哪裡找我的 Snap 像素 ID?

在 Snapchat 的 Events Manager 中你像素名稱的底下:一組由五段英數字組成、以減號連接的 UUID,格式如 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。

  1. 在 Snapchat Ads Manager 中,開啟左上角選單(依你進入的位置顯示 Create Ads 或 Manage Ads),選擇 Events Manager。
  2. 在左側欄的 Event Sources 底下,開啟你的 Snap 像素。如果帳戶還沒有任何像素,使用 New Event Source。
  3. 將像素名稱底下顯示的 ID(包含減號)複製到 cPixel 的 Snap 像素 ID 欄位。這組 ID 也會出現在網址列,在 /events/pixel/ 之後。

Snapchat 的 Events Manager,在 Event Sources 底下開啟一個 Snap 像素,顯示「Your event source hasn’t received any activity」的提示;其名稱與 ID 已遮蔽

  • 廣告帳戶 ID,同樣是一組 UUID,是網址列中的第一組。
  • 略過 Set Up Snap Pixel:cPixel 已透過應用程式嵌入載入 Snap 像素,再放一份 Snapchat 的程式碼可能會讓頁面瀏覽被計算兩次。

我要如何取得 Conversions API 權杖?

在 Snapchat Ads Manager 中產生它,可以直接從你像素本身的設定,或以組織管理員身分,在 Business Details 底下產生。這是必填項目。

從你的 Snap 像素

  1. 在你像素的頁面上,於 Send events from a server 底下,點擊 Set Up Conversions API。
  2. 在 Set Up Method 中,選擇 Manual Setup,不要選 Partner Integration 或 Conversions API Gateway。
  3. 依步驟完成到最後,點擊 Copy Access Token。Snapchat 也會顯示權杖的端點 https://tr.snapchat.com/v3/<pixel-id>/events,其中應該會包含你的像素 ID。

從 Business Details

這是 Snapchat 官方指南提供的方式(Snapchat):

  1. 在 Ads Manager 中,開啟左上角選單,前往 Business Dashboard → Business Details。
  2. 在 Conversions API Tokens 底下,點擊 Generate Token 並複製它。

Snap 表示這類權杖不會過期,且只對建立它的組織所擁有的像素有效(Snap)。cPixel 會儲存你的權杖,且不會再次顯示。

cPixel 會傳送什麼給 Snapchat?

商店前台事件來自 cPixel 應用程式嵌入載入的 Snap 像素,結帳、付款步驟與購買事件則透過 Snapchat 的 Conversions API(第 3 版)從 cPixel 的伺服器傳送;每個事件只會走其中一條途徑。

  • PAGE_VIEW 與 ADD_CART 只在應用程式嵌入開啟時,由 Snap 像素傳送。如果瀏覽器封鎖了像素,cPixel 會改由伺服器傳送該事件。
  • START_CHECKOUT、ADD_BILLING 與 PURCHASE 來自 cPixel 的伺服器:分別代表開始結帳、送出付款資訊,以及根據 Shopify 訂單重建的購買事件,因為沒有佈景主題程式碼可以在結帳時執行。

伺服器事件會在已知時攜帶雜湊過的電子郵件、電話與 Shopify 顧客 ID,再加上 IP 位址與使用者代理程式;Snapchat 的點擊 ID 不會被擷取。Snapchat 會在 48 小時內依事件 ID 去重複,購買事件則額外依訂單 ID 在 30 天內去重複(Snap)。

注意: cPixel 的 Snapchat 伺服器連線是新功能:自 2026 年 9 月起已在正式環境運作,但尚未在實際廣告帳戶上完成驗證。請留意你第一筆結帳與購買事件在即時中的狀況。

我要如何檢查它是否成功?

在 cPixel 的即時中觀察一筆結帳與一筆購買事件,伺服器傳送會顯示 Snapchat 的回應,接著再到 Snapchat 的 Events Manager 中確認。

  1. 在 cPixel 中,開啟即時並點擊開始工作階段。
  2. 在另一個分頁瀏覽你的商店並加入購物車。瀏覽器列會將 Snapchat 列為由瀏覽器傳送,沒有回應:平台不會回應瀏覽器傳送。
  3. 開始結帳並下一筆真實訂單;cPixel 預設會略過測試訂單。它們的伺服器列應該會顯示 Snapchat 已接受。
  4. 在 Events Manager 中,伺服器事件會出現在主畫面,標示為「via Conversions API」;Snapchat 表示最多可能需要 1 到 2 小時才會顯示(Snapchat)。

第一次成功的伺服器傳送後,目的地會將帳戶標示為已驗證,通常是第一筆結帳事件。Events Manager 也會顯示 Snapchat 自己的 Event Quality Score;cPixel 不會讀取這個分數。

如果沒有成功該怎麼辦?

如果 Snapchat 沒有收到 cPixel 的事件,請開啟即時中的 Snapchat 列:未顯示已接受的傳送會列出原因。

你看到的畫面 該怎麼做
測試連線拒絕了這個權杖 重新複製一次,並確認它來自擁有該像素的組織
已拒絕或錯誤 在該列的詳細資料中閱讀 Snapchat 的回應;cPixel 會自動重試錯誤
你的像素完全沒有收到任何內容 檢查像素 ID:可能遺失了減號,或是誤填成廣告帳戶 ID
首頁顯示修正 Snapchat:權杖被拒絕或已刪除,伺服器傳送已停止,並寄出重大警示 產生新的權杖,點擊修正 Snapchat,或在目的地頁面點擊帳戶旁的管理,貼上並儲存
沒有瀏覽器列列出 Snapchat 應用程式嵌入已關閉(瀏覽器徽章顯示需要應用程式嵌入):開啟 cPixel 追蹤並儲存你的佈景主題,換佈景主題後也要再做一次
某筆購買遺失或顯示已略過 閱讀其原因,然後參閱購買未顯示
頁面瀏覽或購買被重複計算 另一個工具,例如 Snapchat Ads App 或佈景主題中的像素程式碼,也在傳送到這個像素

在管理 Snapchat中點擊移除會停止對該帳戶的傳送,並刪除它的權杖。

需要 cPixel 的相關協助嗎?請寄送電子郵件至 support@b2bgold.app。