RevenueCat ile e-posta tetikleyin

Uygulamanızda biri satın alma yaptığında, aboneliğini yenilediğinde, iptal ettiğinde veya bir faturalandırma sorunu yaşadığında markanıza uygun e-postalar göndermeye başlamak için RevenueCat’i bağlayın. Brew 11 RevenueCat yaşam döngüsü olayını destekler; aynı akış App Store, Google Play, Amazon, Stripe ve Web Billing abonelerinin tümüne hizmet verebilir.

Satın almalar, yenilemeler, iadeler ve erişim hakları (entitlements) RevenueCat’in ve mağazaların sorumluluğunda kalır. E-postaları ise Brew oluşturur ve gönderir.

• Abonelere hoş geldin e-postaları: INITIAL_PURCHASE olayı, deneme süresinin başlaması da dâhil olmak üzere yeni bir abonelik başladığında tetiklenir. Tek seferlik satın almalar ise NON_RENEWING_PURCHASE olarak gelir.
• Yenileme makbuzları: RENEWAL olayı, bir abonelik yenilendiğinde veya aboneliği sona ermiş biri yeniden abone olduğunda tetiklenir ve productId, priceUsd, pricePurchaseCurrency ile currency alanlarını taşır.
• Faturalandırma sorunu bildirimleri: BILLING_ISSUE olayı, bir ödeme başarısız olduğunda tetiklenir. Abonenin ödeme yöntemini güncelleyebileceği yere bağlantı verin.
• İptal sonrası takip e-postaları: CANCELLATION olayı cancelReason alanını taşır; böylece e-posta, bir iadeyi veya faturalandırma hatasını, abonenin aboneliği kendi isteğiyle iptal etmesinden farklı ele alabilir.
• Tekrar hoş geldin e-postaları: UNCANCELLATION olayı, bir abone iptal ettiği aboneliği süresi dolmadan yeniden etkinleştirdiğinde tetiklenir.
• Erişim sona erdikten sonra yeniden etkileşim: EXPIRATION olayı, bir abonelik gerçekten sona erdiğinde tetiklenir ve expirationReason alanını taşır.
• Plan değişikliği bildirimleri: PRODUCT_CHANGE olayı previousProductId ve newProductId alanlarını taşır. Yeni ürün daha sonra geçerli olabileceğinden e-postayı, değişikliğin talep edildiğini anlatacak biçimde yazın.
• Duraklatma ve uzatma bildirimleri: SUBSCRIPTION_PAUSED olayı, bir Google Play aboneliğinin dönem sonunda duraklatılması planlandığında tetiklenir. SUBSCRIPTION_EXTENDED olayı ise bir mağaza dönemi uzattığında veya Google Play bir tahsilatı ertelediğinde tetiklenir.

CANCELLATION olayı, iptal edilmiş bir abonelik veya bir iade anlamına gelebilir ve tek başına erişimin sona erdiğini göstermez. Erişimin sona erdiğini EXPIRATION olayı bildirir. SUBSCRIPTION_PAUSED olayı ise yalnızca ileride gerçekleşecek bir duraklatmayı planlar.

Geri kazanma veya ayrılma anketi e-postaları için CANCELLATION olayını, erişimin bittiğini varsayan her şey için EXPIRATION olayını kullanın. UNCANCELLATION olayı, daha önce başlamış bir iptal çalıştırmasını durdurmaz; bu yüzden sonraki her e-postadan önce revenuecat_subscription_status alanını bir koşulla kontrol edin.

SANDBOX olaylarını yayındaki otomasyonların dışında tutmak için environment alanına göre filtreleyin.

• RevenueCat webhookları için RevenueCat Pro veya üzeri bir plan gerekir.
• Entegrasyonlar sayfasını açın, RevenueCat’i seçin ve “Webhook URL’si oluştur” düğmesine tıklayın.
• RevenueCat panelinde Integrations > Webhooks bölümünü açın ve bir yapılandırma ekleyin. Brew URL’sini yapıştırın; Production, Sandbox veya ikisini birden seçin ve gönderilecek yaşam döngüsü olaylarını belirleyin.
• Bu yapılandırmada HMAC webhook imzalamayı açın ve imzalama anahtarını hemen kopyalayın. RevenueCat bu anahtarı yalnızca bir kez gösterir. Anahtarı Brew içine yapıştırın ve Bağla düğmesine tıklayın. RevenueCat REST API anahtarını veya isteğe bağlı Authorization başlığının değerini yapıştırmayın.
• RevenueCat üzerinden bir test webhooku gönderin. İmzalı bir TEST teslimi bağlantıyı etkinleştirir ama hiçbir zaman müşteri otomasyonu başlatmaz.
• Her müşteri için $email abone özelliğini ayarlayın; böylece Brew e-postayı gönderebileceği bir adrese sahip olur.
• Bağlantı kurulduğunda 11 olayın tamamı için tetikleyici oluşturulur. Olayları tek tek açıp kapatmaya yarayan bir ayar yoktur. Bir otomasyon oluşturun, RevenueCat olayını seçin ve otomasyon henüz Taslak durumundayken bir test gönderin. Eşleşen bir olay geldiğinde yalnızca durumu Yayında olan otomasyonlar çalışır.

Brew şu 11 olay türünü destekler:

• INITIAL_PURCHASE
• RENEWAL
• NON_RENEWING_PURCHASE
• PRODUCT_CHANGE
• CANCELLATION
• UNCANCELLATION
• EXPIRATION
• BILLING_ISSUE
• SUBSCRIPTION_PAUSED
• SUBSCRIPTION_EXTENDED
• TRANSFER

Brew alıcıyı önce $email abone özelliğinden okur; bu yoksa yedek olarak, e-posta adresi biçiminde olmaları koşuluyla uygulama kullanıcı kimliğini (app user ID), orijinal uygulama kullanıcı kimliğini veya bir takma adı (alias) kabul eder. RevenueCat takma adları uygulama kullanıcı kimliği geçmişidir; bu yüzden onlara güvenmek yerine $email özelliğini açıkça ayarlayın. Bu alanların hiçbirinde gerçek bir adres yoksa Brew olayı alıcısı belirlenemeyen bir olay olarak kaydeder, kişi oluşturmaz ve otomasyon başlatmaz.

Gerçek bir e-posta adresi taşıyan her doğrulanmış olay, bir otomasyon o olayı kullansın ya da kullanmasın, e-posta adresine göre eşleştirilen bir Brew kişisi oluşturur veya mevcut kişiyi günceller. İlgili veriler varsa Brew revenuecat_app_user_id, revenuecat_store ve revenuecat_environment alanlarını doldurur.

Yaşam döngüsü olayları revenuecat_subscription_status alanını active, cancelled, expired, billing_issue veya pause_scheduled olarak ayarlar. Olay bu değerleri sağladığında Brew revenuecat_product_id, revenuecat_cancel_reason, revenuecat_expiration_reason, revenuecat_last_purchase_at ve revenuecat_pending_product_id alanlarını da saklar.

Birleştirme etiketleri için seçilen olayın tanımlanan payload şemasını kullanın. Her olayda email, productId, priceUsd, pricePurchaseCurrency, currency, store, environment ve createdAt alanları (varsa) bulunur. priceUsd alanı USD cinsinden fiyatı, pricePurchaseCurrency alanı ise currency alanında belirtilen para birimindeki fiyatı içerir. RevenueCat payload verilerinden Brew ad veya soyad alamaz.

store alanının değeri (ör. APP_STORE veya PLAY_STORE) RevenueCat’ten olduğu gibi aktarılır ve RevenueCat yeni değerler ekleyebilir. Koşullarınızda yalnızca ilgilendiğiniz değerleri eşleştirin.

Bir satın alma, pazarlama e-postası için izin anlamına gelmez. İzni ayrıca kayıt altına alın ve tanıtım amaçlı gönderimlerden önce kontrol edin.

RevenueCat, TRANSFER olayını uygulama kullanıcı kimlikleriyle ama alıcı e-posta adresi olmadan gönderir. Brew bu olayı alıcısı belirlenemeyen bir olay olarak kaydeder ve otomasyon başlatmaz.

Bir olayın alınması ile e-posta gönderilmesi ayrı adımlardır. Eşleşen bir otomasyonun yayında olduğunu doğrulayın, ardından filtrelerini, çalıştırma geçmişini, alıcının uygunluğunu ve gönderim alan adını kontrol edin. TEST teslimi hiçbir zaman otomasyon başlatmaz. Alıcı belirlenemediğinde önce $email özelliğini kontrol edin; Brew, e-posta adresi biçiminde oldukları sürece uygulama kullanıcı kimliklerini, orijinal uygulama kullanıcı kimliklerini ve takma adları da kabul eder.

• Brew erişim hakkı tanımlayamaz veya geri alamaz; iade yapamaz ya da abonelikleri değiştiremez.
• İmza başlığının eksik olduğu bir 401 hatası genellikle HMAC imzalamanın kapalı olduğu ya da imzalama anahtarı yerine Authorization değerinin yapıştırıldığı anlamına gelir. HMAC imzalamayı açın, yeni anahtarı kopyalayın ve yeniden bağlanın.
• HMAC uyuşmazlığı içeren bir 401 hatası, Brew içinde farklı veya eskimiş bir anahtar kayıtlı olduğu anlamına gelir. RevenueCat’te anahtarı yenilemek eskisini geçersiz kılar; bu yüzden yeni değeri kopyalayın ve Brew içinde yeniden bağlanın.
• Hiç webhook gelmiyorsa RevenueCat planınızın webhookları kapsadığını kontrol edin.
• Her e-postanın izin durumunu ve amacını gözden geçirin. Aboneleri senkronize etmek, tanıtım amaçlı gönderimler için izin vermez.

• RevenueCat kurulum rehberi
• Otomasyon oluşturun
• Birleştirme etiketleri
• Brew ile neler gönderebilirsiniz
• RevenueCat webhookları
• RevenueCat müşteri özellikleri