ChatGPT Ads pixel ve Conversions API: dönüşüm takibini kurmak
Son güncelleme: 24 Ağustos 2026, resmi OpenAI dokümantasyonu üzerinden doğrulandı. Burada anılan olay ve parametre adları OpenAI'nin geliştirici dokümantasyonundan geliyor; beta süresince değişebilirler.
Dönüşüm ölçümü olmadan bir ChatGPT Ads kampanyası kör kalır: ne harcadığınızı bilirsiniz, ne elde ettiğinizi bilmezsiniz. Dahası, dönüşüme göre optimizasyonu açamazsınız. Bu sayfa iki resmi yöntemi, tarayıcı pixel'ini ve sunucu tarafındaki Conversions API'yi, bir de bunların nasıl birlikte yaşatılacağını kapsıyor. Genel çerçeve ChatGPT Ads rehberimizde.
Bu sayfada ele alınan yapay zeka motorları
- ChatGPT
Ölçüm neden bir seçenek değil, ön koşuldur
Üç neden, biri engelleyici:
- Engelleyici: dönüşüme göre optimizasyon (oCPC), takibin JavaScript pixel, Conversions API ya da her ikisi üzerinden önceden kurulmuş olmasını şart koşuyor. Sinyal yoksa sistemin optimize edecek bir şeyi de yoktur.
- Ads Manager raporlaması, hiçbir şey bağlı değilse boş kalan bir dönüşümler sütunu içeriyor.
- Edinme başına maliyet hesabınız tamamen bu veriye bağlıdır: onsuz CPC'ye göre, yani sonuca değil harcamaya göre yönetirsiniz.
OpenAI'nin ortaya koyduğu genel ilke basit: Ads Manager içinde bir veri kaynağı (data source) oluşturursunuz, ardından ona pixel, API ya da her ikisi üzerinden dönüşüm olayları gönderirsiniz.
Pixel mi, Conversions API mi: hangisi seçilmeli?
| JavaScript pixel | Conversions API | |
|---|---|---|
| Nerede çalışır | Ziyaretçinin tarayıcısında | Yalnızca sizin sunucunuzda |
| Kurulum | head bölümüne konacak bir script | Back-end tarafında geliştirme |
| Dayanıklılık | Engelleyicilere ve tarayıcı kısıtlarına duyarlı | OpenAI bunu tek başına pixel'den daha güvenilir bir kaynak olarak sunuyor |
| OpenAI tavsiyesi | Başlangıç noktası | Daha kesin veri için mümkün olduğunda kullanın |
Pragmatik yanıt “biri ya da öteki” değil, “ikisi birden, tekilleştirmeyle” şeklindedir. Pixel bir saatte kurulur ve kampanyaları hemen yaşatır; API sonra bağlanır ve ölçümü kalıcı biçimde güvenceye alır.
Ölçüm pixel'ini kurmak
ChatGPT Ads ölçüm pixel'i, sitenizdeki olaylardan ChatGPT içindeki reklamlara atfedilebilenleri ölçmeye yönelik bir tarayıcı SDK'sıdır. Script, https://bzrcdn.openai.com/sdk/oaiq.min.js adresinden eşzamansız olarak yüklenir, <head> bölümüne konur ve ardından pixel kimliğinizle başlatılır:
oaiq("init", { pixelId: "PIXEL-ID-DEGERINIZ" });
pixelId parametresi zorunludur ve Ads Manager içinde oluşturulur. İsteğe bağlı bir debug parametresi SDK etkinliğini tarayıcı konsoluna yazar; kabul testi aşamasında işe yarar.
Tüm ölçüm daha sonra tek bir komuttan geçer: oaiq("measure", olayAdi, olayVerisi, secenekler).
Standart olaylar, özel olaylar ve kısıtları
Her standart olay, type alanı eşleşmesi gereken bir veri nesnesi bekler. OpenAI'nin geliştirici dokümantasyonu bunları şöyle gruplandırıyor:
| Aile | Olaylar | Beklenen type alanı |
|---|---|---|
| Ticaret | order_created, items_added, checkout_started | contents |
| İçerik | page_viewed, contents_viewed | contents |
| Potansiyel müşteri ve kayıt | lead_created, registration_completed, appointment_scheduled | customer_action |
| Abonelik | subscription_created, trial_started | plan_enrollment |
contents türündeki olaylar için belgelenen alanlar arasında amount, currency ve id, name, content_type, quantity girdilerinden oluşan bir contents dizisi bulunuyor. plan_enrollment türündeki olaylar bir plan_id bekliyor. Dokümantasyon amount ve quantity için tam sayı değerleri kullanılmasını belirtiyor.
Hiçbir standart olay uymadığında, özel bir olay üçüncü bir argüman ve bir seçenek nesnesiyle bildirilir:
oaiq("measure", "custom", { type: "custom" }, { custom_event_name: "quote_requested" })
Özel olay adları kesin kurallara uymalıdır: 1 ila 64 karakter, yalnızca harf, rakam, alt çizgi ve tire, ayrıca alfanümerik bir karakterle başlayıp bitmek.
Yapısal bir sınıra dikkat: özel bir olay oCPC optimizasyon hedefi olarak kullanılamaz. İş dönüşümünüz optimizasyonu yönetecekse, onu standart bir olay olarak göndermek gerekir.
Conversions API'yi sunucu tarafında bağlamak
API yalnızca sizin sunucunuzdan kullanılır. Belgelenen uygulama noktaları:
POST /conversions/pixelsuç noktası üzerinden bir web dönüşüm kaynağı ve Pixel ID'si oluşturursunuz.- Geçerli reklam hesabı adına sunucu tarafında olay gönderebilen bir anahtar üretirsiniz.
- Bu anahtar sunucu tarafındaki bir gizli bilgi yöneticisinde saklanmalıdır. Dokümantasyon kesin: anahtarı asla tarayıcı koduna, istemci tarafında görünür ortam değişkenlerine, günlüklere ya da bir kod deposuna koymayın.
- API 1.000 olaya kadar toplu gönderim kabul ediyor. Hata yönetiminiz için kritik nokta: toplu gönderimdeki tek bir olay başarısız olursa tüm toplu gönderim başarısız olur.
Bu son kural daha tasarım aşamasında ele alınmayı hak ediyor: tek bir siparişteki hatalı biçimlendirilmiş bir alan yüzünden toptan reddedilen bir gönderim, raporlamanızdan 999 geçerli dönüşümü silebilir.
Pixel ve API'yi tekilleştirmek: kaçırılmaması gereken kural
Aynı dönüşümü hem pixel'den hem Conversions API'den gönderiyorsanız bunu sisteme söylemeniz gerekir, yoksa onu iki kez sayarsınız. Belgelenen yöntem:
- API tarafında id, pixel tarafında event_id olarak aynı değeri kullanmak.
- İki olayı da aynı Pixel ID ile göndermek.
- Özel olaylar için iki tarafta da aynı custom_event_name'i kullanmak.
Pixel tarafında bu şuna benzer: oaiq("measure", "order_created", {...}, { event_id: "order_12345" }). Eşleştirme Pixel ID, olay adı ve event_id üzerine kuruludur; özel bir olayda bu mantıkta olay adının yerini custom_event_name alır.
Pratikte: tekilleştirme anahtarı olarak sipariş ya da potansiyel müşteri kimliğinizi kullanın, iki tarafta da doğal olarak bulunan tek değer budur.
oppref: yalnızca yakalamak değil, dönüşüme kadar korumak
Pixel, OpenAI'nin tıklama referansı olan oppref'i yakalar ve bunu birinci taraf bir çerezde (__oppref) saklar. Yakalanmasını belgelemek yeterli değildir: resmi dokümantasyon, birçok uygulamanın kaçırdığı bir noktayı vurguluyor, oppref, dönüşümün gerçekten ölçüldüğü sayfaya kadar yönlendirmeler ve gezinme boyunca korunmalıdır. Bir ödeme alt alan adından geçen ödeme tüneli, bir formdan sonraki yönlendirme ya da alan adı değiştiren bir sepet, çerezi taşımak için hiçbir şey öngörülmemişse yolda kaybeder.
Sık kaçırılan ikinci nokta: pixel'in aksine, Conversions API oppref'i sizin için yakalamaz. API'yi sunucu tarafında çağırıyorsanız, oppref değerini (genellikle pixel tarafından bir çerezde bırakılır ya da URL parametresi olarak iletilir) alıp, mevcut olduğunda çağrıya açıkça eklemek kodunuzun görevidir. Bu adım atlanırsa, yalnızca API ile gönderilen bir olay kendisinden önce gelen reklam tıklamasıyla bağlantısını kaybeder.
OpenAI'nin önerdiği mimari üç parçadan oluşur: oppref'i ve hafif olayları yakalamak için her sayfada pixel, back-end'inizden gönderilen yüksek değerli olaylar için Conversions API (siparişin elinizde olduğu ve hiçbir şeyin çağrıyı engelleyemediği yer), ve aynı dönüşümü aynı event_id ile gönderen iki kanal.
Otomatik advanced matching
Otomatik advanced matching (AAM), hiçbir tıklama tanımlayıcısı bulunmadığında dönüşümleri reklamlarınıza bağlamaya yarar. Pixel, sitenizdeki formlarda ve diğer kaynaklarda tanınabilir müşteri bilgilerini otomatik olarak algılar, normalleştirir ve doğrudan tarayıcıda SHA-256 ile özetler. Dokümantasyon hiçbir ham verinin iletilmediğini belirtiyor.
Özetlenmiş tanımlayıcıları başlatma sırasında user nesnesi içinde kendiniz de sağlayabilirsiniz: email_sha256, phone_number_sha256, external_id_sha256, first_name_sha256, last_name_sha256, ayrıca özetlenmemiş country, city, region ve postal_code alanları.
Bu işlev kişisel verilere dokunuyor: etkinleştirilmesi, özellikle Avrupa'da, veri koruma sorumlunuzla birlikte karara bağlanmalıdır.
Rıza, GDPR ve pixel'in yönetimi
SDK, kullanıcı kabul edene kadar ölçümü engellemek için başlatmadan önce çağrılacak bir rıza komutu sunuyor:
oaiq("consent", false); ardından oaiq("init", { pixelId: "..." }); ve rıza alındıktan sonra oaiq("consent", true);.
Akılda tutulacak iki nokta. Birincisi, rıza varsayılan olarak true değerindedir, açıkça false yapılmadıkça ya da bir ret kaydedilmedikçe: dolayısıyla bir Avrupa sitesinde varsayılan davranışa güvenmek yerine önceden açıkça oaiq("consent", false) çağırmak gerekir. İkincisi, değer false olduğunda ölçüm olayları gönderilmez.
Ayrıca bir opt_out parametresi bir olayı kullanıcı düzeyinde kişiselleştirmenin dışında tutmaya izin veriyor; varsayılan değeri false. SDK bunun yanında gizliliğe saygılı bir tanımlayıcıyı, URL'den yakalanan ve __oppref çerezinde saklanan oppref değerini de yönetiyor.
Bağlam hatırlatması: kişiselleştirilmiş reklamlar lansmanda Avrupa Ekonomik Alanı'nda ve İsviçre'de kullanılamıyor. Bu, ölçümün kendisi için rıza yönetiminden hiçbir şekilde muaf tutmaz.
Content Security Policy: izin verilecek alan adları
Katı bir CSP uygulayan sitelerde en sık görülen sessiz arıza nedeni: SDK daha başlatılmadan engellenir. Belgelenen direktifler:
| Direktif | İzin verilecek kaynak | Rolü |
|---|---|---|
| script-src | https://bzrcdn.openai.com | SDK'nın yüklenmesi |
| connect-src | https://bzr.openai.com ve https://bzrcdn.openai.com | Olayların gönderilmesi ve alınması |
| img-src | https://bzr.openai.com | Görsel isteğiyle yedek yol |
Kod doğru yerdeyken pixel hiçbir şey göndermiyorsa, debug parametresi etkinken konsolu açın: bir CSP hatası orada hemen görünür.
Pixel'in yapamadıkları
Etiketleme planınızı tasarlamadan önce bilinmesi gereken açık bir sınır: ölçüm pixel'i app_installed ve app_opened olaylarını desteklemiyor. Bu olaylar sunucu tarafında, Conversions API üzerinden gönderilmelidir.
OpenAI ayrıca, dönüşümü bir uygulama içinde gerçekleşen reklamverenler için mobil ölçüm iş ortakları (MMP) dahil olmak üzere ölçüm iş ortaklarıyla entegrasyonlar belgeliyor.
Bir başka dikkat noktası: aynı sitede birden fazla Pixel ID kullanmak özel bir yapılandırma gerektiriyor ve OpenAI bunu ayrıca belgeliyor.
Atıf: neyin, nasıl sayıldığı
OpenAI dönüşüm olaylarını, kampanyanız için yapılandırılmış olaylar ve geçerli atıf penceresi üzerinden değerlendiriyor. Bilinmesi gereken iki kural:
- Tıklama sonrası atıf, yapılandırılan tıklama penceresini kullanır.
- Gösterim sonrası dönüşümler (view-through), uygun bir gösterimden sonra sabit bir günlük pencere kullanır ve bu pencere sizin tıklama pencerenizden bağımsızdır.
Ve hesap hatalarını önleyen okuma kuralı: ana Dönüşümler sütunu yalnızca tıklama sonrası dönüşümleri içerir. Gösterim sonrası dönüşümler ayrı bir ek raporlamadır ve OpenAI'ye göre dönüşümlere eklenmemeli, CPA gibi temel performans metriklerinde kullanılmamalıdır.
Lansmandan önce kabul testi kontrol listesi
- Ads Manager içinde veri kaynağı oluşturuldu, Pixel ID alındı.
- Script head bölümüne yüklendi, başlatma doğru Pixel ID ile çağrıldı.
- Avrupa sitelerinde rıza, init'ten önce bağlandı.
- Standart olaylar doğru yerlerde, doğru type alanıyla tetikleniyor.
- API ile ikileme yapıyorsanız tekilleştirme yerinde: id ve event_id aynı değer, aynı Pixel ID.
- CSP üç direktif için güncellendi.
- Kabul testi süresince debug modu açık, sonrasında kapalı.
- Açılış sayfası OAI-AdsBot'a erişilebilir: engellenmiş bir sayfa, etiketlemenin kalitesinden bağımsız olarak reklamın reddedilmesine yol açabilir. ChatGPT Ads açılış sayfası testimiz bu noktayı kontrol ediyor.
- oCPC hedefliyorsanız hedef olarak tek bir aktif standart olay seçildi; bunun kampanya oluşturulduktan sonra değiştirilemeyeceğini bilerek.
Sık sorulan sorular
ChatGPT Ads'te dönüşüm takibi zorunlu mu?
Conversions API oppref'i kendiliğinden mi alır?
Pixel ile Conversions API arasında seçim yapmak gerekir mi?
Bir dönüşümü iki kez saymaktan nasıl kaçınılır?
Özel bir olay oCPC hedefi olarak kullanılabilir mi?
Pixel kullanıcının rızasına uyuyor mu?
Pixel'im hiçbir şey göndermiyor, önce ne kontrol edilmeli?
Bir uygulama yüklemesi nasıl ölçülür?
Atıf penceresi nedir?
SEO skoru, GEO skoru, performans ve responsive: 49 teknik analiz, anında AI Overviews sonucu.
İlgili rehberler
ChatGPT Ads: ChatGPT'de reklam vermek için 2026 kapsamlı rehberi
ChatGPT Ads nasıl çalışır, hesap nasıl açılır, kampanya nasıl kurgulanır, context hints ile nasıl hedefleme yapılır ve bütçe nasıl tahmin edilir: sürekli güncellenen başvuru rehberi.
Rehberi okuChatGPT Ads fiyatları: açık artırma, bütçeler ve bir kampanyanın gerçek maliyeti
Bir ChatGPT Ads kampanyası gerçekte ne kadara mal olur: üç teklif modeli, OpenAI'nin önerdiği başlangıç teklifi, minimum günlük bütçe ve eşiğe göre faturalama.
Rehberi okuE-ticaret için ChatGPT Ads: product feed ile kampanya kurmak
Kataloğunuzu ChatGPT Ads'e bağlamak: üç akış gönderim yöntemi, ürünlerin süre sonu, is_ads_eligible alanı ve organik ürün sonuçlarıyla arasındaki fark.
Rehberi oku