Skip to main content

Genel bakış

Mobil uyumlu bir web siteniz varsa ve bunu Apple App Store veya Google Play Store için indirilebilir bir mobil uygulamaya dönüştürmek istiyorsanız, Median.co güçlü bir çözümdür. Ayrıca push bildirimleri etkinleştirmek için OneSignal ile sorunsuz entegrasyon sunar.

Kurulum

1. Median.co ile uygulamanızı oluşturun

  1. Median.co Başlangıç Kılavuzunu takip edin.
  2. <https://median.co/app> adresinde bir uygulama oluşturun.

2. OneSignal’i kurun

  1. onesignal.com’a gidin ve bir hesap oluşturun.
  2. OneSignal Uygulamanızı ve Platformunuzu yapılandırın.

Configure your OneSignal app and platform

Configure your OneSignal app with the platforms you support — Apple (APNs), Google (FCM), Huawei (HMS), and/or Amazon (ADM).
If your organization already has a OneSignal account, ask to be invited to the Organization. Otherwise, sign up for a free account to get started.
1

Create or select your app

Create a new app by clicking New App/Website, or add a platform to an existing app in Settings > Push & In-App. Select the platform(s) you want to configure and click Next: Configure Your Platform.
OneSignal dashboard showing the new app setup flow with Organization name, app name, and channel selection
2

Configure platform credentials

Enter the credentials for your platform:Click Save & Continue after entering your credentials.
3

Save your App ID and install the SDK

Your App ID is displayed on the final screen. Copy and save it — you need it when initializing the SDK. Select your SDK platform, then follow the setup guide.
OneSignal dashboard showing the App ID and team invite option after setup

3. OneSignal’i Median uygulamanıza bağlayın

OneSignal App ID’yi Median.co (GoNative) uygulama yapılandırmanıza yapıştırın.

OneSignal SDK entegrasyonunu test etme

Bu kılavuz, push bildirimleri, abonelik kaydı ve uygulama içi mesajlaşmayı test ederek OneSignal SDK entegrasyonunuzun doğru çalıştığını doğrulamanıza yardımcı olur.

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

OneSignal panonuzu kontrol edin

İstemi kabul etmeden önce, OneSignal panosunu kontrol edin:
  • Audience > Subscriptions’a gidin.
  • “Never Subscribed” durumuyla yeni bir giriş görmelisiniz.
3

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

4

OneSignal panosu Subscription sayfasını yenileyin.

Aboneliğin durumu artık Subscribed göstermelidir.
Başarıyla bir mobil abonelik oluşturdunuz. Mobil abonelikler, kullanıcılar uygulamanızı bir cihazda ilk kez açtıklarında veya aynı cihazda uygulamanızı kaldırıp yeniden yüklediklerinde oluşturulur.

Test aboneliklerini ayarlama

Test abonelikleri, bir mesaj göndermeden önce push bildirimi test etmek için yararlıdır.
1

Test Subscriptions'a ekleyin.

Panoda, aboneliğin yanında, Options (üç nokta) düğmesine tıklayın ve Add to Test Subscriptions’ı seçin.
2

Aboneliğinizi adlandırın.

Cihazınızı daha sonra Test Subscriptions sekmesinde kolayca tanımlayabilmeniz için aboneliği adlandırın.
3

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

Audience > Segments > New Segment’e 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'e tıklayın.

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

API üzerinden test push gönderme

1

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

OneSignal panonuzda, Settings > Keys & IDs’ye gidin.
2

Sağlanan kodu güncelleyin.

Aşağıdaki koddaki YOUR_APP_API_KEY ve YOUR_APP_ID’yi gerçek anahtarlarınızla değiştirin. Bu kod, daha önce oluşturduğumuz Test Users segmentini kullanır.
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 dahil edilmiş bir görsel ile birlikte bir bildirim almalıdır:
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.

Panonuzda, Delivery > Sent Messages’a gidin, ardından istatistikleri görüntülemek için mesaja tıklayın.Onaylandı istatistiğini görmelisiniz, bu da cihazın push’u aldığı anlamına gelir.
API’miz üzerinden bir segmente başarıyla bir bildirim gönderdiniz.
  • Görsel alınamadı mı? Notification Service Extension’ınız eksik olabilir.
  • Onaylanmış teslimat yok mu? App Groups kurulumunuzu gözden geçirin.
  • Sorun mu yaşıyorsunuz? API isteğini ve uygulama başlatmanın başından sonuna kadar bir günlüğü bir .txt dosyasına kopyalayıp yapıştırın. Ardından ikisini de support@onesignal.com ile paylaşın.

Uygulama içi mesaj gönderme

Uygulama içi mesajlar, kullanıcılar uygulamanızı kullanırken onlarla iletişim kurmanıza olanak tanır.
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 hedef kitle kriterlerini karşılaması gerektiğidir. OneSignal’de, kullanıcı uygulamanızı en az 30 saniye arka planda veya kapalı kaldıktan 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 panonuzda Messages > In-App > New In-App’e gidin.
  • Welcome mesajını bulun ve seçin.
  • Hedef Kitlenizi daha önce kullandığımız Test Users segmenti olarak ayarlayın.
3

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

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çin.
6

Mesajı yayına alın.

Test Kullanıcılarınızın uygulamayı her açtıklarında kullanılabilir olması için Make Message Live’a tıklayın.
7

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

Uygulama içi mesaj yayındayken uygulamanızı açın. Görüntülendiğini görmelisiniz:
Mesajı görmüyor musunuz?
  • Yeni bir oturum başlatın
  • Hala Test Users segmentinde misiniz?
    • Uygulamayı yeniden yüklediyseniz veya cihaz değiştirdiyseniz, cihazı Test Subscriptions’a yeniden ekleyin ve Test Users segmentinin bir parçası olduğunu onaylayın.
  • Sorun mu yaşıyorsunuz?
    • Yukarıdaki adımları yeniden üretirken Hata Ayıklama Günlüğü Alma kılavuzunu izleyin. Bu, support@onesignal.com ile paylaşabileceğiniz ek günlük kaydı oluşturacaktır ve neler olduğunu araştırmaya yardımcı olacağız.
OneSignal SDK’yı başarıyla kurdunuz ve şunlar gibi önemli kavramları öğrendiniz:

Push izinleri için istem

Uygulama açılışında hemen requestPermission() çağırmak yerine, daha stratejik bir yaklaşım benimseyin. İzin istemeden önce push bildirimlerinin değerini açıklamak için bir uygulama içi mesaj kullanın. En iyi uygulamalar ve uygulama ayrıntıları için Prompt for push permissions kılavuzumuza bakın.

SSS

İstemci tarafında OneSignal verilerine nasıl erişebilirim?

OneSignal Subscription ID’yi (oneSignalUserId) ve abonelik durumunu almak için Median Native JavaScript Bridge metodu median_onesignal_info’yu kullanın.
javascript
  var osSubscriptionId = "the OneSignal Subscription ID string";
  var isSubscribedToPushNotifications;

  median.onesignal.onesignalInfo().then(function (oneSignalInfo) {
    console.log(oneSignalInfo);
    osSubscriptionId = oneSignalInfo.oneSignalUserId;
    isSubscribedToPushNotifications = oneSignalInfo.oneSignalSubscribed;
  });
Daha fazla ayrıntı için Median.co Docs

Median uygulamamıza derin bağlantı push bildirimleri nasıl gönderilir?

Median uygulamaları, açılır tarayıcı açmak yerine yerel bir deneyim için derin bağlantı kullanır.

OneSignal panosunu kullanırken:

  • Launch URL alanını kullanmayın.
  • Bunun yerine Additional Data alanını kullanın.
    • Bir anahtar ekleyin: targetUrl (büyük “U”)
    • Bir değer ekleyin: kullanıcıların açmasını istediğiniz URL.

REST API kullanırken:

Push yükünüzün data nesnesine targetUrl’yi dahil edin. Örnek:
{
  "app_id": "YOUR-APP-ID",
  "include_player_ids": ["USER-ID"],
  "data": { "targetUrl": "https://example.com/page" },
  "contents": { "en": "Check out this page!" }
}

Hem web’e hem de mobile’a gönderiliyor mu?

Web ve mobile’a aynı anda gönderiyorsanız: Launch URL bölümünde “Different URL for web/app“‘i seçin. Geçersiz kılmayı önlemek için APP URL alanını boş bırakın.