Ana içeriğe atla
Liquid sözdizimi kullanarak event stream verilerine erişin. İstediğiniz veri noktasını Event Stream’de yakalamak için {{ }} içine sarın. Örneklere bakın.
Mesaj olay verisi sınırlamalarıYolculuklarımız veya API aracılığıyla gönderilen mesajlara ait veriler sistemimizde yalnızca 30 gün boyunca mevcuttur. Bu, Yolculuk veya API mesajı gönderildikten 30+ gün sonra gerçekleşen herhangi bir mesaj olayının (tıklamalar, açılmalar, abonelik iptalleri vb.) event stream’de mevcut olmayacağı anlamına gelir. Bu, analitiğinizde boş veya eksik veri olarak görünebilir.Bu sınırlamayı aşmak için, bu tıklanan/açılan/abonelikten çıkılan olayların message_id’sini aynı message_id’ye sahip orijinal gönderilen olayla ilişkilendirebilirsiniz. Orijinal sent olayı ilgili mesaj verilerine (başlık, şablon vb.) sahip olmalıdır.

​
event özellikleri

event nesnesi aşağıdaki özellikleri içerir:

​
Kind

Tip: String Mesaj türü (push, email, sms, iam) ve olay (örn. received, sent, clicked, failed, unsubscribed, displayed, pagedisplayed, opened, clicked, unsubscribed, reported_as_spam, hardbounced, failed, supressed). Kullanım: {{ event.kind }}
Mesaj Olay Türü (OneSignal)Olay adı (veri setinde)Olay Açıklaması
Push Gönderildimessage.push.sentPush bildirimi push hizmetlerine (FCM, APNS, vb.) başarıyla gönderildi.
Push Alındımessage.push.receivedPush bildirimi alıcı tarafından alındı. Tüm platformlarda mevcut değildir. Daha fazla ayrıntı için Onaylanmış Teslimat’a bakın.
Push Tıklandımessage.push.clickedKullanıcı cihazda uygulamayı açmak için push bildirimine dokundu.
Push Başarısızmessage.push.failedPush gönderilemedi. Ayrıntılar için Push Mesaj Raporları’na bakın.
Push Abonelikten Çıkıldımessage.push.unsubscribedKullanıcı push aboneliğinden çıktı. Push abonelik durumları ne zaman güncellenir? bölümüne bakın.
Uygulama İçi Gösterimmessage.iam.displayedUygulama İçi Mesaj cihazda başarıyla görüntülendi.
Uygulama İçi Tıklandımessage.iam.clickedKullanıcı Uygulama İçi Mesaj’daki bir öğeye dokundu.
Uygulama İçi Sayfa Görüntülendimessage.iam.pagedisplayedUygulama İçi Mesaj sayfası görüntülendi. Karusel takibi için yararlıdır.
E-posta Gönderildimessage.email.sentE-posta başarıyla gönderildi.
E-posta Alındımessage.email.receivedE-posta alıcı tarafından alındı.
E-posta Açıldımessage.email.openedE-posta alıcı tarafından açıldı. Ayrıntılar için E-posta Mesaj Raporları’na bakın.
E-posta Bağlantısı Tıklandımessage.email.clickedKullanıcı e-postadaki bir bağlantıya dokundu.
E-postadan Abonelik İptal Edildimessage.email.unsubscribedKullanıcı abonelikten çıkma bağlantısı aracılığıyla e-postadan aboneliğini iptal etti.
E-posta Spam Olarak Bildirildimessage.email.reported_as_spamKullanıcı e-postayı spam olarak bildirdi. Gmail izlemek için Google Postmaster Tools gerektirir. Daha fazla ayrıntı için E-posta teslim edilebilirliği’ne bakın.
E-posta Geri Döndümessage.email.hardbouncedE-posta kalıcı hata nedeniyle gönderene döndü. Ayrıntılar için E-posta Mesaj Raporları’na bakın.
E-posta Başarısızmessage.email.failedE-posta teslim edilemedi. Ayrıntılar için E-posta Mesaj Raporları’na bakın.
E-posta Bastırıldımessage.email.supressedE-posta adresi Bastırma listesinde olduğu için e-posta gönderilemedi.
SMS Gönderildimessage.sms.sentSMS alıcıya gönderildi
SMS Başarısızmessage.sms.failedSMS gönderilemedi. Ayrıntılar için SMS Mesaj Raporları’na bakın.
SMS Teslim Edildimessage.sms.deliveredSMS başarıyla teslim edildi
SMS Teslim Edilemedimessage.sms.undeliveredSMS gönderilemedi. Ayrıntılar için SMS Mesaj Raporları’na bakın.

​
Event ID

Tip: UUID UUID v4 formatında her bir olay için OneSignal tarafından oluşturulan benzersiz bir tanımlayıcı. Bu ID’yi idempotent teslimat takibi için kullanın. Belirli mesaj veya şablon tanımlayıcısını arıyorsanız, message.id veya message.template_id kullanın. Kullanım: {{ event.id }}

​
Timestamp

Tip: Integer Olayın UNIX zaman damgası. Kullanım: {{ event.timestamp }}

​
UTC datetime

Tip: String UTC’de olayın okunabilir zamanı (özellikle “2024-02-21T23:45:15.228Z” gibi bir ISO dizesi). Kullanım: {{ event.datetime }}

​
App ID

Tip: UUID OneSignal App ID. Kullanım: {{ event.app_id }}

​
Subscription type

Tip: String Abonelik türü (örn. iOS, Android, Chrome, Email, SMS, vb.). Kullanım: {{ event.subscription_device_type }}

​
Subscription ID

Tip: UUID OneSignal Subscription ID. Kullanım: {{ event.subscription_id }}

​
OneSignal User ID

Tip: UUID OneSignal tarafından oluşturulan User ID. Kullanım: {{ event.onesignal_id }}

​
External User ID

Tip: String OneSignal External ID takma adı olarak ayarlanan Kullanıcı ID’niz. OneSignal’da ayarlanmamışsa boş olabilir. Kullanım: {{ event.external_id }}

​
Uygulama içi mesaj sayfa adı

Tip: String Belirli uygulama içi mesaj olayları için görüntülenen sayfa veya kartın adı. Ayrıntılar için Uygulama içi mesaj Event Streams’e bakın. Kullanım: {{ event.data.page_name }}

​
Uygulama içi mesaj sayfa ID’si

Tip: String Belirli uygulama içi mesaj olayları için görüntülenen sayfa veya kart için benzersiz bir tanımlayıcı. Ayrıntılar için Uygulama içi mesaj Event Streams’e bakın. Kullanım: {{ event.data.page_id }}

​
Uygulama içi mesaj hedef adı

Tip: String Tıklanan düğme veya görüntü blok öğesinin adı. Bir Uygulama içi tıklama eylemi içermelidir. Ayrıntılar için Uygulama içi mesaj Event Streams’e bakın. Kullanım: {{ event.data.target_name }}

​
Uygulama içi mesaj hedef ID’si

Tip: String Tıklanan düğme veya görüntü blok öğesi için benzersiz bir tanımlayıcı. Bir Uygulama içi tıklama eylemi içermelidir. Ayrıntılar için Uygulama içi mesaj Event Streams’e bakın. Kullanım: {{ event.data.target_id }}

​
Örnek Girdi

{
  "event.kind": "{{ event.kind }}",
  "event.id": "{{ event.id }}",
  "event.timestamp": "{{ event.timestamp }}",
  "event.datetime": "{{ event.datetime }}",
  "event.app_id": "{{ event.app_id }}",
  "event.subscription_device_type": "{{ event.subscription_device_type }}",
  "event.subscription_id": "{{ event.subscription_id }}",
  "event.onesignal_id": "{{ event.onesignal_id }}",
  "event.external_id": "{{ event.external_id }}",
  "event.data.page_name": "{{ event.data.page_name}}",
  "event.data.page_id": "{{ event.data.page_id}}",
  "event.data.target_name": "{{ event.data.target_name}}",
  "event.data.target_id": "{{ event.data.target_id}}"
}

​
Mesaj özellikleri

message nesnesi, son kullanıcıya gönderilen mesajlar hakkında sizi bilgilendirmek üzere tasarlanmıştır. Mesajın gerçek metnini içeren id, template_id ve content gibi özellikleri içerir.

​
Message ID

Tip: UUID OneSignal tarafından oluşturulan mesaj ID’si. Kullanım: {{ message.id }}

​
Message Name

Tip: String Gösterge panosunda veya API name özelliği kullanılarak ayarlanan mesajın adı. Kullanım: {{ message.name }}

​
Message Title

Tip: Object Gösterge panosunda veya API headings veya email_subject özellikleri kullanılarak ayarlanan push mesajının başlığı veya e-posta konusu. Kullanım: {{ message.title }}

​
Message Contents

Tip: Object Gösterge panosunda veya API contents özelliği kullanılarak ayarlanan push veya SMS mesajının içeriği (50 karakterde kesilir). E-posta içerikleri (email_body) sağlanmaz. Kullanım: {{ message.contents }}

​
Template ID

Tip: UUID Yolculuklar aracılığıyla veya API template_id özelliği ile gönderilen bir mesaj için şablon ID’si. Kullanım: {{ message.template_id }}

​
Launch URL

Tip: String Mesajın başlatma URL’si (web ve uygulama bağımsız yalnızca bir URL kullanılırken). Ayrıntılar için URL’ler, Bağlantılar ve Derin Bağlantılar’a bakın. Kullanım: {{ message.url }}

​
App-Specific URL

Tip: String Hem web hem de uygulamaya özel URL kullanılırken mesajın başlatma URL’si. Ayrıntılar için URL’ler, Bağlantılar ve Derin Bağlantılar’a bakın. Kullanım: {{ message.app_url }}

​
Web-Specific URL

Tip: String Hem web hem de uygulamaya özel URL kullanılırken mesajın başlatma URL’si. Ayrıntılar için URL’ler, Bağlantılar ve Derin Bağlantılar’a bakın. Kullanım: {{ message.web_url }}

​
Örnek Mesaj Nesnesi

{
  "message.id": "f3c9cd09-10d7-4f59-b9bc-66e16607f1d5",
  "message.name": "the-name-you-set",
  "message.title": "Claim 50% Off Today", // email subject example
  "message.title": "{'en':'the message title/headings'}", // push title example
  "message.contents": "{'en':'the message content'}",
  "message.template_id": "the-template-uuid-if-set",
  "message.url": "the-message-url",
  "message.app_url": "the-message-app-url",
  "message.web_url": "the-message-web-url"
}

​
Kullanıcı özellikleri

​
OneSignal ID

Tip: String Kullanıcının OneSignal ID’si. Kullanım {{ user.onesignal_id }}

​
External ID

Tip: String Kullanıcının External ID’si. Kullanım: {{ user.external_id }}

​
Tags

Tip: Object Kullanıcının etiketleri. Kullanım:
  • Etiketler nesnesi: {{ user.tags }}
  • Belirli etiket dizesi: {{ user.tags.your_tag }}
  • Tüm etiketleri almaya çalışıyorsanız, etiketler nesnesini {{ user.tags}} gibi referans edin.
  • Belirli bir etiketi almaya çalışıyorsanız, etiketi bir dize olarak referans edin: "{{ user.tags.your_tag | default: '' }}".

​
Language

Tip: String Kullanıcının dili. Kullanım: {{ user.language }}

​
Abonelik özellikleri

​
Subscription ID

Tip: String Mesajın gönderildiği aboneliğin ID’si. Kullanım: {{ user.subscription.id }}

​
App ID

Tip: String Uygulamanın ID’si. Kullanım: {{ user.subscription.app_id }}

​
Subscription Token

Tip: String Mesajın gönderildiği abonelik için token.
  • Tür E-posta ise, token bir e-posta adresi olacaktır.
  • Tür SMS ise, token E.164 formatında bir telefon numarası olacaktır.
  • Tür Push seçeneklerinden biri ise, token bir push token olacaktır.
Kullanım: {{ user.subscription.subscription_token }}

​
Session Count

Tip: Number Mesajın gönderildiği abonelik için oturum sayısı. Kullanım: {{ user.subscription.session_count }}

​
Language

Tip: String Mesajın gönderildiği abonelikte ayarlanan dil. Kullanım: {{ user.subscription.language }}

​
Game Version

Tip: String Mesajın gönderildiği abonelikte ayarlanan oyun sürümü. Kullanım: {{ user.subscription.game_version }}

​
Last Active

Tip: Number Mesajın gönderildiği abonelikte ayarlanan son aktif zaman. Kullanım: {{ user.subscription.last_active }}

​
Play Time

Tip: Number Mesajın gönderildiği abonelikte ayarlanan oyun süresi. Kullanım: {{ user.subscription.play_time }}

​
Amount Spent

Tip: Number Mesajın gönderildiği abonelikte harcanan tutar. Kullanım: {{ user.subscription.amount_spent }}

​
Created At

Tip: Number Mesajın gönderildiği aboneliğin oluşturulma zamanı. Kullanım: {{ user.subscription.created_at }}

​
Subscribed

Tip: Boolean Mesajın gönderildiği aboneliğin şu anda abone olup olmadığını belirtir. Kullanım: {{ user.subscription.subscribed }}

​
SDK

Tip: String Mesajın gönderildiği abonelikte ayarlanan SDK sürümü. Kullanım: {{ user.subscription.sdk }}

​
Device Model

Tip: String Mesajın gönderildiği abonelikte ayarlanan cihaz modeli. Kullanım: {{ user.subscription.device_model }}

​
Device OS

Tip: String Mesajın gönderildiği abonelikte ayarlanan cihaz işletim sistemi. Kullanım: {{ user.subscription.device_os }}

​
Tags

Tip: Object Kullanıcının etiketleri. Tüm nesneye veya belirli etiketlere erişebilirsiniz. Kullanım:
  • Tüm Etiketler: {{ user.tags }}
  • Belirli Etiket: {{ user.tags.your_tag }}