Android SDK kurulumu

​

Genel Bakış

​

Gereksinimler

• “Google Play Store (Services)” yüklü Android 7.0+ cihaz veya emülatör.
• Android Studio (kurulum talimatları Android Studio Meerkat kullanır).
• Yapılandırılmış OneSignal uygulaması ve platformu.

​

Configure your OneSignal app and platform

Step-by-step instructions for configuring your OneSignal app.

You can manage multiple platforms (iOS, Android, Huawei, Amazon, Web) under a single OneSignal app.

1

Create or select your app

• To add platforms to an existing app, go to Settings > Push & In-App in the OneSignal dashboard.
• To start fresh, click New App/Website and follow the prompts.

Example shows creating a new app.

2

Set up and activate a platform

• Choose a clear and recognizable name for your app and organization.
• Select the platform(s) you want to configure (iOS, Android, etc.).
• Click Next: Configure Your Platform.

Example setting up your first OneSignal app, org, and channel.

3

Configure platform credentials

Follow the prompts based on your platforms:

• Android: Set up Firebase Credentials
• iOS: p8 Token (Recommended) or p12 Certificate
• Amazon: Generate API Key
• Huawei: Authorize OneSignal

Click Save & Continue after entering your credentials.

4

Choose target SDK

Select the SDK that matches your development platform (e.g., iOS, Android, React Native, Unity), then click Save & Continue.

Select which SDK you are using to be navigated to the docs.

5

Install SDK and save your App ID

Once your platform is configured, your OneSignal App ID will be displayed. Copy and save this ID—you’ll need it when installing and initializing the SDK.If collaborating with others, use the Invite button to add developers or teammates, then click Done to complete setup.

Save your App ID and invite additional team members.

Once complete, follow the SDK installation guide for your selected platform to finish integrating OneSignal.

​

Android kurulumu

​

1. OneSignal SDK’yı ekleyin

implementation("com.onesignal:OneSignal:[5.4.0, 5.4.99]")

Örnek, OneSignal'ın Uygulamanızın build.gradle.kts dosyasına eklenmesini gösterir.

​

Gradle’ı Senkronize Edin

• Banner’daki Sync Now üzerine tıklayın
• Veya File > Sync Project with Gradle Files bölümüne gidin

​

2. SDK’yı Application sınıfında başlatın

Application sınıfı nasıl oluşturulur

Yeni bir sınıf oluşturun (örnek: ApplicationClass) ve aşağıdaki kodu ekleyin.

Kotlin

Java

Copy

Ask AI

package com.your.package.name // Replace with your package name
import android.app.Application

class ApplicationClass : Application() {
  override fun onCreate() {
    super.onCreate()
    // OneSignal initialization will go here
  }
}

Örnek ApplicationClass.kt dosyası.

Uygulamanızın AndroidManifest.xml dosyasını açın<application> etiketinize android:name=".ApplicationClass" ekleyin (farklı bir şeye ayarladıysanız .ApplicationClass yerine gerçek sınıf adınızı yazın).

xml

Copy

Ask AI

  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:tools="http://schemas.android.com/tools">

     <application
          android:name=".ApplicationClass"
          android:icon="@mipmap/ic_launcher"
          android:label="@string/app_name"
          ...
      </application>

  </manifest>

.ApplicationClass adı ile AndroidManifest.xml.

package com.your.package.name // Replace with your package name

import android.app.Application
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

import com.onesignal.OneSignal
import com.onesignal.debug.LogLevel

class ApplicationClass : Application() {
   override fun onCreate() {
      super.onCreate()

      // Enable verbose logging for debugging (remove in production)
      OneSignal.Debug.logLevel = LogLevel.VERBOSE
      // Initialize with your OneSignal App ID
      OneSignal.initWithContext(this, "YOUR_APP_ID")
      // Use this method to prompt for push notifications.
      // We recommend removing this method after testing and instead use In-App Messages to prompt for notification permission.
      CoroutineScope(Dispatchers.IO).launch {
         OneSignal.Notifications.requestPermission(true)
      }
   }
}

OneSignal kodu eklenmiş ApplicationClass.kt dosyası.

​

3. Varsayılan simgeleri özelleştirin

​

OneSignal SDK entegrasyonunu test etme

​

Mobil abonelikleri kontrol edin

1

Uygulamanızı bir test cihazında başlatın.

Başlatma sırasında requestPermission metodunu eklediyseniz, yerel push izin istemi otomatik olarak görünmelidir.

iOS ve Android push izin istemleri

2

OneSignal kontrol panelinizi kontrol edin

İstemi kabul etmeden önce, OneSignal kontrol panelini kontrol edin:

• Audience > Subscriptions bölümüne gidin.
• “Never Subscribed” durumu ile yeni bir giriş görmelisiniz.

'Never Subscribed' durumu ile aboneliği gösteren kontrol paneli

3

Uygulamaya dönün ve istem üzerinde Allow'a dokunun.

4

OneSignal kontrol paneli Abonelik sayfasını yenileyin.

Abonelik durumu artık Subscribed göstermelidir.

'Subscribed' durumu ile aboneliği gösteren kontrol paneli

Başarıyla bir mobil abonelik oluşturdunuz. Mobil abonelikler, kullanıcılar bir cihazda uygulamanızı ilk kez açtığında veya aynı cihazda uygulamanızı kaldırıp yeniden yüklediklerinde oluşturulur.

​

Test aboneliklerini ayarlayın

1

Test Aboneliklerine Ekleyin.

Kontrol panelinde, aboneliğin yanındaki Options (üç nokta) düğmesine tıklayın ve Add to Test Subscriptions seçeneğini seçin.

Bir cihazı Test Aboneliklerine ekleme

2

Aboneliğinizi adlandırın.

Test Subscriptions tab sekmesinde cihazınızı kolayca tanıyabilmek için aboneliği adlandırın.

'Name your subscription' alanını gösteren kontrol paneli

3

Bir test kullanıcıları segmenti oluşturun.

Audience > Segments > New Segment bölümüne gidin.

4

Segmenti adlandırın.

Segmenti Test Users olarak adlandırın (ad önemlidir çünkü daha sonra kullanılacaktır).

5

Test Users filtresini ekleyin ve Create Segment üzerine tıklayın.

Test Users filtresi ile bir 'Test Users' segmenti oluşturma

Başarıyla bir test kullanıcıları segmenti oluşturdunuz. Artık bu bireysel cihaza ve test kullanıcı gruplarına mesaj göndermeyi test edebiliriz.

​

API aracılığıyla test push gönderin

1

App API Key ve App ID'nizi alın.

OneSignal kontrol panelinizde Settings > Keys & IDs bölümüne gidin.

2

Sağlanan kodu güncelleyin.

Aşağıdaki kodda YOUR_APP_API_KEY ve YOUR_APP_ID yerine gerçek anahtarlarınızı yazın. Bu kod, daha önce oluşturduğumuz Test Users segmentini kullanır.

Copy

Ask AI

curl -X \
POST --url 'https://api.onesignal.com/notifications' \
 --header 'content-type: application/json; charset=utf-8' \
 --header 'authorization: Key YOUR_APP_API_KEY' \
 --data \
 '{
  "app_id": "YOUR_APP_ID",
  "target_channel": "push",
  "name": "Testing basic setup",
  "headings": {
  	"en": "👋"
  },
  "contents": {
    "en": "Hello world!"
  },
  "included_segments": [
    "Test Users"
  ],
  "ios_attachments": {
    "onesignal_logo": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
  },
  "big_picture": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
}'

3

Kodu çalıştırın.

Kodu terminalinizde çalıştırın.

4

Görselleri ve onaylanmış teslimatı kontrol edin.

Tüm kurulum adımları başarıyla tamamlandıysa, test abonelikleri görsel içeren bir bildirim almalıdır:

iOS ve Android'de görsel içeren push bildirimi

Görseller daraltılmış bildirim görünümünde küçük görünecektir. Tam görseli görmek için bildirimi genişletin.

5

Onaylanmış teslimatı kontrol edin.

Kontrol panelinizde Delivery > Sent Messages bölümüne gidin, ardından istatistikleri görüntülemek için mesaja tıklayın.confirmed istatistiğini görmelisiniz, bu cihazın push’u aldığı anlamına gelir.

Onaylanmış teslimatı gösteren teslimat istatistikleri

Professional plan veya daha üst bir plandaysanız, abonelik düzeyinde onay görmek için Audience Activity bölümüne gidin:

Audience Activity'de cihaz düzeyinde onaylanmış teslimat

API’miz aracılığıyla bir segmente başarıyla bildirim gönderdiniz.

• Onaylanmış teslimat yok mu? Sorun giderme kılavuzunu buradan inceleyin.
• Sorun mu yaşıyorsunuz? API isteğini ve uygulama başlatmanın başından sonuna kadar olan günlüğü bir .txt dosyasına kopyalayıp yapıştırın. Ardından her ikisini de support@onesignal.com ile paylaşın.

​

Uygulama içi mesaj gönderin

1

Uygulamanızı cihazda kapatın veya arka plana alın.

Bunun nedeni, kullanıcıların yeni bir oturum başlamadan önce uygulama içi kitle kriterlerini karşılaması gerektiğidir. OneSignal’da, kullanıcı uygulamanızı arka planda veya kapalı olduktan en az 30 saniye sonra açtığında yeni bir oturum başlar. Daha fazla ayrıntı için uygulama içi mesajların nasıl görüntülendiği kılavuzumuza bakın.

2

Bir uygulama içi mesaj oluşturun.

• OneSignal kontrol panelinizde Messages > In-App > New In-App bölümüne gidin.
• Welcome mesajını bulun ve seçin.
• Kitlenizi daha önce kullandığımız Test Users segmenti olarak ayarlayın.

Uygulama içi mesajla 'Test Users' segmentini hedefleme

3

İstenirse mesaj içeriğini özelleştirin.

Uygulama içi Welcome mesajının örnek özelleştirmesi

4

Tetikleyiciyi 'On app open' olarak ayarlayın.

5

Sıklığı planlayın.

Schedule > How often do you want to show this message? altında Every time trigger conditions are satisfied seçeneğini seçin.

Uygulama içi mesaj zamanlama seçenekleri

6

Mesajı yayına alın.

Uygulama her açıldığında Test Kullanıcılarınız için kullanılabilir olması için Make Message Live üzerine tıklayın.

7

Uygulamayı açın ve mesajı görün.

Uygulama içi mesaj yayına alındıktan sonra uygulamanızı açın. Görüntülenen mesajı görmelisiniz:

Cihazlarda gösterilen Welcome uygulama içi mesajı

Mesajı görmüyor musunuz?

• Yeni bir oturum başlatın
  • Yeniden açmadan önce uygulamayı en az 30 saniye kapatmanız veya arka plana almanız gerekir. Bu, yeni bir oturumun başlatılmasını sağlar.
  • Daha fazlası için uygulama içi mesajların nasıl görüntülendiği bölümüne bakın.
• Hala Test Users segmentinde misiniz?
  • Yeniden yüklediyseniz veya cihaz değiştirdiyseniz, cihazı Test Aboneliklerine yeniden ekleyin ve Test Users segmentinin bir parçası olduğunu onaylayın.
• Sorun mu yaşıyorsunuz?
  • Yukarıdaki adımları yeniden üretirken Debug Log Alma bölümünü takip edin. Bu, support@onesignal.com ile paylaşabileceğiniz ek günlük kaydı oluşturacaktır ve biz de neler olduğunu araştırmaya yardımcı olacağız.

​

Kullanıcı kimlik doğrulaması

​

External ID atama

​

Veri etiketleri ekleme

"current_level" adlı bir etiketin "6" değerine ayarlandığı OneSignal'da bir kullanıcı profili

4'ten büyük ve 10'dan küçük bir current_level değerine sahip kullanıcıları hedefleyen bir segmenti gösteren segment düzenleyici

Kişiselleştirilmiş bir mesajla Level 5-10 segmentini hedefleyen bir push bildirimi gösteren ekran görüntüsü

Kişiselleştirilmiş içerik ile bir iOS ve Android cihazda alınan push bildirimi

​

E-posta ve/veya SMS abonelikleri ekleme

• E-posta abonelikleri oluşturmak için addEmail metodunu kullanın.
• SMS abonelikleri oluşturmak için addSms metodunu kullanın.

External ID tarafından birleştirilmiş push, e-posta ve SMS abonelikleri olan bir kullanıcı profili

​

Gizlilik ve kullanıcı onayı

• setConsentRequired(true): Onay verilene kadar veri toplamayı engeller.
• setConsentGiven(true): Onay verildikten sonra veri toplamayı etkinleştirir.

• SDK tarafından toplanan veriler
• Kişisel verileri işleme

​

Push izinleri için istem gösterme

​

Push, kullanıcı ve uygulama içi olayları dinleme

​

Push bildirimi olayları

• addClickListener(): Bir bildirime dokunulduğunda algılar. Derin Bağlantı için faydalıdır.
• addForegroundLifecycleListener(): Bildirimlerin ön planda nasıl davrandığını kontrol eder.

​

Kullanıcı durum değişiklikleri

• Kullanıcı durumu için addObserver(): External ID’nin ne zaman ayarlandığını algılar.
• addPermissionObserver(): Kullanıcının yerel push izin istemi ile belirli etkileşimini izler.
• Push aboneliği için addObserver(): Push abonelik durumu değiştiğinde izler.

​

Uygulama içi mesaj olayları

• addClickListener(): Uygulama içi tıklama eylemlerini yönetir. Derin bağlantı veya olayları izleme için idealdir.
• addLifecycleListener(): Uygulama içi mesajların tam yaşam döngüsünü izler (gösterildi, tıklandı, kapatıldı vb.).

​

Gelişmiş kurulum ve yetenekler

• 🔁 Başka bir hizmetten OneSignal’a geçiş
• 🌍 Konum izleme
• 🔗 Derin Bağlantı
• 🔌 Entegrasyonlar
• 🧩 Mobil Servis Uzantıları
• 🛎️ Eylem düğmeleri
• 🌐 Çok dilli mesajlaşma
• 🛡️ Kimlik Doğrulama
• 📊 Özel Sonuçlar
• 📲 Canlı Aktiviteler

​

Mobil SDK kurulumu ve referansı

​

Özel Bildirim Düzeni

• Android’in özel bildirim kılavuzunu takip edin
• Değişiklikleri Bildirim Servis Uzantısı aracılığıyla uygulayın

​

Varsayılan açma davranışını devre dışı bırakma

  <application ...>
     <meta-data android:name="com.onesignal.NotificationOpened.DEFAULT" android:value="DISABLE" />
  </application>

​

Arka plan verileri ve push geçersiz kılmaları

• Arka plan verilerini işlemek veya bildirim görsellerini geçersiz kılmak için Bildirim Servis Uzantısını kullanın
• Bir bildirimden ek verileri okumak için SDK Bildirim Olay İşleyicilerini kullanın

​

Sağdan Sola (RTL) dil desteği

  <application
    android:supportsRtl="true"
    ...
  </application>