Integrazione affiliati RevenueCat: la guida completa.

Perché il webhook è la fonte di verità

Un programma di affiliazione paga soldi veri, quindi ciò che innesca la commissione deve essere qualcosa che né il dispositivo del cliente né il creator possano falsificare. Il webhook di RevenueCat ha esattamente le proprietà giuste:

• È server-to-server. Gli eventi partono dal backend di RevenueCat dopo che ha convalidato la transazione dello store sottostante. Nulla nel binario della tua app può contraffarne uno.

• Copre già entrambi gli store. Un solo webhook trasporta gli eventi di abbonamento iOS e Android in un unico formato, così al livello di affiliazione non importa da quale store arrivi la ricevuta.

• Trasporta i subscriber attribute. Questo è il cardine dell'intera integrazione: coppie chiave-valore arbitrarie impostate su un utente viaggiano con ogni evento che lo riguarda.

Su InfluTo questo è uno dei due percorsi di verifica supportati — l'altro è la convalida diretta App Store Server API / Google Play per le app senza RevenueCat. Ne scegli esattamente uno per app, mai entrambi: due fonti di verità per gli stessi soldi sono la ricetta per i bug di doppio conteggio.

Come l'attribuzione viaggia sul webhook

Passo per passo lungo la vita di un utente portato da un creator:

1. 1

   Il codice arriva all'SDK. Un creator condivide il suo codice. L'utente installa la tua app e il codice raggiunge l'SDK — digitato, o trasportato dal link referral.

2. 2

   L'SDK contrassegna l'utente in RevenueCat. L'SDK InfluTo lo scrive come subscriber attribute influto_code in RevenueCat. Da questo momento l'identità del creator viaggia con l'utente dentro RevenueCat stesso. I clic sul link del creator erano già stati deduplicati e segnalati per frode lato InfluTo; la corrispondenza del codice, però, è deterministica — niente fingerprinting, niente IDFA, niente prompt ATT.

3. 3

   Il webhook parte; la conversione viene creata. Quando l'utente si abbona, RevenueCat convalida la transazione dello store e invia il webhook. InfluTo legge influto_code dall'evento, abbina il creator e crea la conversione.

I tre eventi che contano

• INITIAL_PURCHASE. La prima transazione di abbonamento dell'utente. Crea la conversione e blocca la percentuale di commissione: la percentuale all'avvio dell'abbonamento vale per tutta la vita di quell'abbonato, così i cambi di commissione a metà campagna non riprezzano mai in silenzio gli abbonati esistenti di un creator. Un dettaglio critico: controlla il period type dell'evento. Anche l'avvio di una prova arriva come INITIAL_PURCHASE, e una prova non è ricavo — su di essa non matura alcuna commissione.

• RENEWAL. Il motore ricorrente. Ogni evento di rinnovo aggiunge un accumulo di commissione per il creator abbinato. È anche qui che un utente in prova diventa commissionabile: quando la prova converte a pagamento, compare la transazione a pagamento e la commissione parte. La regola che tiene tutto onesto è semplice — la commissione segue il denaro verificato, quindi i creator guadagnano sulle conversioni delle prove, mai sugli avvii delle prove. Questo significa anche che i creator non possono coltivare commissioni generando iscrizioni di prova usa e getta, il che protegge il tuo deposito e i tuoi dati.

• CANCELLATION. Il meccanismo di onestà. Rinnovo automatico disattivato significa che i rinnovi smettono di arrivare, e con loro si ferma l'accumulo. Un rimborso significa che è stato stornato denaro su cui ti era già stata addebitata una commissione — ed è per questo che InfluTo trattiene la commissione per la finestra di rimborso prima che diventi pagabile. Grazie alla trattenuta, un abbonamento rimborsato semplicemente non viene mai pagato; non rincorri un creator per soldi già usciti. (Gli eventi di scadenza chiudono il cerchio quando l'accesso termina davvero.)

Configurazione, in quattro passi

1. 1

   Installa l'SDK e imposta l'attributo. Swift, Kotlin, Flutter o React Native/Expo — open source su github.com/influto, circa 5 minuti. L'SDK si occupa di scrivere influto_code; tu gli passi solo il codice con cui è arrivato l'utente. Gli snippet esatti per piattaforma: docs.influ.to/integrations/revenuecat.

2. 2

   Aggiungi il webhook in RevenueCat. Nella dashboard RevenueCat, aggiungi InfluTo come integrazione webhook con il tuo URL endpoint e l'header di autorizzazione. RevenueCat supporta più integrazioni webhook per progetto, quindi i tuoi webhook esistenti continuano a funzionare intatti. Tratta l'header di autorizzazione come un segreto; InfluTo rifiuta gli eventi non autenticati, e puoi rigenerare il segreto se trapela.

3. 3

   Testa in sandbox. RevenueCat contrassegna ogni evento con il suo ambiente, quindi gli acquisti sandbox sono distinguibili da quelli in produzione. Avvia la tua app su un account store sandbox, applica un codice referral di test, completa un abbonamento sandbox e guarda comparire la conversione attribuita. Se hai collegato un agent AI via MCP, influto_integration_status riporta esattamente quali pezzi la piattaforma ha visto — attività dell'SDK, eventi webhook, conversioni di test attribuite — e influto_test_integration esegue il controllo dal vivo. Non saltarlo: un programma silenziosamente rotto il giorno del lancio brucia una fiducia dei creator che non recupererai.

4. 4

   Vai in produzione. Carica il portafoglio a garanzia (rimborsabile, via Stripe), crea la campagna, invita i creator. Da qui la pipeline è autonoma: gli eventi arrivano, la commissione matura, Stripe Connect paga i creator dal portafoglio con un minimo di 1 $. Configurazione gratuita, tariffa di piattaforma del 10% sulle commissioni.

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

Cosa non devi cambiare

Nulla della tua configurazione RevenueCat esistente si sposta. Entitlement, offering, paywall, i tuoi webhook e analytics attuali — tutto intatto. RevenueCat resta la tua fonte di verità sui ricavi; il livello di affiliazione è un subscriber attribute più un consumatore aggiuntivo del webhook. Se un giorno lo rimuovi, elimini l'integrazione webhook e le scritture dell'attributo, e il tuo stack di abbonamenti è esattamente com'era. Il riassunto più breve a livello di prodotto è nella pagina dell'integrazione RevenueCat, linkata qui sotto — e puoi configurarla gratis oggi stesso.