Android SDK kurulumu

Integrate the OneSignal Android SDK into this codebase.

Follow the instructions at:
https://raw.githubusercontent.com/OneSignal/sdk-ai-prompts/main/docs/android/ai-prompt.md

​

Adım 0. OneSignal’da FCM yapılandırması (push göndermek için gerekli)

​

Kurulum sözleşmesi ve gereksinimler

• SDK sürümü: 5.6.1+ (en son: sürümleri kontrol edin)
• Yapay zeka kurulum talimatları: https://raw.githubusercontent.com/OneSignal/sdk-ai-prompts/main/docs/android/ai-prompt.md
• SDK deposu: https://github.com/OneSignal/OneSignal-Android-SDK
• Android Studio: Meerkat+ (2024.2.1+)
• Android API: Minimum 23+ (Android 6.0+), önerilen 31+ (Android 12+)
• Cihaz/Emülatör: Google Play Services yüklü Android 7.0+
• Gerekli bağımlılık: com.onesignal:OneSignal:[5.6.1, 5.9.99]
• Application sınıfı: Doğru SDK başlatma için gereklidir
• App ID formatı: 36 karakterlik UUID (örnek: 12345678-1234-1234-1234-123456789012) — OneSignal Dashboard > Settings > Keys & IDs bölümünde bulabilirsiniz
• Başlatma: OneSignal.initWithContext(this, "YOUR_APP_ID")
• Pil Optimizasyonu: Arka plan bildirimlerini etkileyebilir
• Önerilen: Cihazlar arasında kullanıcıları birleştirmek için OneSignal.login("user_id") ile External ID atayın

​

Android kurulum adımları

• Android uygulamanızda yüklenmiş ve başlatılmış OneSignal SDK
• Gerçek bir cihazda doğru şekilde çalışan push bildirim izni istemi
• Başarıyla teslim edilmiş bir test push ve uygulama içi mesaj

​

Adım 1. OneSignal SDK’sını ekleyin

1. Android Studio’da build.gradle.kts (Module: app) veya build.gradle (Module: app) dosyanızı açın
2. dependencies bölümünüze OneSignal’ı ekleyin:

implementation("com.onesignal:OneSignal:[5.6.1, 5.9.99]")

implementation 'com.onesignal:OneSignal:[5.6.1, 5.9.99]'

3. Gradle Senkronizasyonu: Görünen afişte Sync Now seçeneğine tıklayın veya File > Sync Project with Gradle Files yolunu izleyin

​

Adım 2. Application sınıfını oluşturun ve yapılandırın

1. File > New > Kotlin Class/File (veya Java Class)
2. Ad: ApplicationClass (veya tercih ettiğiniz ad)

// FILE: ApplicationClass.kt
// PURPOSE: Initialize OneSignal when your app launches
// REQUIREMENT: Must be registered in AndroidManifest.xml

package com.your.package.name // Replace with your actual 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 to debug issues (remove in production)
        OneSignal.Debug.logLevel = LogLevel.VERBOSE

        // Replace with your 36-character App ID from Dashboard > Settings > Keys & IDs
        OneSignal.initWithContext(this, "YOUR_APP_ID")

        // Prompt user for push notification permission
        // In production, consider using an in-app message instead for better opt-in rates
        CoroutineScope(Dispatchers.IO).launch {
            OneSignal.Notifications.requestPermission(false)
        }
    }
}

// FILE: ApplicationClass.java
// PURPOSE: Initialize OneSignal when your app launches
// REQUIREMENT: Must be registered in AndroidManifest.xml

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

import android.app.Application;

import com.onesignal.Continue;
import com.onesignal.OneSignal;
import com.onesignal.debug.LogLevel;

public class ApplicationClass extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        // Enable verbose logging to debug issues (remove in production)
        OneSignal.getDebug().setLogLevel(LogLevel.VERBOSE);

        // Replace with your 36-character App ID from Dashboard > Settings > Keys & IDs
        OneSignal.initWithContext(this, "YOUR_APP_ID");

        // Prompt user for push notification permission
        // In production, consider using an in-app message instead for better opt-in rates
        OneSignal.getNotifications().requestPermission(false, Continue.none());
    }
}

1. Uygulamanızın AndroidManifest.xml dosyasını açın
2. <application> etiketinize android:name=".ApplicationClass" ekleyin (farklı bir ad belirlediyseniz .ApplicationClass kısmını gerçek sınıf adınızla değiştirin).

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

​

Adım 3. Varsayılan bildirim simgelerini yapılandırın (önerilen)

​

Adım 4. Entegrasyonu test edin

1. Google Play Services yüklü bir cihaz veya emülatörde uygulamayı başlatın
2. Dashboard > Audience > Subscriptions bölümünü kontrol edin — durum “Never Subscribed” gösterir
3. İzin istemi göründüğünde kabul edin
4. Dashboard’u yenileyin — durum “Subscribed” olarak değişir

​

Test Aboneliği ve segment oluşturun

1. Aboneliğin yanındaki ⋮ simgesine tıklayın > Add to Test Users > bir ad verin
2. Audience > Segments > New Segment bölümüne gidin
3. Ad: Test Users, filtre olarak Test Users ekleyin > Create Segment

​

API ile test push gönderin

1. Settings > Keys & IDs bölümüne gidin.
2. Sağlanan kodda, aşağıdaki koddaki YOUR_APP_API_KEY ve YOUR_APP_ID kısımlarını gerçek anahtarlarınızla değiştirin. Bu kod, daha önce oluşturduğumuz Test Users segmentini kullanır.

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

​

Uygulama içi mesajları test edin

1. Uygulamayı 30 saniyeden fazla kapatın
2. Dashboard > Messages > In-App > New In-App > Welcome şablonunu seçin
3. Hedef kitle: Test Users segmenti
4. Tetikleyici: On app open
5. Zamanlama: Every time trigger conditions are satisfied
6. Make Message Live seçeneğine tıklayın
7. Uygulamayı açın

​

Yaygın hatalar ve çözümler

​

Kullanıcı yönetimi

​

External ID atayın (önerilen)

// Call when user logs in or is identified, safe to call multiple times
// Typically used in a login completion handler, or on app launch if already authenticated
fun onUserAuthenticated(userId: String) {
    OneSignal.login(userId)
}

// If you want to remove the External ID from the Subscription, setting it to an anonymous user
fun onUserLoggedOut() {
    OneSignal.logout()
}

​

Etiketler ve Özel Olaylar ekleyin

// Add a tag when the user's name is set
OneSignal.User.addTag("username", "john_doe")

// Create a custom event when user abandoned a cart
val properties = mapOf(
    "product_id" to "123456",
    "product_name" to "Product Name",
    "product_price" to 100,
    "product_quantity" to 1
)
OneSignal.User.trackEvent("abandoned_cart", properties)

​

E-posta ve/veya SMS abonelikleri ekleyin

// Add email subscription
// Call when user provides their email (e.g., account creation, settings update) after calling OneSignal.login("user_id")
OneSignal.User.addEmail("user@example.com")

// Add SMS subscription
// Use E.164 format: + country code + number
// Call when user provides their phone number (e.g., account creation, settings update) after calling OneSignal.login("user_id")
OneSignal.User.addSms("+15551234567")

​

Gizlilik ve kullanıcı onayı

// In ApplicationClass onCreate(), BEFORE OneSignal.initWithContext()
// Use this if your app requires GDPR or other privacy consent before data collection
OneSignal.consentRequired = true

// Later, after user grants consent (e.g., taps "I Agree" on your consent screen)
OneSignal.consentGiven = true

​

Push izinleri isteme

​

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

​

Push bildirim olayları

// Add click listener to handle when users tap notifications
val clickListener = object : INotificationClickListener {
  override fun onClick(event: INotificationClickEvent) {
    Log.d("OneSignal", "Notification clicked: ${event.notification.title}")
  }
}
OneSignal.Notifications.addClickListener(clickListener)

​

Kullanıcı durumu değişiklikleri

// Add subscription observer to track push subscription changes
class MyObserver : IPushSubscriptionObserver {
  init {
    OneSignal.User.pushSubscription.addObserver(this)
  }

  override fun onPushSubscriptionChange(state: PushSubscriptionChangedState) {
    if (state.current.optedIn) {
      println("User is now opted-in with push token: ${state.current.token}")
    }
  }
}

​

Uygulama içi mesaj olayları

// Add click listener for in-app message interactions
val clickListener = object : IInAppMessageClickListener {
  override fun onClick(event: IInAppMessageClickEvent) {
    print(event.result.actionId)
  }
}
OneSignal.InAppMessages.addClickListener(clickListener)

​

Gelişmiş kurulum ve özellikler

​

Android’e özgü özellikler

• Bildirim Kanalları — Bildirimleri kategorilere ayırın (Android 8.0+)
• Service Extensions — Gelişmiş bildirim özelleştirmesi
• Huawei/HMS Desteği — Google Play Services alternatifi

​

Evrensel özellikler

• Derin Bağlantılar — Bildirimlerden kullanıcıları belirli ekranlara yönlendirin
• Eylem Düğmeleri — Bildirimlere etkileşimli düğmeler ekleyin
• Kimlik Doğrulama — Güvenli kullanıcı tanımlama
• Konum Takibi — Konum tabanlı hedefleme
• Entegrasyonlar — Analiz ve veri platformlarıyla bağlantı kurun
• Çok Dilli Mesajlaşma — Yerelleştirilmiş bildirimler