PrestaShop için ChatGPT Ads modülü: dönüşümler, sepete ekleme ve CAPI

Modül ne yapar, etkinlik etkinlik

Modül, PrestaShop satın alma yolculuğunu OpenAI’nin tanımladığı standart etkinliklere dönüştürür:

• ürün sayfasında, gösterilen varyasyonun kimliği, adı ve fiyatıyla contents_viewed;
• ürün listesinden veya temanın açılır penceresinden AJAX ile yapılanlar dahil, sepete eklemede items_added;
• ödeme sürecine girişte checkout_started;
• satın almada, hem onay sayfasındaki piksel hem de sunucu tarafından gönderilen order_created;
• müşteri hesabı oluşturulduğunda registration_completed ve isterseniz iletişim formunda lead_created.

En önemlisi satın alma etkinliğidir: dönüşüm odaklı bir kampanyanın hedefi olarak onu seçeceksiniz. Müşteri ödeme sayfasından dönsün ya da dönmesin, PrestaShop siparişi onayladığı anda actionValidateOrder kancası aracılığıyla sunucudan gönderilir. Havale veya çek gibi ertelenmiş ödeme yöntemleri için hangi sipariş durumunun esas alınacağına birlikte karar veririz.

oppref, tekilleştirme ve gönderilen veriler

Bir ziyaretçi reklamdan geldiğinde URL bir oppref parametresi taşır. Piksel bunu __oppref çerezine kaydeder, ancak Conversions API onu kendiliğinden okumaz. Bu nedenle modül onu gelişte yakalar, önce PrestaShop sepetine, sonra siparişe bağlar ve obref tarayıcı kimliğiyle birlikte sunucu çağrısına ekler. Sepetini üç gün sonra tamamlamaya dönen bir müşteri de tıklamasıyla ilişkili kalır.

Tekilleştirme için modül, sipariş oluşturulurken opak bir kimlik üretir ve her iki tarafta kullanır: pikselde event_id, Conversions API’de id; aynı Pixel ID ve aynı etkinlik adıyla. OpenAI böylece tek bir satış tutar. Tutar, belgelerin gerektirdiği gibi sipariş para biriminin alt birimi cinsinden tam sayı olarak gönderilir.

Müşteri e-postaları ve telefon numaraları mağazadan asla açık metin olarak çıkmaz: gönderimden önce normalleştirilir ve SHA-256 ile özetlenir. Conversions API anahtarı sunucuda, modül yapılandırmasında kalır; asla tema JavaScript’ine girmez.

Onay, GDPR ve çerez bandı araçları

Ziyaretçi onay vermeden hiçbir şey yüklenmez veya gönderilmez: betik yok, __oppref ya da __obref çerezi yok, sunucu çağrısı yok. Modül, pikselin özel hizmet olarak tanımlandığı tarteaucitron.js ile ve pazarlama amacına bağlandığı Axeptio, Cookiebot, Didomi, CookieYes veya Complianz ile uyumludur. Bant yayınladığında Google Consent Mode’un reklam depolama sinyalini de okuyabilir.

Onay durumu siparişle birlikte kaydedilir: reddeden bir müşteri Conversions API ile iletilmez. Gizlilik politikanız ve işleme kayıtlarınız için gönderilen verilerin tam listesini size veririm; hukuki dayanağı seçmek size veya veri koruma görevlinize aittir.

PrestaShop uyumluluğu

Modül PrestaShop 1.7, 8 ve 9 için tasarlanmıştır. Çekirdek geçersiz kılmaları (override) yerine standart kancalara dayanır: ne PrestaShop sınıflarını ne de tema dosyalarını değiştirir ve temiz bir şekilde kaldırılır. Çoklu mağazada her mağazanın kendi Pixel ID’si ve anahtarı olabilir; çoklu para biriminde her sipariş kendi para birimiyle gönderilir. Yönetim panelinden erişilebilen bir günlük, sunucu gönderimlerini ve OpenAI yanıtlarını kaydeder; böylece bir fark, sunucu dosyalarını açmadan incelenebilir.

Çok özelleştirilmiş bir tema veya üçüncü taraf tek sayfalık bir ödeme süreci bir ayar gerektirebilir: kurulumu size yüklenecek bir dosya bırakmak yerine bizzat yapmamın nedeni tam olarak budur. ChatGPT Ads takibinin genel mantığı için OpenAI pikseli, Conversions API ve onay üzerine eksiksiz rehberi okuyun.