Skip to main content
OneSignal SDK’yı yükleyin ve ilk entegrasyonunuzu çalışır hale getirin. İlk kurulum için bölümleri sırayla takip edin veya ihtiyaç duyduğunuz alana doğrudan gidin.
  1. Başlarken: App ID ve API anahtarlarınızı bulun
  2. SDK’yı yükleyin: Mobil veya Web SDK’yı yükleyin
  3. Kullanıcılar ve kimlik: Kullanıcıları tanımlayın, Abonelikleri yönetin ve erişimi güvenli hale getirin
  4. Entegrasyonunuzu test edin: yayına geçmeden önce teslimatı doğrulayın
  5. Sorun giderme: teslimat sorunlarını ayıklayın

Başlarken

Ekibinizin zaten bir OneSignal hesabı varsa, bir yöneticiden sizi Organizasyon’a davet etmesini isteyin. Aksi takdirde, başlamak için hesap oluşturun. OneSignal Uygulamanız, SDK kurulumu için ihtiyaç duyduğunuz App ID ve API anahtarları dahil olmak üzere kullanıcı ve mesaj verilerini barındırır. Birden fazla proje veya ortam yönetiyorsanız, Uygulamalar, Organizasyonlar ve hesapların birbirleriyle nasıl ilişkili olduğunu öğrenin.

Anahtarlar ve ID'ler

Kimlik doğrulama için App ID, REST API anahtarı ve Organization ID’nizi bulun.

SDK’yı yükleyin

Platformunuz için OneSignal SDK’yı yükleyin.

Mobil SDK kurulumu

iOS, Android, Huawei ve Amazon için SDK kurulumu. Push bildirimleri, uygulama içi mesajlar ve Canlı Aktiviteler’i etkinleştirir.

Web SDK kurulumu

Web SDK kurulumu ve tarayıcı push bildirimi yapılandırması.
Aşağıdaki platformlar da REST API’miz aracılığıyla desteklenir:

Kullanıcılar ve kimlik

OneSignal her kişiye bir OneSignal ID atar ve cihazlarını, e-posta adreslerini ve telefon numaralarını Abonelik olarak takip eder. Kullanıcılar, onları tanımlamak için bir External ID ile login çağrılana kadar anonimdir. Kullanıcıları tanımlamak, Aboneliklerini kanallar ve cihazlar genelinde birleştirir.

Kullanıcılar

Kullanıcı modeli, External ID, anonim ve tanımlanmış Kullanıcılar, giriş/çıkış.

Abonelikler

Mesajlarınızı alan cihazlar, e-posta adresleri ve telefon numaraları.

Etiketler

Kişiselleştirme ve segmentasyon için kullanıcılara özel özellikler ekleyin.

Özel olaylar

Journey’leri tetiklemek veya analitiği desteklemek için Kullanıcı eylemlerini takip edin.

Entegrasyonunuzu test edin

Tüm kitlenize göndermeden önce Test Kullanıcıları ile teslimatı, oluşturmayı ve derin bağlantıları doğrulayın.

Test Kullanıcıları

Push, e-posta ve SMS için test kullanıcılarını bulun ve yapılandırın.

Sorun giderme

Bir hata ayıklama günlüğü ile başlayın, ardından entegrasyonunuza uygun platform kılavuzunu kullanın.

Mobil sorun giderme

Yaygın push teslimatı, APNs ve uygulama içi mesajlaşma sorunlarını çözün.

Web SDK sorun giderme

Service worker hatalarını, origin uyuşmazlıklarını ve görünmeyen bildirimleri düzeltin.

Hata ayıklama günlükleri

Ayrıntılı günlük kaydını etkinleştirin, sorunu yeniden oluşturun ve günlükleri destek ekibiyle paylaşın.

Web push izinlerini sıfırlama

Temiz bir test için tarayıcı önbelleğini, service worker’ları ve bildirim izinlerini temizleyin.

Kurulumdan sonra

Geliştirirken yaygın kullanım senaryolarını keşfedin ve SDK yöntemlerine veya REST API endpoint’lerine bakın.

Eğitimler ve kullanım senaryoları

Terk edilen sepetler, katılım akışları, yeniden etkileşim kampanyaları ve daha fazlası için uygulama kılavuzlarına göz atın.

Etiketler

Kişiselleştirme ve segmentasyon için kullanıcılara özel özellikler ekleyin.

Özel olaylar

Journey’leri tetiklemek veya analitiği desteklemek için Kullanıcı eylemlerini takip edin.

Mobil SDK referansı

iOS, Android ve çapraz platform SDK’ları için yöntemler, sınıflar ve olay hook’ları.

Web SDK referansı

Başlatma, Kullanıcı yönetimi, Abonelik yöntemleri ve özel tetikleyiciler.

Sunucu SDK referansı

Node.js, Python, Java, Go, PHP, Ruby, C# ve Rust için sunucu SDK’larını yükleyin ve yapılandırın.

REST API genel bakış

Endpoint’ler, kimlik doğrulama, hız sınırları ve istek/yanıt biçimleri.

SSS

Kullanıcıları cihazlar genelinde nasıl tanımlarım?

Kullanıcı oturum açtıktan sonra her cihazda OneSignal.login("your_external_id") çağırın. OneSignal, aynı External ID’ye sahip tüm Abonelikleri tek bir Kullanıcı altında birleştirir. Uygulama ayrıntıları için Kullanıcılar’a bakın.

Kimlik doğrulamayı ayarlamam gerekiyor mu?

Kimlik doğrulama isteğe bağlıdır ancak prodüksiyon uygulamaları için kesinlikle önerilir. Olmadan, herhangi bir istemci rastgele bir External ID ile login çağırabilir. Kimlik doğrulamayı etkinleştirmek, OneSignal SDK’yı sunucu tarafından oluşturulan JWT kullanacak şekilde güncellemenizi gerektirir ve kimlik sahtekarlığını önler.

OneSignal’ı Mobil veya Web SDK olmadan kullanabilir miyim?

Evet. REST API veya bir Sunucu SDK ile e-posta ve SMS gönderebilir, Kullanıcıları yönetebilir ve mesajları tetikleyebilirsiniz. Push bildirimleri, uygulama içi mesajlar ve istemci tarafı Kullanıcı tanımlaması için Mobil ve Web SDK’ları gereklidir.

Sunucumdan nasıl mesaj gönderirim?

REST API veya bir Sunucu SDK kullanın. Anahtarlar ve ID’ler sayfasındaki REST API anahtarınızla kimlik doğrulaması yapın. REST API anahtarını asla bir mobil veya web istemcisine gömmeyin.