# RevenueCat + Brew

Spouštěj automatizace v Brew pomocí událostí nákupů v aplikaci, předplatného a fakturace ze služby RevenueCat napříč platformami Apple, Google, Amazon, Stripe a Web Billing. Vyžaduje tarif RevenueCat Pro nebo vyšší.

Kanonická URL: https://brew.new/cs/browse/integrations/revenuecat

- Směr: Příchozí data
- Připojení: Tajemství webhooku
- Nákupy v aplikaci a předplatné

## Dostupné funkce

- **Spouštěče událostí**: Spouštěj automatizace v Brew pomocí událostí nákupů v aplikaci, předplatného a fakturace ze služby RevenueCat napříč platformami Apple, Google, Amazon, Stripe a Web Billing.

## Udělej z událostí předplatného užitečné e-maily

Připoj RevenueCat a spouštěj e-maily v duchu značky, když v tvé aplikaci někdo nakoupí, prodlouží či zruší předplatné nebo narazí na problém s platbou. Brew podporuje 11 událostí životního cyklu ze služby RevenueCat a jedna sekvence může obsloužit předplatitele ze všech platforem: App Store, Google Play, Amazon, Stripe i Web Billing.

Nákupy, prodlužování předplatného, refundace a přístupová práva (entitlements) mají dál na starosti RevenueCat a obchody s aplikacemi. Brew e-maily vytváří a posílá.


## Co můžeš vytvořit

- Uvítací e-maily pro předplatitele: událost INITIAL_PURCHASE nastane, když začne nové předplatné, a to i při zahájení zkušební verze. Jednorázové nákupy místo toho dorazí jako NON_RENEWING_PURCHASE.
- Potvrzení o platbě za prodloužení: událost RENEWAL nastane, když se předplatné prodlouží nebo když si ho bývalý předplatitel znovu pořídí, a obsahuje pole productId, priceUsd, pricePurchaseCurrency a currency.
- Upozornění na problém s platbou: událost BILLING_ISSUE nastane, když platba selže. Odkaž na místo, kde si předplatitel aktualizuje platební metodu.
- Navazující e-maily po zrušení: událost CANCELLATION obsahuje pole cancelReason, takže e-mail může na refundaci nebo chybu platby reagovat jinak než na zrušení ze strany předplatitele.
- Uvítací e-maily po návratu: událost UNCANCELLATION nastane, když předplatitel zrušené předplatné obnoví ještě předtím, než vyprší.
- Reaktivace po konci přístupu: událost EXPIRATION nastane, když předplatné skutečně skončí, a obsahuje pole expirationReason.
- Oznámení o změně tarifu: událost PRODUCT_CHANGE obsahuje pole previousProductId a newProductId. Nový produkt může začít platit až později, takže e-mail formuluj jako požadovanou změnu.
- Oznámení o pozastavení a prodloužení období: událost SUBSCRIPTION_PAUSED nastane, když je předplatné z Google Play naplánované k pozastavení na konci svého období. Událost SUBSCRIPTION_EXTENDED nastane, když obchod období prodlouží nebo když Google Play odloží platbu.

## Zrušení neznamená konec přístupu

Událost CANCELLATION může znamenat zrušené předplatné i refundaci a sama o sobě neznamená, že přístup skončil. Konec přístupu hlásí až událost EXPIRATION. Událost SUBSCRIPTION_PAUSED jen naplánuje budoucí pozastavení.

Událost CANCELLATION použij pro e-maily na znovuzískání zákazníků nebo s průzkumem důvodů odchodu a EXPIRATION pro všechno, co počítá s tím, že přístup už skončil. Událost UNCANCELLATION nezastaví běh, který už zrušení spustilo, a proto před každý další e-mail přidej podmínku na revenuecat_subscription_status.

Filtruj podle pole environment, aby se události SANDBOX nedostaly do aktivních automatizací.


## Nastavení RevenueCat v Brew

- Webhooky RevenueCat vyžadují tarif RevenueCat Pro nebo vyšší.
- Otevři Integrace, vyber RevenueCat a klikni na Vygenerovat URL webhooku.
- Ve službě RevenueCat otevři Integrations > Webhooks a přidej konfiguraci. Vlož URL z Brew, zvol Production, Sandbox nebo obojí a vyber události životního cyklu, které se mají posílat.
- V této konfiguraci zapni podepisování webhooků pomocí HMAC a hned zkopíruj podpisové tajemství. RevenueCat ho ukáže jen jednou. Vlož ho do Brew a klikni na Připojit. Nevkládej REST API klíč RevenueCat ani hodnotu nepovinné hlavičky Authorization.
- Pošli ze služby RevenueCat testovací webhook. Podepsané doručení TEST aktivuje připojení, ale nikdy nespustí žádnou automatizaci pro zákazníky.
- U každého zákazníka nastav atribut předplatitele $email, aby měl Brew kam e-maily posílat.
- Po kliknutí na Připojit vzniknou spouštěče pro všech 11 událostí. Jednotlivé události nejde zapnout ani vypnout. Vytvoř automatizaci, vyber pro ni událost ze služby RevenueCat a pošli test, dokud je to ještě koncept. Když dorazí odpovídající událost, spustí se jen aktivní automatizace.

## Podporované události RevenueCat

Brew podporuje těchto 11 typů událostí:

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

## Synchronizace kontaktů a personalizace

Brew čte příjemce nejdřív z atributu předplatitele $email a jako záložní možnost přijme i ID uživatele aplikace (app user ID), původní ID uživatele aplikace nebo alias, pokud mají tvar e-mailové adresy. Aliasy v RevenueCat jsou historie ID uživatele aplikace, takže na ně nespoléhej a $email nastav výslovně. Pokud v žádném z těchto polí není skutečná adresa, Brew událost zaznamená s nedohledaným příjemcem, nevytvoří žádný kontakt a nespustí žádnou automatizaci.

Každá ověřená událost se skutečnou e-mailovou adresou vytvoří nebo aktualizuje kontakt v Brew s touto adresou, a to bez ohledu na to, jestli událost používá nějaká automatizace. Pokud jsou data k dispozici, Brew nastaví revenuecat_app_user_id, revenuecat_store a revenuecat_environment.

Události životního cyklu nastaví revenuecat_subscription_status na active, cancelled, expired, billing_issue nebo pause_scheduled. Pokud je událost obsahuje, Brew uloží také revenuecat_product_id, revenuecat_cancel_reason, revenuecat_expiration_reason, revenuecat_last_purchase_at a revenuecat_pending_product_id.

Pro proměnné vycházej z deklarovaného schématu payloadu vybrané události. Každá událost obsahuje pole email, productId, priceUsd, pricePurchaseCurrency, currency, store, environment a createdAt, pokud jsou k dispozici. Pole priceUsd je cena v USD a pricePurchaseCurrency je cena v měně, kterou udává pole currency. Jméno ani příjmení Brew z payloadů RevenueCat nedostane.

Hodnotu pole store přebírá Brew beze změny ze služby RevenueCat (například APP_STORE nebo PLAY_STORE) a RevenueCat může přidávat nové hodnoty. Filtruj podle konkrétních hodnot, na kterých ti záleží.

Nákup neznamená souhlas s marketingovými e-maily. Souhlas zaznamenej zvlášť a před propagačními rozesílkami ho ověř.


## Proč po události TRANSFER nikdy neodejde e-mail?

RevenueCat posílá TRANSFER s ID uživatelů aplikace, ale bez e-mailu příjemce. Brew událost zaznamená s nedohledaným příjemcem a nespustí žádnou automatizaci.


## Proč se událost zobrazí, ale e-mail neodejde?

Přijetí události a odeslání e-mailu jsou samostatné kroky. Ověř, že odpovídající automatizace je aktivní, a pak projdi její filtry a historii běhů a zkontroluj, jestli má příjemce na e-mail nárok a jak je na tom odesílací doména. Doručení TEST nikdy nespustí žádnou automatizaci. Když se příjemce nepodaří dohledat, zkontroluj nejdřív $email; Brew přijímá i ID uživatelů aplikace, původní ID uživatelů aplikace a aliasy, pokud mají tvar e-mailové adresy.


## Omezení a řešení potíží

- Brew nemůže udělovat ani odebírat přístupová práva, vystavovat refundace ani měnit předplatná.
- Chyba 401 s chybějící hlavičkou podpisu obvykle znamená, že je podepisování HMAC vypnuté nebo že se místo podpisového tajemství vložila hodnota Authorization. Zapni podepisování HMAC, zkopíruj nové tajemství a připoj RevenueCat znovu.
- Chyba 401 s neshodou HMAC znamená, že Brew má jiné nebo zastaralé tajemství. Obměna tajemství ve službě RevenueCat to staré zneplatní, takže zkopíruj novou hodnotu a integraci v Brew znovu připoj.
- Pokud nedorazí vůbec žádné webhooky, ověř, že tvůj tarif RevenueCat webhooky zahrnuje.
- U každého e-mailu zkontroluj souhlas a účel. Synchronizace předplatitelů tě neopravňuje k propagačním rozesílkám.

## Zdroje a návody k nastavení

- [Návod k nastavení RevenueCat](https://docs.brew.new/integrations/import/revenuecat)
- [Vytvoř automatizaci](https://docs.brew.new/create-emails/build-an-automation)
- [Proměnné](https://docs.brew.new/create-emails/merge-tags)
- [Co můžeš posílat přes Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Webhooky RevenueCat](https://www.revenuecat.com/docs/integrations/webhooks)
- [Atributy zákazníků RevenueCat](https://www.revenuecat.com/docs/customers/customer-attributes)

## Související

- [Všechny integrace](https://brew.new/cs/browse/integrations.md)
- [Registrace](https://brew.new/cs/sign-up.md)
- Web: https://brew.new