Ana içeriğe atla
Bu kılavuz, geliştiricilerin OneSignal’ı mobil ve web uygulamalarına entegre etmesine yardımcı olur. İlk kurulum için bölümleri sırayla takip edin veya ihtiyaç duyduğunuz alana doğrudan gidin.
  1. Başlarken — OneSignal Uygulamanıza erişin ve API anahtarlarınızı bulun
  2. Mesajlaşma kanallarını ayarlayın — SDK’yı yükleyin ve kanalları yapılandırın
  3. SDK ve API referansı — ayrıntılı yöntem, sınıf ve endpoint belgeleri
  4. Kullanıcılar ve kimlik — Kullanıcıları tanımlayın, Abonelikleri yönetin ve erişimi güvenli hale getirin
  5. Eğitimler — yaygın kullanım senaryoları için adım adım kılavuzlar
  6. Test ve hata ayıklama — yayına geçmeden önce entegrasyonunuzu doğrulayın
  7. Analitik ve webhook’lar — performansı izleyin ve 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.

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 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ı.

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.

Eğitimler

OneSignal ile yaygın mesajlaşma kullanım senaryolarını uygulamak için adım adım kılavuzlar.

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.

Test ve hata ayıklama

Tüm kitlenize göndermeden önce entegrasyonunuzun çalıştığını doğrulayın.
Her zaman önce test Abonelikleri ile test edin. Bu, gerçek Kullanıcıları etkilemeden teslimat, oluşturma ve derin bağlantıları doğrulamanızı sağlar.

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.

Analitik ve webhook’lar

Mesaj performansını izleyin ve 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 ve login 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 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.
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
We’re happy to help!