RevenueCat affiliate integrace: kompletní návod.

Proč je webhook zdrojem pravdy

Affiliate program platí skutečné peníze, takže spouštěčem provize musí být něco, co nemůže zfalšovat ani klientské zařízení, ani tvůrce. Webhook RevenueCatu má přesně ty správné vlastnosti:

• Je server-to-server. Události vznikají na backendu RevenueCatu poté, co ověřil podkladovou transakci v obchodě. Nic ve vaší binárce je nedokáže padělat.

• Už pokrývá oba obchody. Jeden webhook nese iOS i Android události předplatného v jednom formátu, takže affiliate vrstvě je jedno, z kterého obchodu účtenka přišla.

• Nese subscriber atributy. To je pant celé integrace: libovolné páry klíč–hodnota, které uživateli nastavíte, cestují s každou událostí o tomto uživateli.

Na InfluTo je tohle jedna ze dvou podporovaných cest ověření — druhá je přímá validace App Store Server API / Google Play účtenek pro aplikace bez RevenueCatu. Na aplikaci vybíráte přesně jednu, nikdy obě: dva zdroje pravdy pro stejné peníze jsou recept na chyby s dvojím započítáním.

Jak atribuce jede na webhooku

Krok za krokem životem jednoho doporučeného uživatele:

1. 1

   Kód dorazí do SDK. Tvůrce sdílí svůj kód. Uživatel nainstaluje vaši aplikaci a kód se dostane do SDK — napsaný ručně, nebo nesený referral odkazem.

2. 2

   SDK označí uživatele v RevenueCatu. SDK InfluTo ho zapíše jako subscriber atribut influto_code v RevenueCatu. Od této chvíle cestuje identita tvůrce s uživatelem uvnitř samotného RevenueCatu. Kliky na odkaz tvůrce už byly na straně InfluTo deduplikované a označené proti podvodům; shoda kódu je ale deterministická — žádný fingerprinting, žádné IDFA, žádný ATT dialog.

3. 3

   Webhook vystřelí; konverze se vytvoří. Když se uživatel předplatí, RevenueCat ověří transakci v obchodě a vystřelí webhook. InfluTo přečte z události influto_code, spáruje tvůrce a vytvoří konverzi.

Tři události, na kterých záleží

• INITIAL_PURCHASE. První transakce předplatného daného uživatele. Vytvoří konverzi a uzamkne sazbu provize: sazba při startu předplatného platí po celý život tohoto předplatitele, takže změny sazeb uprostřed kampaně nikdy potichu nepřecení existující předplatitele tvůrce. Jeden kritický detail: kontrolujte period type události. Start trialu přichází také jako INITIAL_PURCHASE — a trial není tržba, žádná provize se z něj nenačítá.

• RENEWAL. Motor opakování. Každá událost obnovení přidá spárovanému tvůrci jeden přírůstek provize. Tady se také uživatel na trialu stává provizním: když trial zkonvertuje na placené, objeví se placená transakce a provize začne. Pravidlo, které drží všechno poctivé, je jednoduché — provize následuje ověřené peníze, takže tvůrci vydělávají na konverzích trialů, nikdy na jejich startech. To také znamená, že tvůrci nemůžou farmit provizi náborem jednorázových trial registrací — což chrání váš escrow i vaše data.

• CANCELLATION. Mechanismus poctivosti. Vypnuté automatické obnovení znamená, že obnovení přestanou chodit — a s nimi se zastaví načítání. Refundace znamená, že peníze, z nichž se počítala provize, se vrátily — proto InfluTo drží provizi přes okno pro vrácení peněz, než se stane splatnou. Díky zádržnému se refundované předplatné prostě nikdy nevyplatí; nehoníte tvůrce, aby vrátil peníze, které už odešly. (Události expirace uzavírají smyčku, když přístup skutečně skončí.)

Nastavení ve čtyřech krocích

1. 1

   Nainstalujte SDK a nastavte atribut. Swift, Kotlin, Flutter nebo React Native/Expo — open source na github.com/influto, asi 5 minut. Zápis influto_code řeší SDK; vy mu jen předáte kód, se kterým uživatel přišel. Přesné ukázky pro jednotlivé platformy: docs.influ.to/integrations/revenuecat.

2. 2

   Přidejte webhook v RevenueCatu. V RevenueCat dashboardu přidejte InfluTo jako webhook integraci s vaší endpoint URL a autorizační hlavičkou. RevenueCat podporuje více webhook integrací na projekt, takže vaše stávající webhooky poběží nedotčené. S autorizační hlavičkou zacházejte jako s tajemstvím; InfluTo odmítá neautentizované události a secret můžete v případě úniku rotovat.

3. 3

   Otestujte v sandboxu. RevenueCat označuje každou událost jejím prostředím, takže sandbox nákupy jsou odlišitelné od produkčních. Spusťte aplikaci proti sandbox účtu obchodu, použijte testovací referral kód, dokončete sandbox předplatné a sledujte, jak se objeví přiřazená konverze. Pokud jste připojili AI agenta přes MCP, influto_integration_status hlásí přesně, které kousky platforma viděla — aktivitu SDK, webhook události, přiřazené testovací konverze — a influto_test_integration spustí kontrolu živě. Nepřeskakujte to: program potichu rozbitý v den spuštění spálí důvěru tvůrců, kterou už nezískáte zpět.

4. 4

   Spusťte naostro. Dobijte escrow peněženku (vratná, přes Stripe), vytvořte kampaň, pozvěte tvůrce. Odtud je pipeline autonomní: události chodí, provize se načítá, Stripe Connect platí tvůrcům z peněženky s minimem 1 $. Nastavení zdarma, 10% platformový poplatek z provizí.

claude mcp add --transport http influto https://influ.to/mcp

Co měnit nemusíte

Nic z vašeho stávajícího nastavení RevenueCatu se nehýbe. Entitlementy, offeringy, paywally, vaše současné webhooky a analytika — vše nedotčené. RevenueCat zůstává vaším zdrojem pravdy o tržbách; affiliate vrstva je jeden subscriber atribut plus jeden další konzument webhooku. Pokud ji někdy odstraníte, smažete webhook integraci a zápisy atributu — a váš subscription stack je přesně takový, jaký byl. Kratší produktové shrnutí této integrace je na stránce funkce RevenueCat integrace, odkaz níže — a nastavit si ji můžete zdarma ještě dnes.