Platform Entegrasyonları
Entegrasyonlar
Ödeme sistemleri, kargo API, reklam platformları ve sosyal medya kanallarını SageCommerce admin panelinizden tek noktadan yönetin.
Ödeme Sistemleri
Admin paneli → Ayarlar → Ödeme Ayarları — SageCommerce, Türkiye'nin en yaygın ödeme altyapılarını destekler.
Iyzico
Iyzico ile kredi/banka kartı, taksitli ödeme ve 3D Secure ödeme alabilirsiniz. Entegrasyon için Iyzico'dan API anahtarı almanız gerekir.
Iyzico hesabı açın ve onay alın
iyzico.com üzerinden başvurun. Hesabınız onaylandıktan sonra Iyzico panelindeki Ayarlar → API Anahtarları bölümüne gidin.
API anahtarlarını kopyalayın
Iyzico panelinden API Key ve Secret Key değerlerini kopyalayın. Canlı ve test ortamları için ayrı anahtarlar mevcuttur.
SageCommerce'e girin
Admin → Ayarlar → Ödeme Ayarları → Iyzico bölümüne gelin. API Key ve Secret Key alanlarını doldurun.
Taksit seçeneklerini yapılandırın
Hangi kartlarda kaç taksit sunacağınızı Iyzico panelinden belirleyin. SageCommerce taksit seçeneklerini Iyzico API'sinden otomatik çeker.
Entegrasyonu aktif edin
"Iyzico'yu Etkinleştir" anahtarını açın ve kaydedin. Ödeme adımında Iyzico formu görünmeye başlar.
Canlıya geçmeden önce test ortamı anahtarlarıyla ödeme akışını mutlaka doğrulayın. Test kartı bilgilerini Iyzico resmi belgelerinden edinebilirsiniz.
PayTR
PayTR iFrame yöntemiyle kredi kartı, banka kartı ve taksitli ödeme alabilirsiniz. PayTR'ın sanal POS'u doğrudan entegre çalışır.
PayTR hesabı açın ve sanal POS başvurusu yapın
paytr.com adresinden başvurun. Başvurunuz onaylandıktan sonra PayTR paneline erişebilirsiniz.
Merchant ID, Secret Key ve Merchant Salt değerlerini alın
PayTR panelindeki Mağaza Ayarları bölümünde bu üç değeri bulabilirsiniz.
SageCommerce'e girin
Admin → Ayarlar → Ödeme Ayarları → PayTR bölümünde Merchant ID, Secret Key ve Salt alanlarını doldurun.
Geri bildirim URL'sini ayarlayın
PayTR panelinde Başarılı URL ve Başarısız URL alanlarına SageCommerce'in ödeme sonuç sayfalarını girin. Bu değerler admin panelinde size gösterilir.
Entegrasyonu aktif edin
"PayTR'yi Etkinleştir" anahtarını açın ve kaydedin.
| Özellik | Iyzico | PayTR |
|---|---|---|
| 3D Secure | Destekleniyor | Destekleniyor |
| Taksit | Tüm Türk bankaları | Tüm Türk bankaları |
| Havale/EFT | Desteklenmiyor | Destekleniyor |
| Para Birimi | TRY, USD, EUR | TRY |
| Komisyon Yapısı | PayTR panelinden belirlenir | Iyzico panelinden belirlenir |
Kargo API (Basit Kargo)
Admin paneli → Ayarlar → Kargo Ayarları — SageCommerce, Basit Kargo entegrasyon katmanı aracılığıyla Yurtiçi Kargo, Aras Kargo, MNG Kargo, PTT Kargo ve Sürat Kargo firmalarını tek API'den yönetir.
Kargo firması sözleşmesi yapın
Kullanmak istediğiniz kargo firmasıyla kurumsal sözleşme imzalayın ve müşteri/mağaza kodunuzu alın.
Basit Kargo API bilgilerini alın
Kargo firmanızın API yönetim sayfasından veya temsilcinizden API Key ve gönderici kodu bilgilerini temin edin.
SageCommerce kargo ayarlarına girin
Admin → Ayarlar → Kargo Ayarları bölümünden ilgili firmayı seçin. API Key, mağaza kodu ve şube bilgilerini girin.
Ücretsiz kargo eşiğini ayarlayın (opsiyonel)
Belirli bir sepet tutarının üzerindeki siparişlere ücretsiz kargo sunmak için eşik değerini girin.
Birden fazla kargo firmasını tanımlayabilirsiniz. Sipariş oluştururken Ekonomik mod en uygun fiyatlıyı, Hızlı mod en hızlısını otomatik seçer.
Meta Conversions API (CAPI)
Admin paneli → Ayarlar → Entegrasyon Ayarları → Meta — Meta CAPI, reklam olaylarını (satın alma, sepete ekleme vb.) tarayıcıdan değil sunucudan Meta'ya iletir. Bu sayede reklam ölçümü iOS/reklam engelleyici kısıtlamalarından etkilenmez ve dönüşüm eşleşme oranı yükselir.
Sunucu Taraflı İzleme
Satın alma, ödeme başlatma, sepete ekleme gibi olaylar tarayıcıya bağımlı olmadan doğrudan Meta'ya iletilir.
Yüksek Eşleşme Oranı
E-posta, telefon ve IP verisi ile hashlenerek gönderilir; Meta reklam hesabında daha doğru atıf görürsünüz.
Piksel ile Birlikte Çalışır
Meta Pixel tarayıcı tarafında çalışmaya devam eder; CAPI bu verileri tamamlar ve çift sayımı önlemek için Event ID eşleştirmesi yapar.
Kurulum Adımları
Meta Events Manager'a gidin
business.facebook.com adresinden Events Manager bölümünü açın ve web sitenize ait piksel/veri kaynağını seçin.
Conversions API erişim token'ı oluşturun
Events Manager → Ayarlar → Conversions API → Token Oluştur yolunu izleyin. Oluşturulan token'ı kopyalayın.
Piksel ID'nizi not edin
Events Manager'da piksel adının altında görünen 15-16 haneli sayı sizin Piksel ID'nizdir.
SageCommerce'e girin
Admin → Ayarlar → Entegrasyon Ayarları → Meta bölümüne gidin. Piksel ID ve CAPI Erişim Token'ı alanlarını doldurun.
Test edin
Admin panelindeki Test Olayı butonuna tıklayın; Events Manager'daki "Test Olayları" sekmesinde satın alma olayının geldiğini doğrulayın.
| Gönderilen Olay | Tetiklendiği An |
|---|---|
| PageView | Her sayfa ziyaretinde |
| ViewContent | Ürün detay sayfası açıldığında |
| AddToCart | Sepete ürün eklendiğinde |
| InitiateCheckout | Ödeme sayfası açıldığında |
| Purchase | Sipariş başarıyla tamamlandığında |
| Search | Mağaza arama kutusuna yazıldığında |
CAPI token'ı hassas bir veridir. Admin paneli dışında paylaşmayın. Token'ı yanlışlıkla ifşa ederseniz Events Manager'dan yeni bir token oluşturun ve eskisini devre dışı bırakın.
TikTok Pixel
Admin paneli → Ayarlar → Entegrasyon Ayarları → TikTok — TikTok reklamlarınızın dönüşüm verilerini takip etmek için TikTok Pixel'i SageCommerce'e bağlayın.
TikTok Ads Manager'a gidin
ads.tiktok.com adresindeki TikTok Ads Manager hesabınızı açın.
Piksel oluşturun
Araçlar → Events → Web Events bölümüne gidin. Piksel Oluştur butonuna tıklayın ve kurulum yöntemi olarak Manuel seçeneğini tercih edin.
Piksel ID'yi kopyalayın
Oluşturulan pikselin detay sayfasında "Piksel ID" olarak görünen değeri kopyalayın.
SageCommerce'e girin
Admin → Ayarlar → Entegrasyon Ayarları → TikTok bölümüne gidin. Piksel ID'yi yapıştırın ve kaydedin.
| Gönderilen Olay | Tetiklendiği An |
|---|---|
| PageView | Her sayfa ziyaretinde |
| ViewContent | Ürün detay sayfası açıldığında |
| AddToCart | Sepete ürün eklendiğinde |
| InitiateCheckout | Ödeme sayfası açıldığında |
| CompletePayment | Sipariş başarıyla tamamlandığında (TikTok'un satın alma olayı) |
TikTok Pixel Events API (sunucu taraflı) desteği SageCommerce'in gelecek sürümünde planlanmaktadır. Şu an tarayıcı tabanlı piksel aktif durumdadır.
Google Analytics 4
Admin paneli → Ayarlar → Entegrasyon Ayarları → Google — GA4 e-ticaret izleme ile ürün görüntüleme, sepete ekleme ve satın alma olaylarını Google Analytics raporlarınıza taşıyın.
GA4 mülkü oluşturun
analytics.google.com adresinde Yönetici → Mülk Oluştur adımlarını izleyin. Mülk türü olarak "Web" seçin.
Ölçüm ID'yi alın
Oluşturulan web veri akışının altında G-XXXXXXXXXX formatındaki Ölçüm ID'yi kopyalayın.
SageCommerce'e girin
Admin → Ayarlar → Entegrasyon Ayarları → Google Analytics 4 bölümüne gidin. Ölçüm ID'yi yapıştırın ve kaydedin.
E-ticaret raporlamayı kontrol edin
GA4 → Raporlar → Para Kazanma → E-ticaret Satışları altında ürün ve satış verilerinin geldiğini doğrulayın. Veriler 24-48 saat içinde işlenir.
| GA4 Olayı | Tetiklendiği An |
|---|---|
| page_view | Her sayfa ziyaretinde |
| view_item | Ürün detay sayfası açıldığında |
| view_item_list | Kategori veya arama listesi görüntülendiğinde |
| add_to_cart | Sepete ürün eklendiğinde |
| begin_checkout | Ödeme sayfası açıldığında |
| purchase | Sipariş başarıyla tamamlandığında (gelir, adet, ürün detayları gönderilir) |
Google Ads Dönüşüm İzleme
Admin paneli → Ayarlar → Entegrasyon Ayarları → Google Ads — Reklam harcamalarınızın gerçek satış getirisi (ROAS) ölçebilmek için Google Ads dönüşüm etiketini bağlayın.
Google Ads hesabını açın
ads.google.com adresinde Araçlar → Dönüşümler → Yeni Dönüşüm Eylemi yolunu izleyin.
"Web sitesi" kaynak türünü seçin
Dönüşüm türü olarak Satın alma seçin; değer olarak siparişin gerçek değerini kullanacak şekilde ayarlayın.
Dönüşüm ID ve Etiket değerlerini alın
Google Ads'in size verdiği snippet içindeki
AW-XXXXXXXXX/XXXXXXXXXXXXX formatındaki değerleri kopyalayın.SageCommerce'e girin
Admin → Ayarlar → Entegrasyon Ayarları → Google Ads bölümüne gidin. Dönüşüm ID ve Dönüşüm Etiketi alanlarını doldurun ve kaydedin.
GA4 ve Google Ads hesabınızı birbirine bağlarsanız GA4 dönüşümlerini doğrudan Google Ads'e aktarabilirsiniz. Bu durumda ayrı dönüşüm etiketi tanımlamanıza gerek kalmaz.
Instagram Shop
Admin paneli → Entegrasyonlar → Instagram Shop — Ürün kataloğunuzu Meta Commerce Manager aracılığıyla Instagram'a bağlayın ve ürünlerinizi Instagram gönderilerinden doğrudan satışa açın.
Ön koşul: Instagram Shopping, Meta tarafından kısıtlı ülkelerde aktif durumdadır. Türkiye'deki mağazalar için Instagram Shopping onayı Meta'nın politikalarına bağlıdır. Onay durumunuzu Meta Commerce Manager üzerinden kontrol edin.
Ön Gereksinimler
| Gereksinim | Açıklama |
|---|---|
| Meta Business Portfolio | business.facebook.com üzerinden oluşturulmuş ve onaylanmış bir işletme hesabı. |
| Facebook Sayfası | İşletmenize ait ve Meta Business'a bağlı aktif bir Facebook sayfası. |
| Instagram Profesyonel Hesabı | Ticari veya İçerik Üreticisi hesabı. Facebook sayfasıyla bağlantılı olmalı. |
| Commerce Manager Kataloğu | Meta Commerce Manager'da oluşturulmuş ve Instagram kanalına bağlanmış bir ürün kataloğu. |
Bağlantı Adımları
Meta Commerce Manager'da katalog oluşturun
business.facebook.com → Commerce Manager → Kataloglar → Katalog Oluştur. Katalog türü olarak E-ticaret seçin.
SageCommerce katalog feed URL'sini alın
Admin → Entegrasyonlar → Instagram Shop bölümünde sisteminize özel Ürün Feed URL'sini kopyalayın. Bu URL Meta XML/CSV formatında ürün verisi döner.
Feed'i Commerce Manager'a ekleyin
Commerce Manager → Katalog → Veri Kaynakları → Veri Akışı Ekle. Feed URL'sini yapıştırın. Yenileme sıklığını Günlük olarak ayarlayın.
Instagram kanalını kataloğa bağlayın
Commerce Manager → Katalog → Kanallar → Instagram Shopping'i Ekle. Instagram profesyonel hesabınızı seçin ve onay başvurusunu gönderin.
Meta Business token'ını SageCommerce'e girin
Meta Geliştirici Paneli → Araçlar → Graph API Explorer üzerinden veya uygulamanıza ait sistem kullanıcı token'ını Admin → Entegrasyonlar → Instagram Shop → Meta Erişim Token'ı alanına girin.
İlk senkronizasyonu çalıştırın
"Şimdi Senkronize Et" butonuna tıklayın. Ürünler Commerce Manager'daki kataloga aktarılır. Stok ve fiyat değişiklikleri günlük otomatik senkronizasyonla güncellenir.
Otomatik Katalog Güncellemesi
Fiyat veya stok değiştiğinde SageCommerce feed URL'si otomatik güncellenir; Commerce Manager günlük çekerek kataloğu taze tutar.
Gönderi Ürün Etiketleme
Katalog onaylandıktan sonra Instagram gönderilerinizdeki ürünleri etiketleyerek doğrudan alışveriş akışı oluşturabilirsiniz.
Commerce Manager İstatistikleri
Ürün görüntülenme, tıklanma ve Instagram'dan gelen satış verilerini Commerce Manager üzerinden takip edin.
Instagram Shopping onayı birkaç gün sürebilir. Onay beklenirken ürün etiketleme özelliği görünmez; onay tamamlandığında Instagram otomatik olarak bildirir.