ChatGPT Reklam Pikseli Kurulumu

ChatGPT Reklam Pikseli Nedir

ChatGPT reklam ölçüm pikseli (ChatGPT Ads Measurement Pixel), OpenAI\'nin sunduğu JavaScript tabanlı bir ölçüm teknolojisidir. Web sitenize eklendiğinde ChatGPT Ads\'teki sponsor kartını tıklayan kişinin, sizin için önemli bir işlem yapıp yapmadığını (satın alma, form gönderimi, kayıt) ölçebilirsiniz.

Akış basittir: kullanıcı sponsor kartı tıklar, tıklama referansıyla sitenize gelir, piksel bunu yakalar ve dönüşüm olayını gönderir; olay OpenAI Ads Manager\'de görünür.

ChatGPT Reklamı
   ↓
Kullanıcı reklamı tıklar
   ↓
Siteniz (URL'de ?oppref=... var)
   ↓
OpenAI Pikseli
   ↓
Dönüşüm olayı
   ↓
OpenAI Ads Manager → dönüşüm raporu

Piksel ve Conversions API Farkı

OpenAI, dönüşüm verisi göndermek için iki yöntem sunar ve her birinin uzmanlık alanı farklıdır.

Aynı dönüşümü iki kanaldan gönderirken event_idyi aynı yapın ki OpenAI tek olay görsün ve çift sayılmasın.

Başlamadan Önce Gerekenler

• OpenAI Ads Manager hesabı (ölçüm ayarlarına erişim).
• Ads Manager'de oluşturulmuş bir veri kaynağı (piksel) — Pixel ID'nin kaynağı.
• Baş kısmına script ekleyebildiğiniz bir web sitesi (ya da etiket yöneticisi / eklenti / geliştirici).
• Ölçmek istediğiniz dönüşüm olayı. Ads Manager ayarı ile site gönderimi eşleşmelidir.
• Conversions API kullanacaksanız sunucu erişimi ve erişim belirtecinin güvenli saklanması.

Adım 1 — Pikseli Siteye Kurun

Ads Manager\'de bir veri kaynağı oluşturun, Pixel ID\'nizi (pId_...) kopyalayın ve dönüşüm olabilecek tüm sayfalara JavaScript ekleyin. Temel uygulama şöyledir.

<script>
  (function (w, d, s, u) {
    if (w.oaiq) return;
    var q = function () {
      q.q.push(arguments);
    };
    q.q = [];
    w.oaiq = q;
    var js = d.createElement(s);
    js.async = true;
    js.src = u;
    var f = d.getElementsByTagName(s)[0];
    f.parentNode.insertBefore(js, f);
  })(window, document, "script", "https://bzrcdn.openai.com/sdk/oaiq.min.js");

  oaiq("init", {
    pixelId: "SENIN_PIXEL_ID"
  });
</script>

İki nokta önemli. if (w.oaiq) return guard\'ı, snippet iki kere kurulursa SDK\'nın tekrar yüklenmesini engeller. SDK sürekli geliştiği için her zaman OpenAI geliştirici dokümanlarındaki güncel snippet\'i kullanın ve canlıya almadan önce parametreleri doğrulayın.

Adım 2 — Dönüşüm Olayını Yapılandırın

Pikseli kurmak, her eylemi otomatik olarak dönüşüm yapmaz. Sitenin gönderdiği olay, Ads Manager\'de tanımladığınız dönüşümle eşleşmelidir.

Site olayı:       order_created        Ads Manager:  order_created
Site olayı:       quote_requested      Ads Manager:  Özel → quote_requested

Özel olaylarda ad birebir aynı olmalıdır; benzemek yetmez. Olay adları küçük harfli snake_case\'dir (order_created, değil orderCreated).

Adım 3 — Satın Alma Olayını Ölçün

E-ticarette satın alma olayı en öncelikli dönüşümdür. Sipariş onaylandığı anda gönderin.

oaiq("measure", "order_created", {
  type: "contents",
  amount: 2599,
  currency: "USD",
  contents: [
    {
      id: "SKU-123",
      name: "Başlangıç Paketi",
      content_type: "product",
      quantity: 1
    }
  ]
}, {
  event_id: "order_12345"
});

order_created olay adıdır; amount ve currency değeri belirtir; contents satın alınan ürünleri taşır; event_id tekilleştirme için benzersiz kimliktir. Alan sözleşmesi için OpenAI dokümanlarındaki desteklenen olay şemasını izleyin.

Adım 4 — Potansiyel Müşteri Olayını Ölçün

Potansiyel müşteri üreten sitelerde form gönderildiğinde lead olayını gönderin.

oaiq("measure", "lead_created", {
  type: "customer_action"
}, {
  event_id: "lead_98765"
});

Adım 5 — Özel Dönüşüm Olayı

Her dönüşüm satın alma ya da lead değildir. Demo talebi, teklif talebi, hesap makinesi tamamlama, kayıt ve danışma randevusu özel olaylara uygundur.

oaiq("measure", "custom", {
  type: "custom"
}, {
  custom_event_name: "quote_requested"
});

Ads Manager\'de de aynı özel olay adını tanımlayın. Özel adlar harf, rakam, alt çizgi ve tire içerebilir (1-64 karakter) ve standart olay adlarıyla çakışamaz.

Otomatik Gelişmiş Eşleştirme

Tıklama kimliği dönüşümü bağlayamıyorsa Otomatik Gelişmiş Eşleştirme (Automatic Advanced Matching), adresi e-posta vb. uygun birinci taraf müşteri bilgileriyle ölçümü iyileştirir. Piksel, bilgiyi tarayıcı içinde SHA-256 ile normalleştirip hash\'ler.

E-postayı elle hash\'lemenize gerek yoktur. Standart otomatik gelişmiş eşleştirme kurulumunda OpenAI rehberine göre pikselde ek değişiklik gerekmez ve AAM üzerinden OpenAI\'ye ham müşteri verisi gönderilmez.

oppref — Tıklamayı URL\'ye Bağlayan Referans

oppref, ChatGPT Ads\'in açılış sayfası URL\'sine eklediği tıklama referansı sinyalidir.

https://example.com/products?oppref=gAAAAAb123

Piksel bu değeri birinci taraf çerefine kaydederek sonraki sayfa geçişlerini ve dönüşüm olayını ilk reklam tıklamasına bağlar. Sunucu Conversions API olaylarında da oppref mevcutsa onu kaybetmeden iletmek ölçüm kalitesini artırır.

Kural: yeniden yönlendirme, açılış sayfası yönlendirmesi veya kendi izleme sisteminizi kurarken oppref\'i URL\'den silmeyin.

Piksel ve Conversions API Tekilleştirme

İki kanal aktifken tek bir sipariş hem tarayıcı pikselinden hem sunucudan OpenAI\'ye ulaşır. OpenAI, Pixel ID·olay adı· event_id kombinasyonuyla kopyayı tespit eder.

Sipariş ORD-10001
   ├── Tarayıcı pikseli ──→  event_id = ORD-10001
   └── CAPI sunucusu ────→  event_id = ORD-10001

OpenAI önce geleni kaydeder, kopyayı yok sayar.

event_id\'yi bir kez oluşturun (gerçek sipariş kimliği yeterlidir) ve piksel çağrısı ile sunucu çağrısında birebir aynı değeri kullanın.

Google Tag Manager Kurulumu

Google Tag Manager (GTM) önerilen bir uygulama yoludur ancak başlatma ile olay çağrılarının sırasını engellememeli veya değiştirmemelidir. Konteyneri üç etikete göre kurun.

• Etiket 1 — Piksel tabanı: her sayfada başlatma (Pixel ID'li snippet'i çalıştırır).
• Etiket 2 — Satın alma pikseli: satın alma/sipariş onayında tetiklenir, veri katmanından değer alır.
• Etiket 3 — Lead pikseli: lead formu gönderilince tetiklenir.

Mevcut veri katmanı olaylarını eşleyin; piksel diğer analitiklerinizle aynı tetikleme noktasında ateşlensin.

WooCommerce Kurulumu

WooCommerce\'te dönüşüm hunisi genellikle "ürün görüntüleme → sepete ekleme → ödeme başlatma → sipariş onayı" şeklindedir. İş dönüşümü sipariş olayıdır.

WooCommerce
   ↓
Sipariş onaylandı
   ↓
Benzersiz sipariş kimliği oluştur
   ↓
Tarayıcı pikseli ────┐
                     ├── OpenAI reklamı (aynı event_id)
CAPI sunucusu ──────┘

WooCommerce sipariş kimliğini event_id olarak kullanın. Gerçekten benzersiz bir değer, tekilleştirmeyi güvenilir yapar. WordPress\'te ücretsiz Ridoway Pixel eklentisi pikseli, sunucu çağrılarını ve event_id tekilleştirmesini otomatik halleder.

Onay ve Gizlilik

İzlemeyi devreye almadan önce ülkenizin onay gerekliliklerini, kullanıcılarınızın yetki alanını ve gizlilik politikasını inceleyin. OpenAI rehberi nettir: Hangi verilerin toplandığını açıkça beyan etmeli ve yasa gerektiriyorsa dönüşüm verisi göndermeden önce uygun onayı almalısınız.

• Gizlilik politikası ile çerez/izleme bildirimini yayımlayın.
• Gerekirse onay yönetimine (KVKK, GDPR vb.) bağlanın.
• Veri saklama süresini ve olayların gideceği kanalları belirleyin.
• SDK'nin varsayılan olarak onay "aktif" ile başladığını ve init'ten önce bile oaiq("consent", false) desteklediğini unutmayın.

Dönüşüm Görünmüyorsa Kontrol Sırası

Piksel çalışsa bile dönüşüm Ads Manager\'de hemen görünmeyebilir. Şu sırayla kontrol edin.

• Piksel başlatılıyor mu — DevTools/Network'de bzrcdn.openai.com'dan SDK yüklendi mi?
• Pixel ID doğru mu — yanlış kimlik olayları başka veri kaynağına gönderir, sütununuz boş kalır.
• Olay adı eşleşiyor mu — site olayı, Ads Manager dönüşümüyle birebir aynı olmalı (özelde yazım farkına dikkat).
• Dönüşüm tanımı var mı — kampanyaya olaydan türetilen dönüşüm tanımı bağlanmalı.
• oppref korunuyor mu — tıklama referansı kaybolursa ilişkilendirme kalitesi düşer.
• Tekilleştirme doğru mu — tek dönüşümün tarayıcı ve sunucu olayları aynı event_id'yi kullanmalı.
• Raporlama gecikmesi — OpenAI doğru ilişkilendirilen dönüşümlerin 24-48 saat içinde göründüğünü belirtir.

Pikseli hızlıca doğrulamak için ücretsiz ChatGPT Ads Pixel Checker; tarayıcı uzantısı Pixel Helper ise init ve measure çağrılarını anında gösterir.

Ads Manager ile Google Analytics Neden Farklı

Platformlar arası dönüşüm toplamlarının farklı olması normaldir. OpenAI reklamı ile Google Analytics aynı ilişkilendirme metodolojisini kullanmaz. Fark; ilişkilendirme pencereleri, zaman damgaları, saat dilimleri, onay, tarayıcı kısıtları, saklama durumu, tekilleştirme, kampanya ayarları ve modellenen ölçümden kaynaklanır.

OpenAI Ads:        100 dönüşüm
Google Analytics:   82 dönüşüm

Bu fark piksel arızası değildir. OpenAI de analitik platformları arasında toplamların farklılaşabileceğini belirtir.

Güncel Raporlama ve İlişkilendirme Pencereleri

Ads Manager (Beta) güncel olarak gösterim, tıklama, harcama, TO (CTR), ortalama TBM ve ortalama BGM\'yi ve ölçüm yapılandırıldığında dönüşümleri raporlar. Tıklama tabanlı ve görüntüleme tabanlı dönüşümler ayrı gösterilir. Eylül 2026 itibarıyla kullanılabilen ilişkilendirme penceresi kombinasyonları şunlardır.

Ads Manager (Beta) gelişmeye devam ettiği için optimizasyon kararı öncesinde en güncel pencereleri ve metrikleri OpenAI dokümanlarından doğrulayın.

Eksiksiz Ölçüm Mimarisi

Sağlam modern kurulum, iki kanalı tek akışta birleştirir.

               CHATGPT ADS
                    │
                    ▼
               Reklam tıklaması
                    │
                    ▼
          Açılış sayfası (oppref)
                    │
        ┌───────────┴───────────┐
        ▼                       ▼
  OpenAI Pikseli          Site / Sunucu
        │                       │
        │                 Dönüşüm olayı
        │                       │
        ▼                       ▼
      Tarayıcı              Conversions API
        │                       │
        └───────────┬───────────┘
                    │
                aynı event_id
                    │
                    ▼
            OpenAI Ölçümü
                    │
                    ▼
               Ads Manager
                    │
         ┌───────────┼───────────┐
         ▼           ▼           ▼
       Tıklama    Dönüşüm       ROAS

Bir tıklama, iki olay kanalı, tek ortak event_id ve Ads Manager\'de tek rapor ekranı. Resmin tamamı budur.

Ölçüm Ortakları

Dışarıda ilişkilendirme, raporlama veya optimizasyon katmanı istiyorsanız OpenAI üçüncü taraf ölçüm ortaklarını da destekler. Eylül 2026 dokümantasyonundaki örnekler: Fospha, Hightouch, LiveRamp, Triple Whale ve WorkMagic. Mobil ölçüm için AppsFlyer, Adjust ve Branch entegrasyonları dokümante edilmiştir; yetenekler ortağa göre değişir.

En İyi Uygulamalar

• Pikseli yalnızca ana sayfaya değil, ölçümün önemli olduğu tüm sayfalara kurun.
• Yeniden yönlendirme, yönlendirme ve özel izlemede oppref'i silmeyin.
• Teknik ve iş olarak mümkünse piksel ile Conversions API'yi birlikte kullanın.
• Aynı dönüşümü tarayıcı ve sunucudan gönderiyorsanız aynı event_id'yi kullanın.
• Dönüşüm olay adlarını birebir eşleştirin (özel olaylarda özellikle).
• Otomatik Gelişmiş Eşleştirmeyi anlayın: standart kurulumda elle hash gerekmez.
• Hafta sonu rakamlarını yorumlamadan önce 24-48 saatlik raporlama gecikmesini hesaba katın.
• Ads Manager, GA4 ve diğer platformları körü körüne kıyaslamayın (metodolojiler farklı).

Sık Sorulan Sorular