Üçüncü taraf entegrasyonlara gönderilecek olaylar

Apple ve Google, abonelik olaylarını App Store Sunucu Bildirimleri ve Gerçek Zamanlı Geliştirici Bildirimleri (RTDN) aracılığıyla doğrudan sunuculara gönderir. Bu nedenle mobil uygulamalar, olayları analitik sistemlere gerçek zamanlı olarak güvenilir biçimde iletamaz. Örneğin bir kullanıcı abone olup uygulamayı bir daha açmazsa, geliştirici sunucu olmadan hiçbir abonelik durum güncellemesi alamaz.

Adapty bu boşluğu, abonelik verilerini toplayıp okunabilir olaylara dönüştürerek kapatır. Bu entegrasyon olayları JSON formatında gönderilir. Tüm olaylar aynı yapıyı paylaşsa da alanları olay türüne, mağazaya ve belirli yapılandırmaya göre farklılık gösterir. Her olaya dahil edilen tam alanları ilgili entegrasyon sayfalarında bulabilirsiniz.

Bir olayın başarıyla işlenip işlenmediğini veya bir sorun olup olmadığını nasıl anlayacağınızı öğrenmek için Olay durumları sayfasına göz atın.

Olay türleri

Olayların büyük çoğunluğu oluşturulup etkinleştirildiklerinde yapılandırılmış tüm entegrasyonlara gönderilir. Ancak Access level updated olayı yalnızca webhook entegrasyonu yapılandırılmışsa ve bu olay etkinleştirilmişse tetiklenir. Bu olay Event Feed’de görünecek ve webhook’a gönderilecektir; ancak diğer entegrasyonlarla paylaşılmaz.

Bir webhook entegrasyonu yapılandırılmamışsa veya bu olay türü etkinleştirilmemişse Access level updated olayı oluşturulmaz ve Event Feed’de görünmez.

Event nameDescription
subscription_startedKullanıcı deneme süresi olmaksızın ücretli bir abonelik etkinleştirdiğinde, yani anında ücretlendirildiğinde tetiklenir.
subscription_renewedAbonelik yenilendiğinde ve kullanıcı ücretlendirildiğinde gerçekleşir. Bu olay, deneme süreli veya deneme süresiz aboneliklerde ikinci ödemeden itibaren başlar.
subscription_renewal_cancelledKullanıcı abonelik otomatik yenilemesini kapattığında tetiklenir. Kullanıcı, ücretli abonelik süresi sonuna kadar premium özelliklere erişmeye devam eder.
subscription_renewal_reactivatedKullanıcı abonelik otomatik yenilemesini yeniden etkinleştirdiğinde tetiklenir.
subscription_expiredİptal edilen bir abonelik tamamen sona erdiğinde tetiklenir. Örneğin, kullanıcı aboneliğini 12 Aralık’ta iptal etmiş ancak abonelik 31 Aralık’a kadar aktif kalmaya devam ediyorsa, olay aboneliğin sona erdiği 31 Aralık’ta kaydedilir.
subscription_pausedKullanıcı abonelik duraklatma özelliğini etkinleştirdiğinde gerçekleşir (yalnızca Android).
subscription_deferredAbonelik satın alımı ertelendiğinde tetiklenir; kullanıcılar premium özelliklere erişimlerini sürdürürken ödemeyi geciktirebilir. Bu özellik Google Play Developer API aracılığıyla kullanılabilir ve ücretsiz denemeler için ya da mali güçlük yaşayan kullanıcılara destek sağlamak amacıyla kullanılabilir.
non_subscription_purchaseSüresiz erişim veya oyun içi coin gibi consumable ürünler dahil, abonelik dışındaki tüm satın almalar.
trial_startedKullanıcı deneme aboneliği etkinleştirdiğinde tetiklenir.
trial_convertedDeneme süresi sona erdiğinde ve kullanıcı ücretlendirildiğinde (ilk satın alma) gerçekleşir. Örneğin, kullanıcının denemesi 14 Ocak’a kadar sürüyor ancak 7 Ocak’ta ücretlendiriliyorsa, bu olay 7 Ocak’ta kaydedilir.
trial_renewal_cancelledKullanıcı deneme süresi boyunca abonelik otomatik yenilemesini kapattığında tetiklenir. Kullanıcı deneme süresi sonuna kadar premium özelliklere erişmeye devam eder; ancak ücretlendirilmez ve abonelik başlatılmaz.
trial_renewal_reactivatedKullanıcı deneme süresi boyunca abonelik otomatik yenilemesini yeniden etkinleştirdiğinde gerçekleşir.
trial_expiredDeneme süresi aboneliğe dönüşmeden sona erdiğinde tetiklenir.
entered_grace_periodÖdeme girişimi başarısız olduğunda ve kullanıcı ek süreye girdiğinde gerçekleşir (etkinleştirilmişse). Kullanıcı bu süre boyunca premium erişimini korur.
billing_issue_detectedÜcretlendirme girişimi sırasında bir ödeme sorunu oluştuğunda (örn. yetersiz kart bakiyesi) tetiklenir.
subscription_refundedBir abonelik iade edildiğinde (örn. Apple Support tarafından) tetiklenir.
non_subscription_purchase_refundedAbonelik dışı bir satın alma iade edildiğinde tetiklenir.
access_level_updatedKullanıcının access level’ı güncellendiğinde gerçekleşir.

Yukarıdaki olaylar, kullanıcıların satın alma açısından durumunu eksiksiz biçimde kapsar. Birkaç örneğe bakalım.

Örnek 1

Kullanıcı 1 Nisan’da 7 günlük deneme süresiyle aylık bir abonelik başlattı. 4. günde aboneliğini iptal etti.

Bu durumda şu olaylar gönderilir:

  1. 1 Nisan’da trial_started
  2. 4 Nisan’da trial_renewal_cancelled
  3. 7 Nisan’da trial_expired

Örnek 2

Kullanıcı 1 Nisan’da 7 günlük deneme süresiyle aylık bir abonelik başlattı. 10. günde aboneliğini iptal etti.

Bu durumda şu olaylar gönderilir:

  1. 1 Nisan’da trial_started
  2. 7 Nisan’da trial_converted
  3. 10 Nisan’da subscription_renewal_cancelled
  4. 1 Mayıs’ta subscription_expired

Her senaryoda hangi olayların tetiklendiğine dair ayrıntılı bir döküm için Olay akışları sayfasına bakın.