Magento Entegrasyon Kılavuzu

Tajo, Adobe Commerce’e (Magento 2) Commerce REST API üzerinden bağlanır. Magento kod tabanınıza kurmanız gereken bir Tajo eklentisi yoktur. Bağlantı bir entegrasyon token’ı kullanır, bu da mağazanızın dağıtım hattına hiç dokunulmamasını sağlar.

Magento şu anda onboarding sırasında kurulan bir bağlantıdır: Shopify ve WooCommerce’in aksine henüz self servis değildir, senkronizasyonu Tajo ekibiniz onboarding kapsamında devreye alır. Bağlayıcı uygulama durumu sayfası sürecin nerede olduğunu izler. Aşağıdaki mağaza tarafı hazırlık, Magento’nun sizden ihtiyaç duyduğu her şeydir ve standart Magento ile çalışır, kod değişikliği gerekmez.

Ön koşullar

• Adobe Commerce / Magento Open Source 2.4+
• Entegrasyon token’ı oluşturmak için yönetici erişimi
• Mağazanızda HTTPS (token kimlik doğrulaması için gereklidir)
• Aktif aboneliği olan Tajo hesabı

Adım 1: Magento entegrasyon token’ı oluşturun

1. Magento yönetim panelinde System → Extensions → Integrations → Add New Integration yolunu izleyin.
2. Adını Tajo koyun, yönetici parolanızı girin ve API altında Customers, Sales ve Catalog kaynaklarına okuma erişimi verin.
3. Kaydedin, ardından entegrasyonu Activate edin ve Access Token değerini kopyalayın.

Tajo, mağazanızın REST temel URL’sine (https://yourstore.com/rest/V1/) karşı Authorization: Bearer <access token> ile kimlik doğrular.

Adım 2: Bağlantıyı Tajo ekibinize teslim edin

Tajo onboarding sorumlunuzla şunları paylaşın:

Alan	Değer
Mağaza URL’si	https://yourstore.com
Erişim token’ı	Adım 1’deki entegrasyon token’ı

Bağlantı, herhangi bir senkronizasyon başlamadan önce salt okunur bir istekle doğrulanır. Erişimi iptal etmek için token’ı Magento’da istediğiniz zaman yenileyebilirsiniz.

Bir Magento bağlantısı neleri senkronize eder

• Müşteriler: kişi eşleştirmesi için kimlik alanları ve hesap meta verileri; pazarlama izni asla bir hesabın varlığından çıkarılmaz
• Siparişler: yaşam döngüsü segmentasyonu ve geri kazanım otomasyonları için satın alma geçmişi, tutarlar, para birimi, durum ve satır kalemleri
• Ürünler ve kategoriler: ilgi alanı segmentasyonu ve ürün odaklı kampanyalar için katalog yapısı

Önce geçmiş veri aktarımı çalışır, ardından artımlı senkronizasyon değişen kayıtları yoklayarak Tajo’yu güncel tutar. Gerçek zamanlı mağaza vitrini olayları (sepetler, devam eden ödeme akışları) mağaza içi bir eklenti gerektirir ve Magento bugün bunu almaz. Sipariş tabanlı otomasyonlar senkronizasyon üzerinden tam olarak desteklenmeye devam eder.

Pazarlama otomasyonu

Otomasyonlar (Brevo ve diğer sağlayıcılar üzerinden e-posta, SMS, WhatsApp) senkronize edilen veriler kullanılarak Tajo’da yapılandırılır. Örneğin yeni siparişlerde satın alma sonrası takipler, uzun süredir alışveriş yapmayan müşterilerde geri kazanım ve kategori geçmişinden ürün ilgisi kampanyaları.

Sorun giderme

Belirti	Nedeni ve çözümü
Mağazadan 401	Entegrasyon token’ı yeniden üretildi ya da entegrasyon devre dışı bırakıldı. Entegrasyonu yeniden etkinleştirin ve token’ı Tajo’da güncelleyin
Müşteriler senkronize oluyor ama siparişler olmuyor	Entegrasyonun API izinlerinde Sales kaynağı eksik
Yavaş ilk aktarım	Büyük mağazalar sayfalar halinde aktarılır; Tajo sorumlunuz ilerlemeyi istediğiniz anda bildirebilir

Sonraki adımlar

• Magento bağlayıcı referansı: uygulama durumu ve teknik notlar
• Müşteri senkronizasyonu: Magento müşterilerini kayıt sisteminize eşleme