Sosyal etkinlik

Kullanıcıları kendilerini ilgilendiren bir şey olduğunda bilgilendirin: bir beğeni, bir yanıt, bir takip, gelen bir mesaj veya bir oyundaki rekabetçi bir etkinlik. Bu bildirimler, kullanıcılar uygulamanızda o anda aktif olmasa bile yeniden etkileşimi artırır.

OneSignal, gerçek zamanlı iletişim için tasarlanmamıştır. Push bildirimleri en iyi şekilde, kullanıcılar uygulamada aktif olarak bulunmadığında bir yedek olarak kullanılır. Gerçek zamanlı uygulama içi mesajlaşma için uygulamanızın mevcut mesajlaşma katmanını kullanın ve OneSignal bildirimlerini yalnızca alıcı çevrimdışı veya inaktif olduğunda tetikleyin.

Biri kullanıcıları beğendiğinde, yorum yaptığında, onlardan bahsettiğinde, etiketlediğinde veya takip ettiğinde kullanıcıları bilgilendirin.

Doğrudan mesajlar

Debouncing ve sohbet derin bağlantılarıyla kullanıcıları yeni gelen mesajlar hakkında uyarın.

Oyun uyarıları

Üs saldırıları, meydan okumalar ve lonca etkinliği gibi zamana duyarlı rekabetçi etkinlikler gönderin.

Ön koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

Uygulamanızda kurulu OneSignal SDK. Bkz. Mobil SDK kurulumu veya Web SDK kurulumu.
Kullanıcıları kendi tanımlayıcınızla hedefleyebilmeniz için her kullanıcı için ayarlanmış bir external_id. Bkz. Kullanıcılar ve Takma Adlar.
Sosyal eylemleri algılayabilen ve OneSignal API’sini çağırabilen bir backend. Bkz. REST API genel bakış.
Kişiselleştirme için custom_data kullanmayı planlıyorsanız dashboard’da oluşturulmuş Şablonlar. custom_data kullanmak için bir template_id gereklidir.

custom_data yüklerini 2KB’nin altında tutun. custom_data alanının katı bir boyut sınırı vardır. Büyük yükler göndermek — tam sohbet listeleri, liderlik tablosu dizileri, base64 resimler veya HTML — kesilme veya reddedilme riski taşır. Zengin içerik için bir tanımlayıcı (örneğin, digest_id veya summary_url) iletin ve alıcının cihazının dokunma üzerine tam yükü backend’inizden almasını sağlayın. Boyut sınırı ayrıntıları ve dizi yineleme kalıpları için API custom_data ile mesajları kişiselleştirme’ye bakın.

Sosyal etkinlik bildirimleri

Bir kullanıcı bir sosyal eyleme dahil olduğunda bir push bildirimi gönderin. Gönderenin adını, avatarını ve ilgili bağlamı gönderim anında mesaja eklemek için custom_data kullanın. OneSignal’de hiçbir veri saklanmaz.

Yaygın sosyal eylemler

Eylem	Örnek bildirim
Beğeni	”Anna fotoğrafını beğendi.”
Yorum	”Leo yanıtladı: ‘Harika görünüyor!’”
Bahsetme	”Sara bir yorumda senden bahsetti.”
Etiket	”James seni bir gönderide etiketledi.”
Takip	”Maya seni takip etmeye başladı.”
Davet	”Ben seni etkinliğe davet etti.”
Paylaşım	”Alex ‘Hawaii Albümü’nü seninle paylaştı.”

Kurulum

Eylemi backend'inizde tespit edin

Bir sosyal eylem gerçekleştiğinde, backend’iniz göndereni ve alıcıyı, ayrıca gönderi kimliği veya içerik gibi ilgili bağlamı tanımlar:

JSON

{
  "action": "like",
  "sender_id": "user_b",
  "sender_name": "Anna",
  "sender_avatar": "https://cdn.yourapp.com/avatars/anna.jpg",
  "recipient_id": "user_a",
  "post_id": "xyz789",
  "post_title": "My Hawaii trip"
}

Bir push şablonu oluşturun

Dashboard’da Messages > Templates > New Push Template bölümüne gidin. custom_data alanlarına başvurmak için Liquid sözdizimini kullanın:Başlık:

Liquid

{{ message.custom_data.sender_name | default: "Someone" }}

Mesaj:

Liquid

{{ message.custom_data.sender_name | default: "Someone" }} liked your post "{{ message.custom_data.post_title | default: "your post" }}".

Resim (isteğe bağlı, gönderenin avatarını görüntüler):

Liquid

{{ message.custom_data.sender_avatar }}

Şablonu kaydedin ve template_id değerini not edin.

Create Message API'sini çağırın

Backend’inizden bildirimi alıcıya gönderin:

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_a"]
  },
  "custom_data": {
    "sender_name": "Anna",
    "sender_avatar": "https://cdn.yourapp.com/avatars/anna.jpg",
    "post_title": "My Hawaii trip",
    "post_id": "xyz789"
  },
  "url": "yourapp://posts/xyz789"
}

OneSignal, şablonu gönderim anında custom_data değerlerini kullanarak oluşturur. Gönderenin adı ve avatarı, OneSignal’de saklanmadan bildirimde görünür.

İsteğe bağlı: e-posta ve SMS yedekleri ekleyin

Push’u devre dışı bırakmış veya bildirimi teslim edilmemiş kullanıcılara ulaşmak için aşağıdaki E-posta ve SMS yedekleri bölümüne bakın.

Bir alan eksik olsa bile mesajın doğal okunması için her Liquid yer tutucusunda | default: filtrelerini kullanın. Örneğin: {{ message.custom_data.sender_name | default: "Someone" }}. Daha fazla filtre için Liquid sözdizimini kullanma’ya bakın.

Avatar ve resim URL gereksinimleri. sender_avatar URL’si (ve diğer tüm bildirim resimleri) şu şartları karşılamalıdır:

HTTPS — iOS, HTTP URL’lerini reddeder.
Herkese açık erişilebilir — APNs ve FCM kimlik doğrulamalı istekler gönderemez.
~1 MB altında — iOS sınırı 10 MB’dır ancak pratik teslimat pencereleri daha küçük varlıkları tercih eder.
Doğru Content-Type başlığıyla sunulmuş — image/jpeg, image/png vb.

Önbellek başlıklarına sahip bir CDN’den barındırma en güvenli kurulumdur.

Yüksek hacimli eylemleri kısıtlayın

Viral bir gönderi saniyede binlerce like olayı üretebilir. Her biri için bir push göndermeyin — bu, alıcıyı boğar ve uygulamanızın sessize alınmasına veya kaldırılmasına yol açar. Kalıp şudur:

Backend’inizde sayıları biriktirin (örneğin, alıcı + gönderiye göre anahtarlanmış bir Redis sayacı).
Sessiz bir pencereden sonra (10 dakika makul bir varsayılandır), tek bir özet push gönderin: “12 kişi gönderini beğendi.”
Özetten sonra daha fazla beğeni gelirse yeni bir pencere başlatın — hemen tekrar push göndermeyin.

Aynı mantık yorumlar, takipler ve tepkiler için de geçerlidir. Backend’iniz debounce yapamıyorsa OneSignal tarafındaki hız sınırları için Kısıtlama’ya bakın.

Doğrudan (kullanıcıdan kullanıcıya) mesajlar

Bir kullanıcıya yeni bir doğrudan mesaj aldığında bildirim gönderin ve onu doğrudan sohbete derin bağlantıyla yönlendirin.

Yalnızca alıcı sohbette aktif olarak bulunmadığında bir push gönderin. Zaten sohbeti okuyan birini bilgilendirmek kötü bir deneyim yaratır. Bir bildirimi tetiklemeden önce alıcının o anda aktif olup olmadığını kontrol etmek için uygulamanızın kendi mantığını kullanın. OneSignal, bir kullanıcının uygulamanızı o anda kullanıp kullanmadığını izlemez.

Kurulum

Mesajın ne zaman gönderildiğini tespit edin ve aktiviteyi kontrol edin

Kullanıcı A, Kullanıcı B’ye bir mesaj gönderdiğinde, Kullanıcı B’nin o sohbette şu anda aktif olup olmadığını kontrol edin. Kullanıcı B çevrimdışıysa veya sohbette değilse, bir push göndermeye geçin.

Mesaj başına bir push göndermekten kaçının

Kullanıcı A art arda birkaç mesaj gönderirse, bir bildirimi tetiklemeden önce son mesajdan sonra kısa bir süre bekleyin. Bunu backend’inizde şu şekilde yapabilirsiniz:

İlk mesaj geldiğinde bir zamanlayıcı başlatın (örneğin, 60 saniye).
Zamanlayıcı dolmadan önce başka bir mesaj gelirse, zamanlayıcıyı sıfırlayın.
Zamanlayıcı yeni mesaj olmadan dolduğunda, okunmamış sayısını özetleyen tek bir push gönderin.

OneSignal, birden fazla API çağrısını otomatik olarak birleştirmez; bu nedenle API’yi beş kez çağırırsanız beş bildirim gönderilir.

Push bildirimini gönderin

Kullanıcı B’ye sohbete derin bağlantı içeren bir push gönderin:

JSON

{
  "app_id": "YOUR_APP_ID",
  "headings": { "en": "New message" },
  "contents": { "en": "Anna: 'Hey, you around?'" },
  "include_aliases": {
    "external_id": ["user_b_id"]
  },
  "url": "yourapp://chat/chat_1234",
  "data": {
    "click_action": "open_chat",
    "conversation_id": "chat_1234",
    "sender_id": "user_a_id"
  }
}

Uygulamanız bildirim açıldığında data.conversation_id değerini okur ve doğru ekrana yönlendirir. Platforma özel kurulum için Derin bağlantı’ya bakın.

İsteğe bağlı: e-posta ve SMS yedekleri ekleyin

Push’u devre dışı bırakmış veya bildirimi teslim edilmemiş kullanıcılara ulaşmak için aşağıdaki E-posta ve SMS yedekleri bölümüne bakın.

Bildirimleri sohbete göre yerel olarak gruplandırın. Backend debouncing, kaç bildirimin tetiklendiğini azaltır, ancak iOS ve Android birden fazla bildirimi görsel olarak da tek bir dizide birleştirebilir. İşletim sisteminin aynı sohbetten gelen mesajları gruplandırması için bir dizi (thread) veya birleştirme (collapse) tanımlayıcısı (örneğin, conversation_id) ayarlayın. Bkz. Bildirim gruplama.

Her yeni mesajda rozet sayısını güncelleyin. Çoğu sohbet uygulaması, iOS/Android rozetinin tüm sohbetlerdeki toplam okunmamış mesajları yansıtmasını ister. Kullanıcı bir bildirimi temizlese bile bekleyen başkaları olduğunda rozetin doğru kalması için her push’ta okunmamış sayısını API aracılığıyla iletin. Bkz. Rozetler.

Kilit Ekranı gizliliği. iOS, bildirim içeriğini — mesaj önizlemesi dahil (“Anna: ‘Hey, you around?’”) — varsayılan olarak Kilit Ekranında gösterir. Hassas içeriğe sahip mesajlaşma uygulamaları için (sağlık, finans, flört, profesyonel), genel bir önizleme göndermeyi (“Anna’dan yeni mesaj”) ve kullanıcıların uygulama içi ayarlarınız üzerinden tam önizlemelere kendilerinin katılmasına izin vermeyi düşünün.

Oyun: rekabetçi ve sosyal uyarılar

Rekabetçi oyunlar, aciliyet yaratan zamana duyarlı uyarılardan yararlanır. Bu bildirimlerin özel ve kişisel hissettirmesi için custom_data kullanın. Saldırganı adıyla belirten veya tam kaynak sayılarını gösteren bir bildirim, genel bir uyarıdan çok daha etkileyicidir.

Yaygın rekabetçi etkinlikler

Etkinlik	Örnek bildirim
Üs saldırısı	”Köyün saldırı altında! Orca üssünü yağmalıyor.”
Meydan okuma	”DragonSlayer99 seni dereceli bir düelloya davet etti. Yanıt vermek için 24 saatin var.”
Liderlik tablosu	”İlk 10’dan çıktın. Orca az önce seni #8’de geçti.”
Lonca etkinliği	”Lonca savaşı 30 dakika içinde başlıyor. BladeClan sana güveniyor!”
Klan daveti	”DragonSlayer99 seni BladeClan’e katılmaya davet etti.”
Kaynak hazır	”Birliklerin eğitildi ve konuşlanmaya hazır.”

Kurulum

Oyun etkinliğini backend'inizde tespit edin

Rekabetçi bir etkinlik gerçekleştiğinde, oyun backend’iniz etkilenen oyuncuyu tanımlar ve ilgili bağlamı yakalar:

JSON

{
  "event": "base_attack",
  "attacker_id": "user_orca",
  "attacker_name": "Orca",
  "recipient_id": "user_dragon",
  "resources_at_risk": {
    "gold": 12400,
    "elixir": 8200
  }
}

Bir push şablonu oluşturun

Dashboard’da Liquid referanslarıyla bir Push Şablonu oluşturun:Başlık:

Liquid

⚔️ Your village is under attack!

Mesaj:

Liquid

{{ message.custom_data.attacker_name | default: "An enemy" }} is raiding your base. You're at risk of losing {{ message.custom_data.gold | default: "0" }} gold and {{ message.custom_data.elixir | default: "0" }} elixir.

Şablonu kaydedin ve template_id değerini not edin.

Bildirimi gönderin

Oyun backend’inizden Create Message API’sini çağırın:

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_dragon"]
  },
  "custom_data": {
    "attacker_name": "Orca",
    "gold": "12400",
    "elixir": "8200"
  },
  "url": "yourgame://base/defend",
  "data": {
    "event": "base_attack",
    "attacker_id": "user_orca"
  }
}

url, oyuncuyu doğrudan savunma ekranına derin bağlantıyla yönlendirir. data nesnesi, doğru savaş durumunu yükleyebilmesi için bağlamı uygulamanızın bildirim işleyicisine iletir.

İsteğe bağlı: e-posta ve SMS yedekleri ekleyin

Push’u devre dışı bırakmış veya bildirimi teslim edilmemiş oyunculara ulaşmak için aşağıdaki E-posta ve SMS yedekleri bölümüne bakın.

Acil olmayan uyarılar için sessiz saatlere saygı gösterin. Yerel saatle sabah 3’te gönderilen üs saldırısı push’ları bilinen bir abonelikten çıkma nedenidir. Oyun uyarılarınızı iki katmana ayırın:

Zaman açısından kritik (30 dakika içinde başlayan lonca savaşı, tam şu anda saldırı altındaki üs) — yerel saatten bağımsız olarak hemen gönderin.
Zaman açısından kritik olmayan (birlikler hazır, günlük ödül mevcut, haftalık özet) — oyuncunun yerel saat diliminde uyanık saatlere denk gelmesi için Intelligent Delivery veya Saat dilimi başına özel zamanı kullanın.

Oyun uyarısı aboneliğinden çıkışların çoğu, ikinci kategorinin yanlış zamanda gönderilmesinden gelir; birinci kategorinin çok sık olmasından değil.

Devam eden etkinlikler için Live Activities’i düşünün. iOS 16.1+ üzerinde devam eden maçlar, baskınlar veya canlı etkinlikler için Kilit Ekranında ve Dynamic Island’da bir Live Activity, aynı bağlamı güncelleyen tekrarlanan push bildirimlerinden genellikle daha iyi bir deneyimdir. Canlı durum için Live Activities kullanın (“23 dakika kaldı, #4’tesin”) ve push’u kilometre taşı veya tamamlanma anları için ayırın.

Daha fazla oyun uyarısı örneği

Liderlik tablosunda geçilme
Lonca etkinliği
Meydan okuma daveti

Şablon mesajı:

Liquid

{{ message.custom_data.overtaker_name | default: "Another player" }} just passed you. You dropped from #{{ message.custom_data.previous_rank }} to #{{ message.custom_data.current_rank }} on the leaderboard.

API isteği:

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_dragon"]
  },
  "custom_data": {
    "overtaker_name": "Orca",
    "previous_rank": "8",
    "current_rank": "9"
  },
  "url": "yourgame://leaderboard"
}

Birden fazla external_id değeri ileterek tüm lonca üyelerine aynı anda gönderin. Her biri aynı mesajı alır.Şablon mesajı:

Liquid

Guild war alert! {{ message.custom_data.guild_name | default: "Your guild" }} clashes in {{ message.custom_data.minutes_until | default: "30" }} minutes. Get in position.

API isteği:

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_dragon", "user_orca", "user_shadow"]
  },
  "custom_data": {
    "guild_name": "BladeClan",
    "minutes_until": "30"
  },
  "url": "yourgame://guild/war"
}

Şablon mesajı:

Liquid

{{ message.custom_data.challenger_name | default: "A player" }} challenged you to a {{ message.custom_data.game_mode | default: "duel" }}. You have {{ message.custom_data.hours_to_respond | default: "24" }} hours to accept.

API isteği:

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_dragon"]
  },
  "custom_data": {
    "challenger_name": "DragonSlayer99",
    "game_mode": "ranked duel",
    "hours_to_respond": "24"
  },
  "url": "yourgame://challenges/incoming",
  "data": {
    "challenge_id": "chal_9876",
    "challenger_id": "user_dragonslayer99"
  }
}

E-posta ve SMS yedekleri

Push’u devre dışı bırakmış veya bildirimi teslim edilmemiş kullanıcılara ulaşmak için herhangi bir bildirim türüne bir e-posta veya SMS yedeği ekleyin. Bir onaylanmış teslimat veya tıklama olup olmadığını kontrol etmek için View Message API’sini kullanın. Gecikme penceresi içinde hiçbiri kaydedilmezse, bir E-posta veya SMS şablonuyla aynı custom_data yaklaşımını kullanarak bir takip mesajı gönderin.

Sosyal etkinlikBahsetmeler ve doğrudan yanıtlar gibi yüksek değerli eylemler için en iyisidir.

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_EMAIL_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_a"]
  },
  "custom_data": {
    "sender_name": "Anna",
    "sender_avatar": "https://cdn.yourapp.com/avatars/anna.jpg",
    "action": "liked your post",
    "post_title": "My Hawaii trip",
    "post_url": "https://yourapp.com/posts/xyz789"
  }
}

E-posta şablonu örneği (konu):

Liquid

{{ message.custom_data.sender_name | default: "Someone" }} {{ message.custom_data.action | default: "interacted with your post" }}

Doğrudan mesajlarMesaj başına uyarılar yerine okunmamış sohbetlerin günlük özeti olarak en iyisidir.

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_EMAIL_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_b_id"]
  },
  "custom_data": {
    "unread_count": "3",
    "conversations": [
      { "sender_name": "Anna", "preview": "Hey, you around?", "url": "https://yourapp.com/chat/chat_1234" },
      { "sender_name": "Leo", "preview": "Did you see this?", "url": "https://yourapp.com/chat/chat_5678" }
    ]
  }
}

E-posta şablonu örneği (konu):

Liquid

You have {{ message.custom_data.unread_count | default: "new" }} unread message{% if message.custom_data.unread_count != "1" %}s{% endif %}

E-posta şablonu örneği (gövde, conversations dizisi üzerinde yineleme):

Liquid

<h2>You have {{ message.custom_data.unread_count }} unread messages</h2>
<ul>
  {% for conversation in message.custom_data.conversations %}
    <li>
      <strong>{{ conversation.sender_name }}:</strong>
      "{{ conversation.preview }}"
      <a href="{{ conversation.url }}">Open</a>
    </li>
  {% endfor %}
</ul>

İç içe nesneler ve koşullu görüntüleme dahil tam dizi yineleme referansı için API custom_data ile mesajları kişiselleştirme’ye bakın.OyunHaftalık liderlik tablosu özetleri, lonca savaşı sonuçları veya kilometre taşı açılışları gibi acil olmayan özetler için en iyisidir.

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_EMAIL_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_dragon"]
  },
  "custom_data": {
    "player_name": "DragonSlayer99",
    "rank": "7",
    "rank_change": "+3",
    "top_players": [
      { "name": "Orca", "score": "48200" },
      { "name": "Shadow", "score": "45100" },
      { "name": "DragonSlayer99", "score": "43800" }
    ],
    "summary_url": "https://yourgame.com/rankings/weekly"
  }
}

E-posta şablonu örneği (konu):

Liquid

Your weekly rankings: #{{ message.custom_data.rank }} ({{ message.custom_data.rank_change }} this week)

Sosyal etkinlikRutin beğeniler veya takipler için değil, bahsetmeler ve doğrudan yanıtlar gibi yüksek önemli eylemler için en iyisidir.

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_SMS_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_a"]
  },
  "custom_data": {
    "sender_name": "Anna",
    "post_title": "My Hawaii trip",
    "post_url": "https://yourapp.com/posts/xyz789"
  }
}

SMS şablonu örneği:

Liquid

{{ message.custom_data.sender_name | default: "Someone" }} mentioned you in "{{ message.custom_data.post_title | default: "a post" }}". Tap to reply: {{ message.custom_data.post_url }}

Doğrudan mesajlarToplu mesaj dizileri yerine kaçırılan tekil mesajlar için en iyisidir.

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_SMS_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_b_id"]
  },
  "custom_data": {
    "sender_name": "Anna",
    "message_preview": "Hey, you around?",
    "conversation_url": "https://yourapp.com/chat/chat_1234"
  }
}

SMS şablonu örneği:

Liquid

New message from {{ message.custom_data.sender_name | default: "a user" }}: "{{ message.custom_data.message_preview }}". Reply in the app: {{ message.custom_data.conversation_url }}

OyunOyuncunun hemen harekete geçmesi gereken üs saldırıları gibi zaman açısından kritik etkinlikler için en iyisidir.

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_SMS_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_dragon"]
  },
  "custom_data": {
    "attacker_name": "Orca",
    "gold": "12400",
    "game_url": "https://yourgame.com/base/defend"
  }
}

SMS şablonu örneği:

Liquid

⚔️ ATTACK! {{ message.custom_data.attacker_name | default: "An enemy" }} is raiding your base. {{ message.custom_data.gold | default: "0" }} gold at risk. Defend now: {{ message.custom_data.game_url }}

Kullanıcılara yedek tercihleri üzerinde kontrol verin. “Bir mesajı kaçırırsam bana SMS ile bildir” gibi bir opt-in, push’u kasıtlı olarak devre dışı bırakmış kullanıcılar için istenmeyen mesajları önlemeye yardımcı olur.

SSS

OneSignal bir sohbet uygulaması gibi gerçek zamanlı bildirim gönderebilir mi?

Hayır. Push bildirimleri Apple (APNs) ve Google (FCM) altyapısı üzerinden teslim edilir; bu, değişken teslimat süreleri getirir ve teslimat garantisi yoktur. Gerçek zamanlı uygulama içi iletişim için uygulamanızın mevcut mesajlaşma katmanını kullanın ve alıcı uygulamada aktif olarak bulunmadığında OneSignal’i bir yedek olarak kullanın.

Zaten uygulamada olan bir kullanıcıyı bilgilendirmekten nasıl kaçınırım?

OneSignal, bir kullanıcının uygulamanızda o anda aktif olup olmadığını izlemez. Bildirimi tetikleyip tetiklemeyeceğinizi kendi backend mantığınız belirlemelidir. OneSignal API’sini yalnızca alıcının çevrimdışı olduğunu veya ilgili ekranda olmadığını doğruladıktan sonra çağırın.

Hızlı mesaj dizilerinden kaynaklanan birden fazla bildirimi nasıl önlerim?

Bildirim göndermeden önce backend’inize kısa bir gecikme ekleyin. İlk mesaj geldiğinde bir zamanlayıcı başlatın. Dolmadan önce başka bir mesaj gelirse zamanlayıcıyı sıfırlayın. Zamanlayıcı dolduğunda, okunmamış sayısını içeren tek bir push gönderin. OneSignal, birden fazla API çağrısını otomatik olarak birleştirmez; bu nedenle API’yi beş kez çağırırsanız beş bildirim gönderilir.

`custom_data`, mesaj gönderildikten sonra kullanıcının profiline kaydedilir mi?

Hayır. custom_data geçicidir ve yalnızca API isteği sırasında var olur; şablonu gönderim anında oluşturmak için kullanılır. OneSignal’de saklanmaz ve gelecekteki mesajlarda veya Journeys’te yeniden kullanılamaz. Kalıcı kullanıcı verileri için Etiketler’i kullanın.

Tek bir API çağrısında birden fazla alıcıyı hedefleyebilir miyim?

Evet. include_aliases dizisinde birden fazla external_id değeri iletin. Her alıcının farklı kişiselleştirilmiş içeriğe ihtiyacı varsa (örneğin, farklı saldırgan adları), custom_data içindeki toplu kişiselleştirme kalıbını kullanın. Tam yaklaşım için API custom_data ile mesajları kişiselleştirme’ye bakın. Çağrı başına kesin alıcı sınırı ve hız sınırları Create Message API referansında belgelenmiştir — çok büyük hedef kitleler için segment tabanlı hedefleme, çağrı başına binlerce external_id değeri iletmekten daha verimlidir.

Uluslararası kullanıcılar için mesajları yerelleştirmem gerekir mi?

Birden fazla dile yayılan herhangi bir hedef kitle için evet. headings ve contents alanları birden fazla dil kodu kabul eder (örneğin, { "en": "...", "es": "...", "fr": "..." }) ve OneSignal, her aboneliğin diline göre doğru varyantı seçer. Aynı kalıp şablon alanları için de geçerlidir. Yedek dil davranışı dahil tam referans için Çok dilli mesajlaşma’ya bakın.

İlgili sayfalar

API custom_data ile mesajları kişiselleştirme

custom_data ve Liquid sözdizimini kullanarak şablonlara dinamik, mesaja özel veriler ekleyin.

Mesaj kişiselleştirme

Etiketler, kullanıcı öznitelikleri ve segmentasyon dahil OneSignal’deki tüm kişiselleştirme seçeneklerine genel bakış.

Derin bağlantı

Kullanıcılar bir bildirime dokunduğunda onları uygulamanızdaki belirli bir ekrana yönlendirin.

Activity Feed oluşturma

OneSignal’in bildirim gelen kutusunu kullanarak uygulamanızın içinde sosyal uyarıların geçmişini görüntüleyin.

Şablonlar

Push, e-posta ve SMS için yeniden kullanılabilir mesaj şablonları oluşturun ve yönetin.

Create Message API

custom_data, hedefleme ve tüm mevcut alanlarla mesaj göndermek için eksiksiz API referansı.

Eğitimler

🏢 Sektörlere Göre

📈 Katılımı ve Elde Tutmayı Artırın

🔔 Kritik veya Zaman Sınırlı Mesajları Gönderin

🧠 Hedefleme ve Kişiselleştirmeyi Artırın

🛠️ Kullanıcı Deneyimini ve Onboarding'ı Artırın

Sosyal etkinlik

Sosyal etkinlik

Doğrudan mesajlar

Oyun uyarıları

Ön koşullar

Sosyal etkinlik bildirimleri

Yaygın sosyal eylemler

Kurulum

Yüksek hacimli eylemleri kısıtlayın

Doğrudan (kullanıcıdan kullanıcıya) mesajlar

Kurulum

Oyun: rekabetçi ve sosyal uyarılar

Yaygın rekabetçi etkinlikler

Kurulum

Daha fazla oyun uyarısı örneği

E-posta ve SMS yedekleri

SSS

OneSignal bir sohbet uygulaması gibi gerçek zamanlı bildirim gönderebilir mi?

Zaten uygulamada olan bir kullanıcıyı bilgilendirmekten nasıl kaçınırım?

Hızlı mesaj dizilerinden kaynaklanan birden fazla bildirimi nasıl önlerim?

`custom_data`, mesaj gönderildikten sonra kullanıcının profiline kaydedilir mi?

Tek bir API çağrısında birden fazla alıcıyı hedefleyebilir miyim?

Uluslararası kullanıcılar için mesajları yerelleştirmem gerekir mi?

İlgili sayfalar

API custom_data ile mesajları kişiselleştirme

Mesaj kişiselleştirme

Derin bağlantı

Activity Feed oluşturma

Şablonlar

Create Message API

Sosyal etkinlik

Doğrudan mesajlar

Oyun uyarıları

​Ön koşullar

​Sosyal etkinlik bildirimleri

​Yaygın sosyal eylemler

​Kurulum

​Yüksek hacimli eylemleri kısıtlayın

​Doğrudan (kullanıcıdan kullanıcıya) mesajlar

​Kurulum

​Oyun: rekabetçi ve sosyal uyarılar

​Yaygın rekabetçi etkinlikler

​Kurulum

​Daha fazla oyun uyarısı örneği

​E-posta ve SMS yedekleri

​SSS

​OneSignal bir sohbet uygulaması gibi gerçek zamanlı bildirim gönderebilir mi?

​Zaten uygulamada olan bir kullanıcıyı bilgilendirmekten nasıl kaçınırım?

​Hızlı mesaj dizilerinden kaynaklanan birden fazla bildirimi nasıl önlerim?

​custom_data, mesaj gönderildikten sonra kullanıcının profiline kaydedilir mi?

​Tek bir API çağrısında birden fazla alıcıyı hedefleyebilir miyim?

​Uluslararası kullanıcılar için mesajları yerelleştirmem gerekir mi?

​İlgili sayfalar

API custom_data ile mesajları kişiselleştirme

Mesaj kişiselleştirme

Derin bağlantı

Activity Feed oluşturma

Şablonlar

Create Message API

Ön koşullar

Sosyal etkinlik bildirimleri

Yaygın sosyal eylemler

Kurulum

Yüksek hacimli eylemleri kısıtlayın

Doğrudan (kullanıcıdan kullanıcıya) mesajlar

Kurulum

Oyun: rekabetçi ve sosyal uyarılar

Yaygın rekabetçi etkinlikler

Kurulum

Daha fazla oyun uyarısı örneği

E-posta ve SMS yedekleri

SSS

OneSignal bir sohbet uygulaması gibi gerçek zamanlı bildirim gönderebilir mi?

Zaten uygulamada olan bir kullanıcıyı bilgilendirmekten nasıl kaçınırım?

Hızlı mesaj dizilerinden kaynaklanan birden fazla bildirimi nasıl önlerim?

`custom_data`, mesaj gönderildikten sonra kullanıcının profiline kaydedilir mi?

Tek bir API çağrısında birden fazla alıcıyı hedefleyebilir miyim?

Uluslararası kullanıcılar için mesajları yerelleştirmem gerekir mi?

İlgili sayfalar