將 OpenAI Ads(ChatGPT Ads)連接到 cPixel

如何將 OpenAI Ads 連接到 cPixel?

在 OpenAI Ads Manager 中,開啟 Tools,然後開啟 Conversions:像素 ID 印在 Data Source 分頁上你資料來源的下方,頁首的鑰匙圖示則可以建立只顯示一次的 Conversions API 金鑰。將兩者都貼到 cPixel,之後它就會從伺服器將頁面瀏覽、商品瀏覽、加入購物車、結帳與購買事件傳送到 ChatGPT Ads。

貼到 cPixel 中

  1. 在 cPixel 中,開啟目的地,點擊連接平台底下的 OpenAI Ads 圖示。設定 OpenAI Ads 會開啟並停在貼上你的 ID。
  2. 貼上像素 ID(在哪裡找到)與 Conversions API 金鑰(如何建立);兩者皆為必填。如果你想要,可以在為這個帳戶命名(選填)底下命名這個帳戶。
  3. 點擊測試連線。OpenAI 會驗證一個測試事件但不會記錄它,因此你的憑證可存取這個帳戶只代表確認存取權,而非確認送達。
  4. 點擊繼續。在選擇選項中,保持從瀏覽器傳送事件與從我們的伺服器傳送事件勾選,回答你是否也安裝了 OpenAI Ads 官方 App?(詳見下方),然後點擊儲存並繼續。測試連線會確認OpenAI Ads 已連接。

「設定 OpenAI Ads」對話方塊,步驟 1,像素 ID 欄位與必填的 Conversions API 金鑰欄位上方有一段說明提示與完整指南的連結

重要: OpenAI 自己的 ChatGPT Ads app for Shopify 也會將你商店的事件傳送到一個 OpenAI 像素。兩個傳送來源會讓同一筆訂單擁有兩個事件 ID,而 OpenAI 兩者都會保留。請讓每個工具使用自己的像素 ID,或回答有 — 請保留它,cPixel 將停止對 OpenAI Ads 進行伺服器端傳送,儘管名稱是這樣,這個選項會同時停止 cPixel 對該像素的瀏覽器與伺服器傳送(每個像素一個傳送來源)。

我要去哪裡找 OpenAI Ads 像素 ID?

在 OpenAI Ads Manager 中,開啟 Tools → Conversions:在 Data Source 分頁上,你資料來源名稱下方的灰色 ID 就是像素 ID,不是網址列中的廣告帳戶 ID。

  1. 在左側選單中展開 Tools,選擇 Conversions。

    OpenAI Ads Manager 側邊選單,Tools 已展開並選取 Conversions,上方還有 Feeds、Change History 與 Audiences

  2. 在 Data Source 分頁上複製灰色的 ID;如果還沒有資料來源,可以建立一個。

    Conversions 頁面的 Data Source 分頁,列出一個網頁資料來源,其像素 ID 已遮蔽,上方橫幅顯示 Ads cannot serve until you finish account setup

我要如何建立 Conversions API 金鑰?

點擊 Conversions 頁面上 Warnings 旁的鑰匙圖示,然後點擊 Create new key。立即複製以 sk-svcacct- 開頭的金鑰:OpenAI 只會顯示一次。

  1. 點擊鑰匙圖示。Conversion keys 會以遮蔽方式列出你的金鑰;OpenAI 不會再次顯示舊的金鑰。

    Conversion keys 面板在 Conversions 頁面旁開啟,列出一個已遮蔽的金鑰,附有刪除圖示與 Create new key 按鈕

  2. 點擊 Create new key,為它命名,並在關閉前從 Save your key 複製金鑰。

    Save your key 對話方塊,新的金鑰已遮蔽,附有 Copy 與 Download 按鈕,並說明這把金鑰可完整存取某個資料來源的轉換事件

  3. 將它貼到 cPixel 的Conversions API 金鑰欄位。

提示: 刪除金鑰會立即使其失效,因此請先建立並貼上新的金鑰,再刪除舊的。

“Ads cannot serve until you finish account setup” 會擋住這個流程嗎?

不會。新帳戶在完成帳單與帳戶標誌設定之前都會顯示這個訊息;它只會限制廣告投放,不會影響 Conversions API。

cPixel 會傳送什麼給 ChatGPT Ads?

自 2026 年 11 月 13 日起,cPixel 會透過 OpenAI 的 Conversions API 從伺服器傳送五種事件:頁面瀏覽、商品瀏覽、加入購物車、結帳與購買,分別是 page_viewed、contents_viewed、items_added、checkout_started 與 order_created。開啟應用程式嵌入後,OpenAI 的商店前台標記也會以相同的事件 ID 傳送頁面瀏覽,因此 OpenAI 只會計算一次。

  • 商店前台標記只傳送頁面瀏覽。商品瀏覽與加入購物車只從伺服器傳送,結帳與購買則一律從伺服器傳送,因為佈景主題無法在 Shopify 的結帳或感謝頁面上執行。
  • 關閉應用程式嵌入時,五種事件仍會全部從伺服器傳送。
  • 沒有付款資訊事件會傳送給 OpenAI。
  • 伺服器傳送會攜帶雜湊過的電子郵件、電話與顧客 ID(cPixel 取得時)、雜湊過的裝置 ID、oppref 與 obref、IP 位址與使用者代理程式。OpenAI Ads 需要行銷同意;cPixel 絕不會傳送姓名或郵寄地址。
  • OpenAI 會依像素 ID、事件名稱與事件 ID 進行去重複,保留最先收到的一筆,並接受最多 7 天內的事件。如果 cPixel 的伺服器副本在沒有標記事件 ID 的情況下送出,頁面瀏覽仍可能被計算兩次,這可能發生在顧客造訪的第一個頁面。
  • 當伺服器傳送因達到每月訂單額度而暫停時,商店前台標記除了頁面瀏覽,也會傳送商品瀏覽與加入購物車,直到當月重設為止。結帳不會傳送,購買會等待當月重設;關閉應用程式嵌入時,OpenAI 在暫停期間不會收到任何內容。

OpenAI Ads Manager 每天都會為每個資料來源的事件品質評分。cPixel 的事件品質頁面不會讀取這個分數,其中「OpenAI 未公布評分」的說明已經過時。

oppref 是什麼?cPixel 會傳送它嗎?

oppref 是當有人點擊 ChatGPT 廣告時,OpenAI 加到你到達頁網址上的點擊參照代碼。OpenAI 會用它將轉換與該次點擊連結起來,並以雜湊過的聯絡資訊做為備援方式。只要 cPixel 有這個值,就會隨伺服器事件一併傳送。

  • cPixel 會從網址讀取它;在應用程式嵌入開啟時,也會從 OpenAI 標記保存在你網域上的 __oppref Cookie 讀取,這個 Cookie 在 www 與裸網域之間切換時仍會保留。
  • OpenAI 的標記會將這個 Cookie 保留 30 天,每次網址中再次出現 oppref 時都會重新計算天數。
  • OpenAI 要求在重新導向過程中保留 oppref:如果重新導向會去除查詢參數,就會遺失它。

我要如何確認它是否成功?

在即時中開始工作階段並下一筆真實訂單:購買事件的伺服器列會顯示 OpenAI 的回應,已接受、已拒絕或錯誤,並附上 HTTP 狀態碼。接著在 Ads Manager 中檢查 Event Stream 分頁。

  1. 在 cPixel 中,開啟即時並點擊開始工作階段。
  2. 在另一個分頁下一筆真實訂單;cPixel 預設會略過測試訂單。
  3. 開啟購買事件的伺服器列:OpenAI Ads 應該會顯示已接受。開啟應用程式嵌入時,頁面瀏覽會顯示一個沒有回應的瀏覽器列和一個伺服器列;商品瀏覽、加入購物車與結帳只會顯示伺服器列。
  4. 在 Ads Manager 中,開啟 Tools → Conversions,然後在 Event Stream 分頁中選取一個事件查看詳細資料。OpenAI 會將瀏覽器事件標示為 pixel_sdk,伺服器事件標示為 server_to_server(OpenAI)。商品瀏覽、加入購物車、結帳與購買應該只會以 server_to_server 送達。

第一次伺服器傳送成功後,目的地會將帳戶標示為已驗證。已歸因的轉換會在 24 到 48 小時內出現在 OpenAI 的報表中。

如果沒有成功該怎麼辦?

如果 OpenAI 拒絕這把金鑰,cPixel 會將帳戶標示為權杖無效,停止其伺服器傳送,並寄送重大警示電子郵件到你商店的聯絡地址;首頁會顯示修正 OpenAI。

  1. 建立新的金鑰。
  2. 在首頁點擊修正 OpenAI,或在目的地頁面點擊帳戶旁的管理,然後貼到已儲存 — 貼上新的即可取代上。測試連線會檢查它。
  3. 點擊繼續,然後儲存並繼續。
你看到的畫面 該怎麼做
測試連線:平台拒絕了這個權杖 這把金鑰已被刪除或輸入錯誤:建立一把新的
Ads Manager 中的轉換顯示為 0 廣告活動的轉換目標必須符合送出的事件,購買事件對應的是 order_created(OpenAI)
購買被重複計算 另一個工具也在傳送到這個像素 ID:每個像素一個傳送來源
即時中某筆購買顯示已略過 閱讀其原因,然後參閱購買未顯示

在管理 OpenAI Ads中點擊移除會停止傳送並刪除已儲存的金鑰。OpenAI 官方文件:Conversions API。

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