Pixel ChatGPT Ads dan Conversions API: memasang penjejakan penukaran
Kemas kini terakhir: 24 Ogos 2026, disahkan berdasarkan dokumentasi rasmi OpenAI. Nama peristiwa dan parameter yang dipetik di sini datang daripada dokumentasi pembangun OpenAI, dan ia berkemungkinan berubah sepanjang tempoh beta.
Tanpa pengukuran penukaran, kempen ChatGPT Ads kekal buta: anda tahu berapa yang anda belanjakan, bukan apa yang anda peroleh. Lebih penting lagi, anda tidak boleh mengaktifkan pengoptimuman kepada penukaran. Halaman ini merangkumi kedua-dua kaedah rasmi, iaitu pixel pelayar dan Conversions API di sebelah pelayan, serta cara menjadikan kedua-duanya hidup bersama. Rangka kerja keseluruhannya ada dalam panduan ChatGPT Ads kami.
Enjin AI berkaitan dengan halaman ini
- ChatGPT
Mengapa pengukuran ialah prasyarat, bukan pilihan
Tiga sebab, dan satu daripadanya bersifat menyekat:
- Menyekat: pengoptimuman kepada penukaran (oCPC) menuntut agar penjejakan sudah dikonfigurasikan, dengan pixel JavaScript, Conversions API, atau kedua-duanya. Tanpa isyarat, sistem tiada apa-apa untuk dioptimumkan.
- Pelaporan Ads Manager mengandungi lajur penukaran yang kekal kosong jika tiada apa-apa disambungkan.
- Pengiraan kos setiap perolehan anda bergantung sepenuhnya kepada data ini: tanpanya, anda memandu kempen mengikut CPC, iaitu mengikut perbelanjaan, bukan mengikut keputusan.
Prinsip umum yang ditetapkan oleh OpenAI adalah mudah: anda mencipta satu sumber data (data source) dalam Ads Manager, kemudian anda menghantar peristiwa penukaran kepadanya melalui pixel, API, atau kedua-duanya.
Pixel atau Conversions API: yang manakah perlu dipilih?
| Pixel JavaScript | Conversions API | |
|---|---|---|
| Di mana ia dijalankan | Dalam pelayar pengunjung | Pada pelayan anda sahaja |
| Pemasangan | Satu skrip untuk diletakkan dalam head | Pembangunan di sebelah back-end |
| Kekukuhan | Terdedah kepada penyekat iklan dan sekatan pelayar | OpenAI memperkenalkannya sebagai sumber yang lebih boleh dipercayai berbanding pixel sahaja |
| Saranan OpenAI | Titik permulaan | Gunakan apabila boleh, untuk data yang lebih tepat |
Jawapan yang praktikal bukan “satu atau yang lain” tetapi “kedua-duanya, dengan penyahduplikasian”. Pixel boleh dipasang dalam masa sejam dan menghidupkan kempen dengan segera; API disambungkan kemudian dan mengukuhkan pengukuran untuk jangka panjang.
Memasang pixel pengukuran
Pixel pengukuran ChatGPT Ads ialah SDK pelayar yang bertujuan mengukur peristiwa di laman web anda yang boleh dikaitkan dengan iklan dalam ChatGPT. Skrip ini dimuatkan secara tak segerak daripada https://bzrcdn.openai.com/sdk/oaiq.min.js, untuk diletakkan dalam bahagian <head>, kemudian dimulakan dengan pengenal pixel anda:
oaiq("init", { pixelId: "PIXEL-ID-ANDA" });
Parameter pixelId adalah wajib, dan ia dicipta dalam Ads Manager. Parameter debug yang bersifat pilihan akan menulis aktiviti SDK ke dalam konsol pelayar, berguna sepanjang fasa ujian penerimaan.
Selepas itu, semua pengukuran melalui satu arahan tunggal: oaiq("measure", namaPeristiwa, dataPeristiwa, pilihan).
Peristiwa standard, peristiwa tersuai dan kekangannya
Setiap peristiwa standard menjangkakan satu objek data yang medan type-nya mesti sepadan. Dokumentasi pembangun OpenAI mengumpulkannya seperti berikut:
| Keluarga | Peristiwa | Medan type yang dijangka |
|---|---|---|
| Perdagangan | order_created, items_added, checkout_started | contents |
| Kandungan | page_viewed, contents_viewed | contents |
| Prospek dan pendaftaran | lead_created, registration_completed, appointment_scheduled | customer_action |
| Langganan | subscription_created, trial_started | plan_enrollment |
Bagi peristiwa jenis contents, medan yang didokumenkan termasuk amount, currency dan satu tatasusunan contents yang terdiri daripada entri dengan id, name, content_type dan quantity. Peristiwa jenis plan_enrollment menjangkakan satu plan_id. Dokumentasi menjelaskan agar menggunakan nilai integer untuk amount dan quantity.
Apabila tiada peristiwa standard yang sepadan, peristiwa tersuai diisytiharkan dengan argumen ketiga dan satu objek pilihan:
oaiq("measure", "custom", { type: "custom" }, { custom_event_name: "quote_requested" })
Nama peristiwa tersuai mesti mematuhi peraturan yang tepat: antara 1 hingga 64 aksara, hanya huruf, angka, garis bawah dan sengkang, serta bermula dan berakhir dengan aksara abjad angka.
Berhati-hati dengan satu had yang penting: peristiwa tersuai tidak boleh dijadikan objektif pengoptimuman oCPC. Jika penukaran perniagaan anda perlu memandu pengoptimuman, ia mesti dihantar sebagai peristiwa standard.
Menyambungkan Conversions API di sebelah pelayan
API ini digunakan daripada pelayan anda sahaja. Perkara pelaksanaan yang didokumenkan:
- Anda mencipta satu sumber penukaran web dan Pixel ID-nya melalui titik masuk
POST /conversions/pixels. - Anda menjana satu kunci yang mampu menghantar peristiwa di sebelah pelayan bagi akaun pengiklanan semasa.
- Kunci ini mesti disimpan dalam pengurus rahsia di sebelah pelayan. Dokumentasi bersifat tegas: jangan sekali-kali meletakkannya dalam kod pelayar, dalam pemboleh ubah persekitaran yang kelihatan di sebelah klien, dalam log, atau dalam repositori kod.
- API menerima kelompok sehingga 1,000 peristiwa. Perkara kritikal bagi pengendalian ralat anda: jika satu peristiwa sahaja dalam kelompok itu gagal, keseluruhan kelompok akan gagal.
Peraturan terakhir ini wajar ditangani sejak peringkat reka bentuk lagi: satu kelompok yang ditolak sepenuhnya kerana satu medan yang salah format pada satu pesanan boleh melenyapkan 999 penukaran yang sah daripada pelaporan anda.
Menyahduplikasi pixel dan API: peraturan yang tidak boleh terlepas
Jika anda menghantar penukaran yang sama daripada pixel dan daripada Conversions API, anda perlu memberitahu sistem, jika tidak anda akan mengiranya dua kali. Kaedah yang didokumenkan:
- Guna semula nilai yang sama sebagai id di sebelah API dan sebagai event_id di sebelah pixel.
- Hantar kedua-dua peristiwa dengan Pixel ID yang sama.
- Bagi peristiwa tersuai, gunakan custom_event_name yang sama di kedua-dua belah.
Di sebelah pixel, ia kelihatan seperti ini: oaiq("measure", "order_created", {...}, { event_id: "order_12345" }). Padanan ini bersandarkan Pixel ID, nama peristiwa dan event_id; bagi peristiwa tersuai, custom_event_name menggantikan nama peristiwa dalam logik tersebut.
Secara praktikalnya: gunakan pengenal pesanan atau pengenal prospek anda sebagai kunci penyahduplikasian, kerana itulah satu-satunya nilai yang tersedia secara semula jadi di kedua-dua belah.
oppref: kekalkannya sehingga penukaran, bukan sekadar menangkapnya
Pixel menangkap oppref, rujukan klik OpenAI, dan menyimpannya dalam kuki pihak pertama (__oppref). Mendokumenkan penangkapannya sahaja tidak mencukupi: dokumentasi rasmi menegaskan satu perkara yang terlepas pandang oleh banyak pelaksanaan, iaitu oppref mesti dikekalkan merentasi pengalihan dan navigasi sehingga ke halaman tempat penukaran benar-benar diukur. Terowong pembayaran yang melalui subdomain pembayaran, pengalihan selepas satu borang, atau troli yang bertukar domain akan kehilangan kuki itu di tengah jalan jika tiada apa-apa disediakan untuk membawanya bersama.
Perkara kedua yang sering terlepas: Conversions API tidak menangkap oppref untuk anda, berbeza dengan pixel. Jika anda memanggil API di sebelah pelayan, kod andalah yang perlu mendapatkan nilai oppref (lazimnya diletakkan oleh pixel dalam kuki atau dihantar sebagai parameter URL) dan menyertakannya secara eksplisit dalam panggilan tersebut, apabila ia tersedia. Tanpa langkah ini, peristiwa yang dihantar melalui API sahaja akan kehilangan pautan dengan klik iklan yang mendahuluinya.
Seni bina yang disyorkan oleh OpenAI terdiri daripada tiga bahagian: pixel pada setiap halaman untuk menangkap oppref dan peristiwa ringan, Conversions API untuk peristiwa bernilai tinggi yang dihantar daripada back-end anda (di tempat pesanan berada, dan di tempat tiada apa-apa boleh menyekat panggilan itu), serta kedua-dua saluran menghantar penukaran yang sama dengan event_id yang sama.
Automatic Advanced Matching
Automatic Advanced Matching (AAM) berfungsi untuk mengaitkan penukaran dengan iklan anda apabila tiada pengenal klik yang tersedia. Pixel mengesan secara automatik maklumat pelanggan yang boleh dikenali dalam borang dan sumber lain di laman web anda, menormalkannya, dan mencincangnya dalam SHA-256 terus di dalam pelayar. Dokumentasi menjelaskan bahawa tiada data mentah yang dihantar.
Anda juga boleh membekalkan sendiri pengenal yang telah dicincang dalam objek user semasa pemulaan: email_sha256, phone_number_sha256, external_id_sha256, first_name_sha256, last_name_sha256, serta medan yang tidak dicincang iaitu country, city, region dan postal_code.
Ciri ini melibatkan data peribadi: pengaktifannya perlu ditimbang bersama pegawai perlindungan data anda, terutamanya di Eropah.
Persetujuan, GDPR dan pengawalan pixel
SDK ini mendedahkan satu arahan persetujuan, yang perlu dipanggil sebelum pemulaan untuk menyekat pengukuran selagi pengguna belum bersetuju:
oaiq("consent", false); kemudian oaiq("init", { pixelId: "..." }); kemudian oaiq("consent", true); setelah persetujuan diperoleh.
Dua perkara yang perlu diingat. Pertama, persetujuan bernilai true secara lalai, kecuali jika ia ditetapkan kepada false secara eksplisit atau jika satu penolakan telah direkodkan: pada laman web Eropah, anda perlu memanggil oaiq("consent", false) secara eksplisit terlebih dahulu dan bukan bergantung kepada tingkah laku lalai. Kedua, apabila nilainya false, peristiwa pengukuran tidak dihantar.
Selain itu, parameter opt_out membolehkan sesuatu peristiwa dikecualikan daripada pemperibadian pada peringkat pengguna; nilai lalainya ialah false. SDK ini turut menguruskan satu pengenal yang menghormati privasi, iaitu oppref, yang ditangkap daripada URL dan disimpan dalam kuki __oppref.
Peringatan konteks: iklan yang diperibadikan tidak tersedia ketika pelancaran di Kawasan Ekonomi Eropah mahupun di Switzerland. Ini sama sekali tidak mengecualikan anda daripada menguruskan persetujuan bagi pengukuran itu sendiri.
Content Security Policy: domain yang perlu dibenarkan
Punca kegagalan senyap yang paling kerap pada laman web yang menerapkan CSP yang ketat: SDK disekat sebelum sempat dimulakan. Arahan yang didokumenkan:
| Arahan | Sumber yang perlu dibenarkan | Peranan |
|---|---|---|
| script-src | https://bzrcdn.openai.com | Pemuatan SDK |
| connect-src | https://bzr.openai.com dan https://bzrcdn.openai.com | Penghantaran dan pengambilan peristiwa |
| img-src | https://bzr.openai.com | Sandaran melalui permintaan imej |
Jika pixel tidak melaporkan apa-apa walaupun kodnya sudah dipasang dengan betul, buka konsol dengan parameter debug diaktifkan: ralat CSP akan muncul di situ dengan serta-merta.
Apa yang tidak mampu dilakukan oleh pixel
Satu had yang eksplisit, dan perlu diketahui sebelum anda mereka bentuk pelan penandaan anda: pixel pengukuran tidak menyokong peristiwa app_installed dan app_opened. Peristiwa ini mesti dihantar di sebelah pelayan, melalui Conversions API.
Selain itu, OpenAI mendokumenkan integrasi dengan rakan kongsi pengukuran, termasuk rakan kongsi pengukuran mudah alih (MMP), bagi pengiklan yang penukarannya berlaku di dalam sesebuah aplikasi.
Satu lagi perkara yang perlu diberi perhatian: penggunaan beberapa Pixel ID pada laman web yang sama memerlukan konfigurasi khusus, yang didokumenkan secara berasingan oleh OpenAI.
Atribusi: apa yang dikira, dan bagaimana
OpenAI menilai peristiwa penukaran berdasarkan peristiwa yang dikonfigurasikan untuk kempen anda dan tetingkap atribusi yang terpakai. Dua peraturan yang perlu diketahui:
- Atribusi selepas klik menggunakan tetingkap klik yang dikonfigurasikan.
- Penukaran selepas impresi (view-through) menggunakan tetingkap tetap satu hari selepas satu impresi yang layak, dan ia bebas daripada tetingkap klik anda.
Dan inilah peraturan pembacaan yang mengelakkan kesilapan pengiraan: lajur Penukaran yang utama hanya mengandungi penukaran selepas klik. Penukaran selepas impresi ialah pelaporan tambahan yang berasingan, dan menurut OpenAI ia tidak boleh ditambah kepada penukaran mahupun digunakan untuk metrik prestasi asas seperti CPA.
Senarai semak ujian penerimaan sebelum pelancaran
- Sumber data dicipta dalam Ads Manager, Pixel ID diperoleh.
- Skrip dimuatkan dalam head, pemulaan dipanggil dengan Pixel ID yang betul.
- Persetujuan disambungkan sebelum pemulaan bagi laman web Eropah.
- Peristiwa standard dicetuskan di tempat yang betul, dengan medan type yang betul.
- Penyahduplikasian tersedia jika anda menghantar dua kali dengan API: nilai yang sama pada id dan event_id, Pixel ID yang sama.
- CSP dikemas kini bagi ketiga-tiga arahan.
- Mod debug diaktifkan sepanjang tempoh ujian penerimaan, kemudian dimatikan.
- Halaman pendaratan boleh diakses oleh OAI-AdsBot: halaman yang disekat boleh menyebabkan iklan ditolak, tanpa mengira kualiti penandaan. Penyemak halaman pendaratan ChatGPT Ads kami menyemak perkara ini.
- Satu sahaja peristiwa standard yang aktif dipilih sebagai objektif jika anda menyasarkan oCPC, dengan mengetahui bahawa ia tidak lagi boleh diubah selepas kempen dicipta.
Soalan Lazim
Adakah penjejakan penukaran wajib pada ChatGPT Ads?
Adakah Conversions API mengambil oppref dengan sendirinya?
Perlukah memilih antara pixel dan Conversions API?
Bagaimana untuk mengelak daripada mengira satu penukaran dua kali?
Bolehkah peristiwa tersuai dijadikan objektif oCPC?
Adakah pixel menghormati persetujuan pengguna?
Pixel saya tidak melaporkan apa-apa, apa yang perlu disemak dahulu?
Bagaimana untuk mengukur pemasangan aplikasi?
Apakah tetingkap atribusinya?
Skor SEO, skor GEO, prestasi dan responsif : 49 analisis teknikal, keputusan AI Overviews serta-merta.
Panduan Berkaitan
ChatGPT Ads: panduan lengkap 2026 untuk beriklan di ChatGPT
Cara ChatGPT Ads berfungsi, di mana ia tersedia, cara mencipta akaun, menstruktur kempen, menyasar melalui context hints dan menganggar bajet: panduan rujukan yang dikemas kini berterusan.
Baca panduanHarga ChatGPT Ads: bidaan, bajet dan kos sebenar sesebuah kempen
Berapakah kos sebenar kempen ChatGPT Ads: tiga model bidaan, bidaan permulaan yang disyorkan OpenAI, bajet harian minimum dan pengebilan mengikut ambang.
Baca panduanChatGPT Ads untuk e-dagang: kempen daripada suapan produk
Menyambungkan katalog anda ke ChatGPT Ads: tiga kaedah penghantaran suapan, tempoh luput item, medan is_ads_eligible dan bezanya dengan hasil produk organik.
Baca panduan