Loyetta API'ye Giriş

Loyetta API dokümantasyonuna hoş geldiniz. Loyetta, B2B2C sadakat ekosistemlerini güçlendirmek için tasarlanmış kapsamlı bir SaaS Sadakat Motorudur.

Headless ve API-first bir çözüm olan Loyetta, sadakat mantığını kullanıcı arayüzünden ayırır. Bu yapı, güçlü etkileşim, oyunlaştırma ve ödül özelliklerini, belirli bir ön yüz teknolojisine bağlı kalmadan doğrudan arka uç (backend) altyapınıza, mobil uygulamalarınıza veya web platformlarınıza entegre etmenize olanak tanır.

Entegrasyon Mimarisi

Sunucu Taraflı (Backend-to-Backend) Entegrasyon

Loyetta API, güvenli ve sunucu taraflı entegrasyonlar için tasarlanmıştır. İstemci (client) tarafında bireysel kullanıcı oturumlarını doğrudan API üzerinden yönetmek yerine, sisteminiz Loyetta ile bir Süper Kullanıcı Kimlik Doğrulama (Super-User Authentication) yöntemi kullanarak iletişim kurar.

Süper Kullanıcı Token'ı: Tüm istekler, onboarding sürecinde size sağlanan güvenli bir özel token ve endpoint aracılığıyla doğrulanır.
Oturum Yönetimi: Son kullanıcının kimliğini, oturum durumunu ve güvenliğini sizin sisteminiz yönetir. Sadakat etkinliklerini tetiklemek (puan kazandırmak, oyun oynatmak vb.) veya veri çekmek için gerekli kullanıcı bağlamını (context) Loyetta'ya iletmeniz yeterlidir.
Basitleştirilmiş Akış: Bu yöntem, mobil uygulamanızda veya web sitenizde karmaşık kayıt (register) veya OTP doğrulama akışlarını Loyetta tarafında tekrar uygulama ihtiyacını ortadan kaldırır; backend sisteminiz bir köprü görevi görerek kullanıcı deneyimi üzerinde tam kontrol sağlar.

Temel Yetenekler

Loyetta, kullanıcı sadakatini artırmak ve yaşam boyu değerini (LTV) maksimize etmek için modüler bir araç seti sunar. İhtiyacınız olan modülleri seçip kullanabilirsiniz.

1. Oyunlaştırma (Gamification) Paketi

Loyetta, istemci tarafı hilelerini önleyen ve zengin interaktif deneyimler sunan güçlü, sunucu tabanlı bir oyun motoru içerir.

Match-3 Motoru: Seviye ilerlemesi, can yönetimi, hamle kontrolü ve puanlama özelliklerine sahip tam kapsamlı bir bulmaca oyunu modülü.
Çarkıfelek (Wheel of Fortune): Yapılandırılabilir çevirme hakları, zamanlayıcılar ve ödül dağıtım mantığına sahip olasılık tabanlı bir ödül oyunu.
İnteraktif Testler & Anketler: Kullanıcıları bilgi yarışmaları (Quiz) veya geri bildirim anketleri (Polls) ile etkileşime sokarak katılımlarını puanla ödüllendirin.

2. Ödül Ticareti (Mağaza)

API'ye gömülü eksiksiz bir e-ticaret modülü ile sadakat puanlarını somut değere dönüştürün.

Fiziksel Ürünler: Stok takibi gerektirmeyen tedarikçi ağı (Vendora) entegrasyonu, sepet yönetimi ve fiziksel ürün sipariş süreçleri.
Dijital Ödüller: Ön ödemeli kartlar ve dijital hediye çekleri (voucher) için anında kullanım ve kod teslimatı.
Sepet Yönetimi: Ürün ekleme/çıkarma, miktar güncelleme ve ödeme öncesi toplam puan hesaplama için yerleşik endpoint'ler.

3. Etkileşim & İçerik

Dinamik içerik sunumu ile kullanıcıları ekosisteminizde aktif tutun.

Video & İzle-Kazan: Kullanıcıların izleme süresine veya tamamlamasına göre puan kazandığı video içerik modülü.
Bloglar & Haberler: Kullanıcı segmentlerine özel makaleler ve duyurular yayınlayın.
Popup & Slider'lar: Uygulama içi pazarlama kampanyalarını, bannerları ve duyuruları API üzerinden dinamik olarak yönetin.

4. Sadakat Mantığı & Puan Kazanımı

"Puan Ekonomisi", kullanıcıların değer elde etmesi için çeşitli yollar sunan Loyetta'nın omurgasıdır.

Kampanyalar: İlerleme takibi ile karmaşık kazanım kuralları (örneğin, "X ürününden 3 tane al, 500 puan kazan") oluşturun.
Kod Kullanımı: Ürün üzerindeki kodları doğrulayarak anında puan tanımlayın.
Affiliate Sistemi: Kullanıcıların başkalarını davet etmesine ve ağ büyümesinden ödül kazanmasına olanak tanıyan yerleşik referans motoru.

5. Sosyal & Kullanıcı Modülleri

Topluluk etkileşimini ve geri bildirimi teşvik edin.

Tarif Paylaşımı: Kullanıcıların kendi içeriklerini (UGC) oluşturması, tarif paylaşması ve diğer kullanıcıların bu tarifleri beğenmesi için özelleşmiş modül.
Geri Bildirim & Destek: Şikayetler, talepler ve genel geri bildirimler için entegre iletişim formları.