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 olmaksızın ücretli bir aboneliği etkinleştirdiğinde, yani anında ücretlendirildiğinde 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ün yapılacağı gün sayısını belirlemeniz gerekir. Kullanıcı ek süreye girmiş olsa dahi abonelik hâlâ aktifse olay gelir. O tarihe kadar abonelik sona ermişse ya da kullanıcı otomatik yenilemeyi kapattıysa herhangi bir olay gelmez ve Adapty tekrar kontrol etmez. Bu olay yalnızca deneme süresi olmadan satın alınan abonelikleri takip eder. Deneme süresinin ücretli aboneliğe dönüşmesi trial_converted olayını gönderir ve bu olay kontrolü başlatmaz.
subscription_renewed	Abonelik yenilendiğinde ve kullanıcı ücretlendirildiğinde gerçekleşir. Deneme süreli veya denemesiz abonelik fark etmeksizin ikinci ödemeden itibaren bu olay tetiklenir.
subscription_renewal_cancelled	Kullanıcı abonelik otomatik yenilemeyi kapattı. Kullanıcı, ücretli abonelik döneminin sonuna kadar premium özelliklere erişmeye devam eder.
subscription_renewal_reactivated	Kullanıcı abonelik otomatik yenilemeyi yeniden etkinleştirdiğinde tetiklenir.
subscription_expired	Abonelik iptal edildikten sonra tamamen sona erdiğinde tetiklenir. Örneğin kullanıcı aboneliğini 12 Aralık’ta iptal edip abonelik 31 Aralık’a kadar aktif kalıyorsa bu olay, aboneliğin sona erdiği 31 Aralık’ta kaydedilir.
subscription_paused	Kullanıcı abonelik duraklatma özelliğini etkinleştirdiğinde gerçekleşir (yalnızca Android).
subscription_deferred	Kullanıcının aboneliğini ücretsiz olarak uzattığınızda tetiklenir: Google Play Developer API üzerinden erteleme ya da App Store Server API üzerinden yenileme tarihi uzatma. Kullanıcı, uzatılmış yenileme tarihine kadar premium özelliklere erişmeye devam eder.
non_subscription_purchase	Süresiz erişim veya oyun içi para gibi consumable ürünler dahil olmak üzere abonelik dışındaki her türlü satın alma.
trial_started	Kullanıcı deneme aboneliğini etkinleştirdiğinde 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ün yapılacağı gün sayısını belirlemeniz gerekir. Deneme hâlâ devam ediyorsa olay gelir. O tarihe kadar deneme sona ermiş veya ücretli aboneliğe dönüşmüşse ya da kullanıcı otomatik yenilemeyi kapattıysa herhangi bir olay gelmez ve Adapty tekrar kontrol etmez.
trial_converted	Deneme süresi sona erip kullanıcı ücretlendirildiğinde (ilk satın alma) gerçekleşir. Örneğin kullanıcının denemesi 14 Ocak’a kadar sürüyorsa ancak kullanıcı 7 Ocak’ta ücretlendiriliyorsa bu olay 7 Ocak’ta kaydedilir.
trial_renewal_cancelled	Kullanıcı deneme süresi içinde abonelik otomatik yenilemeyi kapattı. Kullanıcı deneme süresi sonuna kadar premium özelliklere erişmeye devam eder ancak ücretlendirilmez ve abonelik başlamaz.
trial_renewal_reactivated	Kullanıcı deneme süresi içinde 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	Ücretlendirme sırasında bir ödeme sorunu oluştuğunda (örn. yetersiz kart bakiyesi) tetiklenir.
subscription_refunded	Abonelik iade edildiğinde (örn. 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 bitişi: 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:

• Deneme süresi dönüşümle tamamlandığından subscription_active etkinliğini hiçbir zaman almazsınız.
• Gecikme 7 gün olarak ayarlanmış olsaydı, trial_active hiç gelmezdi. O zamana kadar kullanıcı zaten dönüşüm gerçekleştirmiş 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