Apple ve Google, abonelik olaylarını doğrudan Adapty sunucularına bildirir — App Store Sunucu Bildirimleri ve Gerçek Zamanlı Geliştirici Bildirimleri aracılığıyla. Kullanıcının dönüştüğünü, yenilediğini veya ayrıldığını bu şekilde öğrenirsiniz.

Bu olayları iletmek için Adapty’de hedef yapılandırmasını ayarlayın. Üçüncü taraf platformlar — MMP’ler, analitik araçları, mesajlaşma platformları — her birinin kendi entegrasyon sayfası vardır. Kendi backend’iniz olayları webhook aracılığıyla alır.

Her olay aynı yapıyı paylaşır; ancak alanlar olay türüne, mağazaya ve ayarlarınıza göre değişir. Webhook olay türleri ve alanları webhook payload’ını belgeler ve her entegrasyon makalesi, ilgili hedefin aldığı formatı belgeler. Olay durumları bir teslimat durumunun nasıl okunacağını açıklar.

Örnekler

Çoğu event, kullanıcının satın almalarını ilk ödeme anından sona erme tarihine kadar takip eder.

Kullanıcı deneme süresi boyunca iptal eder

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

Bu durumda şu olaylar gönderilecektir:

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

Kullanıcı dönüşümden sonra iptal eder

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

Bu durumda aşağıdaki olaylar gönderilir:

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

Her senaryoda hangi olayların tetiklendiğine dair ayrıntılı bir döküm için Event flows sayfasına göz atın.

Etkinlik listesi

Her entegrasyonun hangi etkinlikleri alacağını kontrol edebilirsiniz. Üç tanesi hariç, çoğu etkinlik her entegrasyon için kullanılabilir:

• Access level updated yalnızca hem webhook entegrasyonu yapılandırılmışsa hem de ilgili olay etkinleştirilmişse tetiklenir. Event Feed üzerinde görünür ve webhook’a iletilir, ancak başka hiçbir entegrasyon bu olayı almaz. Webhook entegrasyonu yapılandırılmamışsa veya olay türü etkinleştirilmemişse Adapty olayı hiç oluşturmaz ve Event Feed’de de görünmez.
• Trial still active ve Subscription still active, sentetik olaylardır ve yalnızca bazı entegrasyonlar bu olayları alır.

Aşağıdaki tablo, Adapty’nin üçüncü taraf entegrasyonlara gönderebileceği tüm olayları listeler:

Olay adı	Açıklama
subscription_started	Kullanıcı deneme süresi olmadan ücretli bir abonelik başlattığında, yani anında faturalandırıldığında tetiklenir.
subscription_active	subscription_started olayının ardından aboneliğin hâlâ aktif olduğunu doğrular. Aboneliğin başlangıcı ile bu kontrol arasındaki gün sayısını ayarlamanız gerekir. Abonelik hâlâ aktifse (kullanıcı ek süreye girmiş olsa bile) olay gelir. O zamana kadar abonelik sona erdiyse veya kullanıcı otomatik yenilemeyi kapattıysa hiçbir şey gelmez ve Adapty tekrar kontrol etmez. Bu olay yalnızca deneme süresi olmadan satın alınan abonelikleri takip eder. Deneme sürümünden dönüşüm trial_converted olayını gönderir ve bu olay söz konusu kontrolü başlatmaz.
subscription_renewed	Abonelik yenilendiğinde ve kullanıcı faturalandırıldığında gerçekleşir. Bu olay, deneme sürümlü ya da deneme sürümsüz aboneliklerde ikinci faturalandırmadan itibaren başlar.
subscription_renewal_cancelled	Kullanıcı abonelik otomatik yenilemeyi kapattı. Kullanıcı, ücretli abonelik dönemi sona erene kadar premium özelliklere erişimini korur.
subscription_renewal_reactivated	Kullanıcı abonelik otomatik yenilemeyi yeniden etkinleştirdiğinde tetiklenir.
subscription_expired	İptal edilen bir abonelik tamamen sona erdiğinde tetiklenir. Örneğin, kullanıcı 12 Aralık’ta aboneliğini iptal edip abonelik 31 Aralık’a kadar aktif kalıyorsa, olay 31 Aralık’ta abonelik sona erdiğinde kaydedilir.
subscription_paused	Kullanıcı abonelik duraklatma özelliğini etkinleştirdiğinde gerçekleşir (yalnızca Android).
subscription_deferred	Bir abonelik satın alma işlemi ertelendiğinde tetiklenir; bu sayede 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 finansal güçlük yaşayan kullanıcılara destek sağlamak amacıyla kullanılabilir.
non_subscription_purchase	Süresiz erişim veya oyun içi para birimi gibi consumable ürünler dahil olmak üzere abonelik dışı tüm satın almalar.
trial_started	Kullanıcı deneme sürümü aboneliği başlattığında tetiklenir.
trial_active	trial_started olayının ardından denemenin hâlâ aktif olduğunu doğrular. Denemenin başlangıcı ile bu kontrol arasındaki gün sayısını ayarlamanız gerekir. Deneme hâlâ devam ediyorsa olay gelir. O zamana kadar deneme sona erdiyse veya dönüştüyse ya da kullanıcı otomatik yenilemeyi kapattıysa hiçbir şey gelmez ve Adapty tekrar kontrol etmez.
trial_converted	Deneme süresi sona erip kullanıcı faturalandırıldığında (ilk satın alma) gerçekleşir. Örneğin, kullanıcının denemesi 14 Ocak’a kadar sürüyorsa ancak 7 Ocak’ta faturalandırıldıysa bu olay 7 Ocak’ta kaydedilir.
trial_renewal_cancelled	Kullanıcı deneme süresi boyunca abonelik otomatik yenilemeyi kapattı. Kullanıcı deneme süresi sona erene kadar premium özelliklere erişimini korur ancak faturalandırılmaz ve abonelik başlamaz.
trial_renewal_reactivated	Kullanıcı deneme süresi boyunca abonelik otomatik yenilemeyi yeniden etkinleştirdiğinde gerçekleşir.
trial_expired	Deneme 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 (etkinleştirilmişse) gerçekleşir. Kullanıcı bu süre boyunca premium erişimini korur.
billing_issue_detected	Ödeme girişimi sırasında bir faturalama sorunu oluştuğunda (örneğin yetersiz kart bakiyesi) tetiklenir.
subscription_refunded	Abonelik iade edildiğinde (örneğin Apple Destek tarafından) tetiklenir.
non_subscription_purchase_refunded	Abonelik dışı bir satın alma iade edildiğinde tetiklenir.
access_level_updated	Kullanıcının access level’ı güncellendiğinde gerçekleşir.

Sentetik olaylar

Çoğu olay bir değişiklikle tetiklenir — bir satın alma, yenileme veya iptal. Trial still active ve Subscription still active olayları ise tam tersidir. Bir zamanlayıcı kurarsınız. Zamanlayıcı sona erdiğinde Adapty, deneme sürümünün veya aboneliğin durumunu kontrol eder. Deneme sürümü veya abonelik sona ermediyse Adapty ilgili olayı tetikler.

Bu sentetik olaylar Adjust, Amplitude, AppMetrica, AppsFlyer, Branch, Facebook Analytics, Firebase, Mixpanel, OneSignal, PostHog, Singular, SplitMetrics ve webhook için kullanılabilir. Bunları manuel olarak etkinleştirmeniz gerekir.

Kullanıcı zamanlayıcı süresi dolmadan otomatik yenilemeyi kapatırsa, Adapty gönderimi atlar. Ücretli dönem sonuna kadar erişimleri devam etse de kullanıcıyı ayrılmış olarak sayar.

Olayı kapatmak, Adapty’nin yeni zamanlayıcı başlatmasını engeller. Halihazırda çalışan zamanlayıcılar süresi dolduğunda yine de gönderim yapar; bu nedenle bir hedef, yapılandırdığınız gecikme süresi kadar olayı almaya devam edebilir.

Deneme süresi hâlâ devam ediyor

• Entegrasyon: AppsFlyer
• Etkinlik: Deneme süresi aktif
• Gecikme: 3 gün
• Deneme başlangıcı: 1 Nisan
• Deneme sonu: 7 Nisan

AppsFlyer şunları alır:

1. 1 Nisan’da trial_started
2. 4 Nisan’da trial_active
3. 7 Nisan’da trial_converted

Aşağıdakilere dikkat edin:

• Dönüşüm gerçekleşen bir deneme süresi olduğundan, hiçbir zaman subscription_active etkinliği almazsınız.
• Gecikme 7 gün olarak ayarlanmış olsaydı, trial_active hiç gelmezdi. O zaman kullanıcı zaten dönüşüm yapmış olurdu.

Abonelik hâlâ devam ediyor

• Entegrasyon: Webhook
• Etkinlik: Abonelik hâlâ aktif
• Gecikme: 7 gün
• Abonelik başlangıcı: 1 Nisan, deneme süresi olmadan
• Yenileme: 1 Mayıs

Webhook şunları alır:

1. 1 Nisan’da subscription_started
2. 8 Nisan’da subscription_active
3. 1 Mayıs’ta subscription_renewed