# RevenueCat + Brew

Apple, Google, Amazon, Stripe ve Web Billing genelindeki RevenueCat uygulama içi satın alma, abonelik ve faturalandırma olaylarıyla Brew otomasyonlarını tetikleyin. RevenueCat Pro veya üzeri bir plan gerektirir.

Kanonik URL: https://brew.new/tr/browse/integrations/revenuecat

- Yön: Gelen veri
- Bağlantı: Webhook gizli anahtarı
- Uygulama içi satın alma + abonelik olayları

## Kullanıma açık özellikler

- **Olay tetikleyicileri**: Apple, Google, Amazon, Stripe ve Web Billing genelindeki RevenueCat uygulama içi satın alma, abonelik ve faturalandırma olaylarıyla Brew otomasyonlarını tetikleyin.

## Abonelik olaylarını işe yarar e-postalara dönüştürün

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.


## Neler oluşturabilirsiniz

- 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.

## İptal, erişimin sona erdiği anlamına gelmez

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’i Brew içinde kurun

- 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.

## Desteklenen RevenueCat olayları

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

## Kişi senkronizasyonu ve kişiselleştirme

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.


## TRANSFER olayıyla neden hiç e-posta gönderilmiyor?

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 görünüyor ama neden e-posta gönderilmiyor?

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.


## Sınırlar ve sorun giderme

- 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.

## Kaynaklar ve kurulum rehberleri

- [RevenueCat kurulum rehberi](https://docs.brew.new/integrations/import/revenuecat)
- [Otomasyon oluşturun](https://docs.brew.new/create-emails/build-an-automation)
- [Birleştirme etiketleri](https://docs.brew.new/create-emails/merge-tags)
- [Brew ile neler gönderebilirsiniz](https://docs.brew.new/get-started/what-you-can-send)
- [RevenueCat webhookları](https://www.revenuecat.com/docs/integrations/webhooks)
- [RevenueCat müşteri özellikleri](https://www.revenuecat.com/docs/customers/customer-attributes)

## İlgili sayfalar

- [Tüm entegrasyonlar](https://brew.new/tr/browse/integrations.md)
- [Kaydol](https://brew.new/tr/sign-up.md)
- Web sitesi: https://brew.new