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

Required setup for push notifications To start sending push notifications with OneSignal, you must first configure your OneSignal app with all the platforms your support—Apple (APNs), Google (FCM), Huawei (HMS), and/or Amazon (ADM).
If your organization already has a OneSignal account, ask to be invited as an admin role to configure the app. Otherwise, sign up for a free account to get started.
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: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.

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.

iOS ve Android push izin istemleri

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.

'Never Subscribed' durumuyla abonelik gösteren pano

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.

'Subscribed' durumuyla abonelik gösteren pano

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.

Test Subscriptions'a bir cihaz ekleme

2

Aboneliğinizi adlandırın.

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

'Name your subscription' alanını gösteren pano

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.

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

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:

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.

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.

Onaylanmış teslimatı gösteren teslimat istatistikleri

Profesyonel plan veya daha üst bir plandaysanız, abonelik düzeyinde onayı görmek için Audience Activity’ye kaydırın:

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

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.

Uygulama içi mesajla 'Test Users' segmentini hedefleme

3

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

Uygulama içi Welcome mesajının özelleştirme örneği

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.

Uygulama içi mesaj planlama seçenekleri

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:

Cihazlarda gösterilen Welcome uygulama içi mesajı

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.

targetUrl ile Additional Data kullanma

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.

Web ve mobile için farklı URL'ler yapılandırma