RevenueCat regelt al de facturering van je abonnementen, en Insert Affiliate voegt daar affiliate-attributie aan toe. De integratie slaat één subscriber attribute op in RevenueCat en luistert naar je bestaande webhook-events, zodat je betaalflow precies blijft zoals hij is en commissies bij elke eerste aankoop en verlenging aan de juiste affiliate worden toegekend.
Insert Affiliate integreert met RevenueCat om abonnementsaankopen via affiliates te tracken en commissies automatisch te berekenen. De integratie werkt door een affiliate-identifier op te slaan als custom subscriber attribute in RevenueCat en vervolgens events uit de levenscyclus van abonnementen te ontvangen via webhooks. Deze handleiding behandelt elke stap van de setup.
Hoe de integratie werkt
De integratie tussen Insert Affiliate en RevenueCat bestaat uit drie onderdelen. Ten eerste legt de Insert Affiliate SDK een affiliate-identifier vast wanneer een gebruiker op een affiliatelink klikt of een shortcode invoert. Ten tweede schrijft je app die identifier naar RevenueCat als custom subscriber attribute. Ten derde stuurt RevenueCat webhook-events naar Insert Affiliate zodra er een abonnementsevent plaatsvindt, en Insert Affiliate leest het affiliate-attribuut uit de webhook-payload om de juiste affiliate te crediteren.
Stap 1: RevenueCat instellen
Als je nog geen RevenueCat-account hebt, maak er dan een aan op app.revenuecat.com/signup. Volg de projectsetup-handleiding van RevenueCat om je app te configureren, je App Store- en Google Play-gegevens te koppelen en je abonnementsproducten en offerings aan te maken.
Insert Affiliate raadt RevenueCat aan als de eenvoudigste integratie voor de meeste developers. Het verwerkt zowel iOS- als Android-abonnementen, biedt automatische webhook-notificaties en heeft een gratis tier beschikbaar.
Stap 2: Het Insert Affiliate-dashboard configureren
Stel in je Insert Affiliate-dashboard op app.insertaffiliate.com/settings de optie In-App Purchase Verification in op RevenueCat. Zo weet Insert Affiliate dat het RevenueCat webhook-events kan verwachten voor de verificatie van aankopen.
Stap 3: De Insert Affiliate SDK installeren
Insert Affiliate biedt SDK's voor iOS (Swift), Android, React Native, Flutter, JavaScript/Capacitor en Unity. Elke SDK is beschikbaar in de bijbehorende GitHub-repository onder de Insert-Affiliate-organisatie.
Installeer de SDK voor jouw platform en initialiseer deze met je bedrijfscode. In een React Native-app wrap je je app bijvoorbeeld in de DeepLinkIapProvider-component en roep je de initialize-functie aan met je bedrijfscode.
Stap 4: Het custom subscriber attribute instellen
Dit is de cruciale stap die affiliate-attributie koppelt aan RevenueCat-subscribers. Nadat de Insert Affiliate SDK een affiliate-identifier heeft vastgelegd, moet je deze naar RevenueCat schrijven als custom subscriber attribute met de key insert_affiliate.
In React Native ziet de code er zo uit:
const affiliateIdentifier = await returnInsertAffiliateIdentifier();
if (affiliateIdentifier) {
await Purchases.setAttributes({"insert_affiliate": affiliateIdentifier});
}De waarde heeft het formaat SHORT_CODE-UUID, bijvoorbeeld SAVE20-a1b2c3d4-e5f6-7890-abcd-ef1234567890. De shortcode identificeert de affiliate en de UUID zorgt ervoor dat elke attributie uniek is.
Je moet deze code op twee plekken aanroepen. Ten eerste direct nadat een deeplink of shortcode de affiliate-identifier heeft ingesteld. Ten tweede bij het starten van de app, zodat het attribuut gesynchroniseerd wordt als het in een eerdere sessie is ingesteld. RevenueCat synchroniseert attributen bij het starten van de app, wanneer de app naar de achtergrond gaat en bij aankopen, maar je kunt ook Purchases.syncAttributesAndOfferingsIfNeeded() aanroepen om direct een synchronisatie af te dwingen.
RevenueCat ondersteunt maximaal 50 custom attributes per subscriber, met keynamen van maximaal 40 tekens en waarden van maximaal 500 tekens.
Stap 5: RevenueCat-webhooks configureren
Ga in je RevenueCat-dashboard naar je projectinstellingen, dan naar Integrations en vervolgens naar Webhooks. Voeg een nieuwe webhook toe met de URL die je in de instellingen van je Insert Affiliate-dashboard vindt.
Configureer de webhook zo dat hij alleen events verstuurt voor de App Store (iOS) en Google Play Store (Android). Gebruik je ook RevenueCat Web Billing of Stripe, neem die eventbronnen dan niet op in deze webhook. Web- en Stripe-transacties worden apart getrackt via Stripe Connect om dubbele commissieregistraties te voorkomen.
De belangrijkste RevenueCat webhook-eventtypes die Insert Affiliate verwerkt zijn INITIAL_PURCHASE, dat wordt verstuurd wanneer een nieuw abonnement of een proefperiode begint, RENEWAL, dat wordt verstuurd wanneer een abonnement wordt verlengd of een proefperiode wordt omgezet naar betaald, CANCELLATION, dat wordt verstuurd wanneer een gebruiker opzegt, en EXPIRATION, dat wordt verstuurd wanneer de toegang moet worden ingetrokken.
Stap 6: Commissiepercentages instellen
Configureer in je Insert Affiliate-dashboard je commissiestructuur. Je hebt verschillende opties.
Stel onder Settings een algemeen standaard commissiepercentage in. Dit is het basispercentage dat alle affiliates ontvangen. Je kunt dit vervolgens overschrijven met individuele percentages per affiliate door een affiliate te selecteren en een aangepast commissiepercentage in te stellen.
Je kunt ook per affiliate de uitbetalingsfrequentie kiezen. Stel deze in op Initial Purchase plus Renewals als je wilt dat de affiliate commissie verdient op elke verlenging van de subscribers die hij heeft doorverwezen. Stel deze in op Initial Purchase Only als je een eenmalige uitbetaling per subscriber wilt.
Voor het aftrekken van platformkosten schakel je Deduct Platform Fees Before Commission in je instellingen in als je wilt dat commissies worden berekend over het nettobedrag nadat Apple of Google hun deel heeft ingehouden. Stel de percentages voor platformkosten in volgens je daadwerkelijke afspraken, of dat nu de standaard 30 procent is, het Small Business Program-tarief van 15 procent of de verlaagde tarieven van Google Play.
Hoe commissies worden berekend bij abonnementsevents
Wanneer RevenueCat een webhook naar Insert Affiliate stuurt, verwerkt het systeem deze als volgt. Het leest het eventtype om te bepalen of het om een eerste aankoop, een verlenging of een ander event gaat. Het haalt het custom attribute insert_affiliate uit de subscriberdata. Het zoekt de affiliate op die bij die identifier hoort. Het berekent de commissie op basis van het transactiebedrag en het ingestelde percentage van de affiliate, waarbij platformkosten worden afgetrokken als dat is ingeschakeld.
Bij een maandabonnement van 9.99 USD, een affiliatepercentage van 10 procent en ingeschakelde aftrek van platformkosten van 30 procent ziet de berekening er bijvoorbeeld zo uit: 9.99 USD min 3.00 USD storekosten is 6.99 USD netto, en 10 procent van 6.99 USD is 0.70 USD affiliatecommissie.
Als de uitbetalingsfrequentie verlengingen omvat, wordt deze commissie bij elk RENEWAL-event voor die subscriber gegenereerd, waardoor de affiliate doorlopende omzet ontvangt zolang de gebruiker geabonneerd blijft.
De integratie testen
Test de volledige flow met sandboxtransacties voordat je live gaat. Maak een testaffiliate aan in je Insert Affiliate-dashboard met een e-mailalias zoals [email protected]. Gebruik in je development build een shortcode om de affiliate-identifier in te stellen en doe daarna een sandboxaankoop.
RevenueCat-sandboxtransacties worden duidelijk gelabeld in het Insert Affiliate-dashboard, zodat je testaankopen kunt onderscheiden van productiedata. Controleer of de transactie verschijnt met de juiste affiliate-attributie en het juiste commissiebedrag.
Veelvoorkomende problemen oplossen
Als transacties niet in je dashboard verschijnen, controleer dan het volgende. Controleer of de webhook-URL in RevenueCat exact overeenkomt met de URL die Insert Affiliate heeft verstrekt. Bevestig dat het attribuut insert_affiliate wordt ingesteld voordat de aankoop plaatsvindt door de pagina met klantattributen van RevenueCat te bekijken voor de testsubscriber. Zorg ervoor dat In-App Purchase Verification in je Insert Affiliate-dashboard is ingesteld op RevenueCat.
Als de affiliate-identifier niet wordt vastgelegd, controleer dan of je deeplinking-platform correct is geconfigureerd en of de Insert Affiliate SDK is geïnitialiseerd voordat gebruikers met affiliatelinks of shortcodes aan de slag gaan.
Belangrijkste punten
Voor de integratie tussen Insert Affiliate en RevenueCat stel je een custom subscriber attribute met de naam insert_affiliate in op RevenueCat-subscribers, configureer je een webhook van RevenueCat naar Insert Affiliate en stel je je commissieregels in het Insert Affiliate-dashboard in. Zodra dit is geconfigureerd, trackt het systeem automatisch eerste aankopen, conversies van proefperiodes en verlengingen van abonnementen, en berekent en registreert het voor elk event de commissie. Tracking is volledig geautomatiseerd: commissies worden geregistreerd telkens wanneer er een webhook-event binnenkomt. Uitbetalingen verstuur je met één klik vanuit je Insert Affiliate-dashboard wanneer je er klaar voor bent.
Veelgestelde vragen
Hoe weet Insert Affiliate welke affiliate een subscriber heeft doorverwezen?
De Insert Affiliate SDK legt een affiliate-identifier vast wanneer een gebruiker op een affiliatelink tikt of een shortcode invoert. Je app schrijft die identifier naar RevenueCat als custom subscriber attribute (insert_affiliate). Wanneer er een abonnementsevent plaatsvindt, stuurt RevenueCat het attribuut mee in de webhook-payload en gebruikt Insert Affiliate het om de aankoop aan de juiste affiliate te koppelen.
Ondersteunt deze integratie gratis proefperiodes van RevenueCat? Ja. Insert Affiliate verwerkt het INITIAL_PURCHASE-event wanneer een proefperiode begint en het RENEWAL-event wanneer een proefperiode wordt omgezet naar een betaald abonnement. De commissie wordt geregistreerd op het moment van de betaalde conversie.
Kunnen affiliates terugkerende commissies verdienen op verlengingen van abonnementen? Ja. Stel de uitbetalingsfrequentie in op "Initial Purchase plus Renewals" en Insert Affiliate registreert een commissie bij elk RENEWAL-event zolang de subscriber actief blijft. Zo zijn affiliates gericht op retentie op de lange termijn, niet alleen op eerste aanmeldingen.
Heb ik een aparte webhook nodig voor Stripe- of RevenueCat Web Billing-transacties? Ja. Configureer deze webhook alleen voor events van de App Store (iOS) en Google Play Store (Android). Web- en Stripe-transacties worden apart getrackt via Stripe Connect om dubbele commissieregistraties te voorkomen.
Hoe worden commissies uitbetaald? Commissies worden automatisch getrackt en geregistreerd in je Insert Affiliate-dashboard. Wanneer je klaar bent om te betalen, verstuur je met één klik uitbetalingen naar je affiliates vanuit het dashboard.