Bildirimler
Amaç
Bu sayfa oyuncuya giden bildirimleri yönettiğiniz yerdir. Bildirimin gidebilmesi için üç şey gerekir: bir sağlayıcı (Firebase, Apple ya da OneSignal gibi anlık bildirim servisi), bir şablon (mesajın metni) ve bir kural ya da elle test gönderimi (mesajın ne zaman gideceği). Sayfa altı sekmeden oluşur: Genel bakış, Şablonlar, Kurallar, Sağlayıcılar, Gönderim geçmişi ve Cihazlar.
Ne zaman kullanılır
- Bildirim altyapısını ilk kez kurarken (Genel bakış sekmesindeki üç adımı izleyin).
- Seviye atlama gibi bir olayda otomatik bildirim göndermek için.
- Bir bildirimin neden gitmediğini araştırmak için (Gönderim geçmişi ve Cihazlar sekmeleri).
Adım adım
1. Sağlayıcı bağlama
- Sağlayıcılar sekmesinde kullandığınız servisin kartında Bağla düğmesine basın. Bu işlem yalnızca süper yöneticiye açıktır.
- Servisin istediği bilgileri girin ve anahtar dosyasını seçin. Anahtar yalnızca yazılır; kaydedildikten sonra bir daha görüntülenmez, yalnızca parmak izi görünür.
- Nedeninizi ve doğrulayıcı uygulamanızdaki 6 haneli kodu yazıp Kaydet düğmesine basın.
- Kart birkaç saniye içinde Hazır olur; sunucu ayarı yükler. Hata görürseniz kartta nedeni düz Türkçe yazılır.
2. Şablon yazma
- Şablonlar sekmesinde Yeni şablon düğmesine basın (ya da boşsa İlk şablonu oluştur; Örnekle başla hazır bir örnek getirir).
- Anahtar, görünen ad ve dili yazın; başlığı ve metni girin. Oyuncuya özel değerler için metne
{{ad}}yazın ve aynı adı Değişkenler listesine ekleyin. - Sağdaki canlı önizlemede telefon kilit ekranı ve tarayıcı bildirimi görünümüne bakın, Şablonu oluştur düğmesine basın.
- Başka dil eklemek için şablonun ayrıntısında + Dil ekle düğmesini kullanın. Her kayıt yeni bir sürüm olarak saklanır; sürüm geçmişinden eski sürüme dönebilirsiniz.
Not
Oyuncunun dilinde sürüm yoksa yedek dil olan İngilizce (en) sürümü kullanılır. İngilizce sürüm de yoksa bildirim gönderilmez.
3. Kural ekleme ya da test gönderme
- Kural: Kurallar sekmesinde Yeni kural ile olayı, koşulları, şablonu, dili ve kanalı seçin; Örnek olayla dene bölümünde kuralı hiçbir bildirim göndermeden deneyin.
- Test: Gönderim geçmişi sekmesinde Test gönder düğmesine basın; oyuncuyu, şablonu, dili ve kanalı seçip gönderin. Sayfa sonucu en fazla 60 saniye izler. Sık denemeler sınırlanır (15 dakikada 10 deneme).
Alanlar ve seçenekler
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Şablon anahtarı, görünen ad, açıklama, dil | Anahtar, ad, dil zorunlu | Anahtar değişmez; ad en fazla 120, açıklama 500 karakter |
| Başlık, Metin | Evet | Başlık için 65, metin için 240 karakterlik yumuşak sınır |
| Değişken adı, tür, örnek değer, zorunlu | Değişken eklenince | En fazla 32 değişken; sayı değişkenine tam sayı |
| Sürüm notu | Hayır | En fazla 200 karakter |
| Kural anahtarı, kural adı | Evet | Anahtar en fazla 64 karakter, değişmez; ad en fazla 120 |
| Ne zaman, koşullar | Ne zaman zorunlu | En fazla 20 koşul satırı; koşul yoksa olay her olduğunda çalışır |
| Şablon, dil, kanal | Evet | Kanal: oyun içi, anlık bildirim ya da ikisi |
| Sağlayıcı bilgileri ve anahtar dosyası | Evet | Firebase: hizmet hesabı JSON; Apple: Team ID, Key ID, Bundle ID, ortam ve .p8; OneSignal: App ID ve REST API anahtarı |
| İşlem nedeni, doğrulama kodu | Evet | Neden 8-500 karakter; kod 6 hane |
Bir ortamda en fazla 50 bildirim kuralı olabilir.
Sık karşılaşılan durumlar
| Durum | Ne yapmalı |
|---|---|
| “Bu oyunda bildirimler kapalı” | Oyun ayarları › Modüller sayfasından Bildirimler modülünü açın. |
| Kartta “Bağlı değil” yazıyor | Sağlayıcı bu ortamda bağlı değildir; Bağla ile bilgileri girin. Bağlamak süper yönetici yetkisi ister. |
| “Sağlayıcı anahtarı reddetti” | Firebase için hizmet hesabı dosyasını, Apple için .p8 anahtarını ve Team ID, Key ID, Bundle ID değerlerini, OneSignal için REST API anahtarını yenileyin. |
| “Anahtar dosyası biçimi tanınmadı” | Firebase için hizmet hesabı JSON dosyası, Apple için .p8 dosyası gerekir; Google OAuth istemci dosyası ya da .p12 sertifikası olmaz. |
| Test “oyuncunun ulaşılabilir cihazı yok” diyor | Oyuncu oyunda bildirimleri açmamıştır. Oyun içi kanalı seçin ya da Cihazlar sekmesinde oyuncunun cihazı olup olmadığına bakın. |
| Kural kaydedilemiyor: “Şablon arşivlenmiş” ya da “bu dilde şablon yok” | Şablonu arşivden çıkarın ya da seçtiğiniz dili şablona ekleyin. |
| Sunucu ayarından gelen kurallar çalışıyor | Panelde ilk kuralı eklediğinizde bu ortamda onların yerini panel kuralları alır. |
| Kural ya da şablon düzenlenemiyor | Bildirim yönetimi yetkiniz yoktur; görünüm salt okunurdur. Bir yöneticiden isteyin. |