將 OpenAI Ads（ChatGPT Ads）連接到 cPixel

如何將 OpenAI Ads 連接到 cPixel？

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

貼到 cPixel 中

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

重要： 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。

在左側選單中展開 Tools，選擇 Conversions。
在 Data Source 分頁上複製灰色的 ID；如果還沒有資料來源，可以建立一個。

我要如何建立 Conversions API 金鑰？

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

點擊鑰匙圖示。Conversion keys 會以遮蔽方式列出你的金鑰；OpenAI 不會再次顯示舊的金鑰。
點擊 Create new key，為它命名，並在關閉前從 Save your key 複製金鑰。
將它貼到 cPixel 的Conversions API 金鑰欄位。

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

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

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

cPixel 會傳送什麼給 ChatGPT Ads？

結帳與購買事件一律從 cPixel 的伺服器傳送，分別是 checkout_started 與 order_created，因為佈景主題無法在 Shopify 的結帳或感謝頁面上執行。開啟應用程式嵌入後，商店前台標記會加上頁面瀏覽、商品瀏覽與加入購物車（page_viewed、contents_viewed、items_added），因此不會有事件擁有兩個傳送來源。

如果顧客的瀏覽器無法載入 OpenAI 的標記，cPixel 會用你的金鑰從伺服器傳送該商店前台事件，且絕不會重複傳送標記已經送出的事件。它無法得知 OpenAI 是否拒絕了某個瀏覽器事件。
沒有付款資訊事件會傳送給 OpenAI。
伺服器傳送會攜帶雜湊過的電子郵件、電話、顧客與裝置 ID、oppref 與 obref、IP 位址與使用者代理程式。OpenAI Ads 需要行銷同意；cPixel 絕不會傳送姓名或郵寄地址。
OpenAI 會依像素 ID、事件名稱與事件 ID 進行去重複，保留最先收到的一筆，並接受最多 7 天內的事件。

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 分頁。

在 cPixel 中，開啟即時並點擊開始工作階段。
在另一個分頁下一筆真實訂單；cPixel 預設會略過測試訂單。
開啟購買事件的伺服器列：OpenAI Ads 應該會顯示已接受。商店前台事件會顯示為瀏覽器列，沒有回應。
在 Ads Manager 中，開啟 Tools → Conversions，然後查看 Event Stream 分頁。商店前台事件也會出現在這裡，但絕不會來自結帳頁面。

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

如果沒有成功該怎麼辦？

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

建立新的金鑰。
在首頁點擊修正 OpenAI，或在目的地頁面點擊帳戶旁的管理，然後貼到已儲存 — 貼上新的即可取代上。測試連線會檢查它。
點擊繼續，然後儲存並繼續。

你看到的畫面	該怎麼做
測試連線：平台拒絕了這個權杖	這把金鑰已被刪除或輸入錯誤：建立一把新的
Ads Manager 中的轉換顯示為 0	廣告活動的轉換目標必須符合送出的事件，購買事件對應的是 order_created（OpenAI）
購買被重複計算	另一個工具也在傳送到這個像素 ID：每個像素一個傳送來源
即時中某筆購買顯示已略過	閱讀其原因，然後參閱購買未顯示

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