- Başlarken — OneSignal Uygulamanıza erişin ve API anahtarlarınızı bulun
- Mesajlaşma kanallarını ayarlayın — SDK’yı yükleyin ve kanalları yapılandırın
- SDK ve API referansı — ayrıntılı yöntem, sınıf ve endpoint belgeleri
- Kullanıcılar ve kimlik — Kullanıcıları tanımlayın, Abonelikleri yönetin ve erişimi güvenli hale getirin
- Test ve hata ayıklama — yayına geçmeden önce entegrasyonunuzu doğrulayın
- Webhook’lar ve olaylar — sunucu tarafında mesaj olaylarını alı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, kullanıcı ve mesaj verilerinin bulunduğu yerdir. Her Uygulamanın kendi App ID’si, API anahtarları ve mesajlaşma kanalları vardır. Farklı projeler veya ortamlar için tek bir Organizasyon’da birden fazla Uygulama oluşturabilirsiniz.Uygulamalar, Organizasyonlar ve hesaplar
Uygulamalar, Organizasyonlar ve hesapların birbirleriyle ilişkisi.
Anahtarlar ve ID'ler
Kimlik doğrulama için App ID, REST API anahtarı ve Organization ID’nizi bulun.
Ekip üyeleri ekleyin
Geliştiricileri davet edin ve Organizasyonunuzda roller atayın.
Kullanım ve Faturalama
Faturalama, faturalar ve kullanım ayrıntıları.
Mesajlaşma kanallarını ayarlayın
Platformlarınızda kullanıcı etkileşimini oluşturmak ve takip etmek için OneSignal SDK’yı yükleyin. Her mesaj kanalının kimlik bilgilerini, SDK başlatmayı ve öğreticileri kapsayan kendi kurulum kılavuzu vardır.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 push
Web SDK kurulumu ve tarayıcı push bildirimi yapılandırması.
E-posta
E-posta kanalı yapılandırması ve gönderici alan adı doğrulaması.
Uygulama içi mesajlar
Mobil uygulamanızda zengin, etkileşimli mesajlar görüntüleyin.
SMS
SMS kanalı kurulumu ve operatör kaydı.
RCS
Marka içeriği ve okundu bilgisi ile zengin mesajlaşma.
Canlı Aktiviteler
iOS dinamik kilit ekranı güncellemeleri. Android için de benzer özellikler mevcut.
Mobil push istemleri
Mobilde push Abonelikleri toplamak için opt-in istemleri yapılandırın.
Web push istemleri
Webde push Abonelikleri toplamak için opt-in istemleri yapılandırın.
SDK ve API referansı
İstemci SDK’ları, sunucu SDK’ları ve REST API için ayrıntılı belgeler.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.
İşlemsel mesajlar
Kişiselleştirilmiş verilerle API aracılığıyla OTP, makbuz ve zamana duyarlı uyarılar gönderin.
GitHub'daki sunucu SDK'ları
Tüm sunucu SDK kütüphaneleri için kaynak kod ve örnekler.
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 ilelogin ç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ı.
Kimlik doğrulama
Kullanıcı kimlik sahtekarlığını önlemek için sunucu tarafından oluşturulan JWT’ler gerektirir.
Takma adlar
Çapraz platform takibi ve entegrasyonlar için Kullanıcılara özel tanımlayıcılar eşleyin.
Etiketler
Kişiselleştirme ve segmentasyon için Kullanıcılara anahtar-değer verileri ayarlayın.
Özel olaylar
Journey’leri tetiklemek veya analitiği desteklemek için Kullanıcı eylemlerini takip edin.
Test ve hata ayıklama
Tüm kitlenize göndermeden önce entegrasyonunuzun çalıştığını doğrulayın.Test Abonelikleri
Push, e-posta ve SMS için test Aboneliklerini bulun ve yapılandırın.
Hata ayıklama günlükleri
Sorun giderme için mobil uygulamalardan ayrıntılı SDK günlükleri yakalayın.
Mobil sorun giderme
Yaygın push teslimatı, APNS ve uygulama içi mesajlaşma sorunlarını çözün.
Web sorun giderme
Service worker, tarayıcı uyumluluğu ve web push sorunlarını düzeltin.
Webhook’lar ve olaylar
Analitik, otomasyon veya harici sistemlerle senkronizasyon için sunucu tarafında mesaj olaylarını alın.Event Streams
Tıklamalar, açılmalar, alımlar ve diğer mesaj olaylarını gerçek zamanlı olarak veri ambarınıza aktarın.
Journey Webhook'ları
Journey adımlarından sunucunuza HTTP istekleri gönderin.
Web push Webhook'ları
Web push görüntüleme, tıklama ve kapatma olayları için HTTP geri çağırmaları.
Sıkça sorulan sorular
REST API isteklerini nasıl doğrularım?
REST API anahtarınızıAuthorization başlığına Bearer token olarak ekleyin: Authorization: Key YOUR_REST_API_KEY. Anahtarınızı OneSignal dashboard’undaki Ayarlar > Anahtarlar ve ID’ler bölümünde bulabilirsiniz. Ayrıntılar için Anahtarlar ve ID’ler’e bakın.
İstemci SDK’ları ve sunucu SDK’ları arasındaki fark nedir?
İstemci SDK’ları (mobil ve web), Kullanıcının cihazındaki uygulamanızda çalışır. Abonelik kaydı, izin istemleri, uygulama içi mesajlar velogin aracılığıyla Kullanıcı tanımlamasını yönetir. Sunucu SDK’ları arka ucunuzda çalışır ve mesaj göndermek, Kullanıcıları yönetmek ve verileri dışa aktarmak için REST API’yi çağırır.
Kullanıcıları cihazlar genelinde nasıl tanımlarım?
Kullanıcı oturum açtıktan sonra her cihazdaOneSignal.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 ilelogin ç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.
Need help?Chat with our Support team or email
support@onesignal.comPlease include:- Details of the issue you’re experiencing and steps to reproduce if available
- Your OneSignal App ID
- The External ID or Subscription ID if applicable
- The URL to the message you tested in the OneSignal Dashboard if applicable
- Any relevant logs or error messages