Probleemoplossing

Sandbox-transacties testen voordat je live gaat

Je kunt Insert Affiliate volledig testen in de volgende omgevingen:

  • Lokale builds
  • TestFlight
  • Interne of gesloten testtracks van Google Play

Attributie en aankopen werken in al deze omgevingen en verschijnen op je Insert Affiliate-dashboard.

Als je RevenueCat gebruikt, worden sandbox-transacties duidelijk als zodanig gelabeld.

Een test-affiliate aanmaken

Je kunt eenvoudig test-affiliateaccounts aanmaken met e-mailaliassen.

Voorbeeld: als je e-mailadres [email protected] is

Kun je [email protected] gebruiken

Debughandleiding

Uitgebreide logging (verbose)

Uitgebreide logging is een optionele instelling in onze SDK's die extra diagnostische informatie weergeeft.

Schakel dit in wanneer je problemen met je integratie onderzoekt.

De transacties van mijn affiliates verschijnen niet

Volg deze debugstappen in volgorde. Ga pas verder als je hebt bevestigd dat de vorige stap werkt.

Zo kun je nagaan of het probleem bij Insert Affiliate ligt of bij je deeplinkprovider.

  1. Bouw in je app een manier om handmatig een shortcode in te voeren vóór de checkout.

  2. Draai de app lokaal, via TestFlight of via de interne/gesloten tests van Google Play.

  3. Voer de shortcode van je test-affiliate in (bijv. [email protected]).

  4. Controleer in je logs of de shortcode is ontvangen.

  5. Doe een aankoop en controleer of die op je Insert Affiliate-dashboard verschijnt.

Als attributie via shortcode werkt maar deeplinking niet → ligt het probleem bij je deeplinkintegratie.

Je deeplinkintegratie controleren

Gebruik uitgebreide logging om elke stap te bevestigen.

  1. Log de link die de app bij het opstarten ontvangt.

    • Controleer of deze overeenkomt met wat je verwacht.
    • Zo niet, raadpleeg dan de documentatie van je deeplinkprovider.

  2. Log, nadat je de link aan onze SDK hebt doorgegeven, de opgeslagen shortcode van de affiliate.

    • Deze moet overeenkomen met de shortcode die op je dashboard staat.

Als al het bovenstaande werkt, is je deeplinking in orde.

Je probleem zit dan in het doorgeven van de affiliate-identifier aan je platform voor aankoop-/receiptverificatie (bijv. RevenueCat).

Mijn integratie werkt, maar alleen als de app al is geïnstalleerd

Als attributie alleen werkt bij nieuwe installaties, is het probleem bijna altijd een van de volgende:

1. Deeplinking is niet goed ingesteld

Log de link die de app ontvangt nadat deze via de app store is geïnstalleerd vanuit een aangeklikte link.

Als dit correct wordt gelogd, ga dan verder met stap 2.

2. Je gebruikt de callback "Short Code Set" niet

Onze SDK's bieden een callback die wordt aangeroepen zodra een shortcode is opgeslagen.

Je moet deze gebruiken om de affiliate-identifier door te sturen naar je platform voor receiptverificatie (bijv. RevenueCat).

Mijn deeplinking werkt, maar transacties worden nog steeds niet bijgehouden

Als je de link kunt zien, de juiste shortcode kunt ophalen en de attributie correct lijkt, maar er geen transacties verschijnen, controleer dan:

1. Attributietime-out

Als je een attributietime-out hebt ingesteld, is die mogelijk verlopen.

Verwijder deze tijdens het testen en valideer opnieuw.

2. Affiliateoverdracht voorkomen

Als je Affiliateoverdracht voorkomen hebt ingeschakeld, overschrijven nieuwe affiliatelinks de bestaande attributie niet.

Wis tijdens het testen de opslag van de app of installeer de app opnieuw om de attributie te resetten.

3. De shortcode van de affiliate wordt niet doorgegeven aan je receiptverificatiesysteem

Afhankelijk van je setup (RevenueCat, Iaptic, rechtstreeks StoreKit / Play Billing) moet je de shortcode doorgeven tijdens de aankoop of de receiptvalidatie.

Bekijk de ReadMe van de SDK op GitHub en de documentatie van het aankoopplatform dat je hebt gekozen.

Als je RevenueCat gebruikt voor receiptvalidatie, zijn de volgende stappen verplicht. Ontbreekt er één, dan ontvangt Insert Affiliate geen aankoopevents, zelfs als deeplinking en attributie via shortcode correct werken.

1. RevenueCat-webhook naar Insert Affiliate (verplicht voor alle SDK's)

Je moet RevenueCat zo instellen dat het aankoopevents via een webhook naar Insert Affiliate stuurt.

2. Webhook instellen

Ga naar RevenueCat en maak een nieuwe webhook aan:

  • Stel de webhook in met deze instellingen:
    • Webhook URL: https://api.insertaffiliate.com/v1/api/revenuecat-webhook
    • Authorization header: Gebruik de waarde uit je Insert Affiliate-dashboard (die krijg je in stap 4)
    • Zet "Event Type" op "All events"

3. In de instellingen van je Insert Affiliate-dashboard:

  • Ga naar de verificatie-instellingen (tabblad Integraties)
  • Stel de verificatiemethode voor in-app-aankopen in op RevenueCat

Terug in je Insert Affiliate-dashboard:

4. Zoek de waarde van de authenticatieheader voor de RevenueCat-webhook

  • Kopieer deze waarde
  • Plak deze als waarde van de Authorization header in de configuratie van je RevenueCat-webhook
Instellingen voor aankoopverificatie met RevenueCat geselecteerd, met de webhook-URL en de te kopiëren waarde van de authenticatieheader voor de RevenueCat-webhook

Klik om op volledige grootte te bekijken

Servermeldingen van App Store / Play Store

RevenueCat heeft server-naar-servermeldingen van de App Store of Play Store nodig om updates over abonnementen en aankopen door te geven.

Zorg dat je het volgende hebt ingesteld:

  • Apple App Store Server Notifications
  • Google Play Real-Time Developer Notifications (RTDN)

Bekijk de documentatie over Server Notifications van RevenueCat →

Zonder deze meldingen ontvangt RevenueCat geen volledige of tijdige aankoopgegevens, en Insert Affiliate dus ook niet.

5. Controleer het Insert Affiliate-attribuut in RevenueCat

  1. Open een aankoop in je RevenueCat-dashboard.

  2. Zoek op de detailpagina van de transactie het paneel Attributes aan de rechterkant.

  3. Je zou het volgende moeten zien: insert_affiliate: <affiliate_short_code>

Als dit attribuut aanwezig en correct is → ontvangt RevenueCat de affiliatecode goed.

Als het ontbreekt → wordt de shortcode niet doorgegeven aan RevenueCat.

  • Dit betekent dat het probleem vóór RevenueCat ligt (deeplink → app → SDK → attribuutstap).

Met deze ene controle weet je meteen of de fout zit in:

  • Deeplinking
  • Je Insert Affiliate SDK-integratie
  • Of je RevenueCat-setup

6. Als het attribuut bestaat maar je nog steeds geen verkopen ziet in Insert Affiliate

Als insert_affiliate zichtbaar is in RevenueCat maar de verkoop niet op je Insert Affiliate-dashboard verschijnt, is het probleem een van de volgende:

a) Webhook wordt niet aangeroepen of is verkeerd ingesteld

Controleer de webhook-URL nogmaals en zorg ervoor dat:

  • Deze actief is
  • Deze niet is gewijzigd
  • Er geen authenticatie/headers ontbreken

7. Als het attribuut ontbreekt

Als je het attribuut insert_affiliate niet ziet:

  • Deeplinking geeft mogelijk niet de juiste link door aan je app
  • De shortcode-callback wordt mogelijk niet afgehandeld
  • Je roept setAttributes van RevenueCat mogelijk niet op het juiste moment aan
  • De gebruiker is mogelijk niet geattribueerd voordat de aankoop plaatsvindt
  • Het attribuut wordt mogelijk ergens anders in je code overschreven

Ga verder met:

  • Deeplinking debuggen
  • Testen met een shortcode
  • SDK-callbacks controleren
  • Runtime-logs controleren om te bevestigen wanneer het attribuut wordt ingesteld

Als je Adapty gebruikt voor receiptvalidatie, zijn de volgende stappen verplicht. Ontbreekt er één, dan ontvangt Insert Affiliate geen aankoopevents, zelfs als deeplinking en attributie via shortcode correct werken.

1. Adapty-webhook naar Insert Affiliate (verplicht voor alle SDK's)

Je moet Adapty zo instellen dat het aankoopevents via een webhook naar Insert Affiliate stuurt.

2. Webhook instellen

  1. In je Insert Affiliate-dashboard:

    • Zet Verificatie van in-app-aankopen op Adapty
    • Kopieer de Adapty Webhook URL
    • Kopieer de waarde van de Adapty Webhook Authorization Header

  2. In het Adapty-dashboard:

    • Ga naar Integrations → Webhooks
    • Zet Production URL op de webhook-URL van Insert Affiliate
    • Zet Sandbox URL op dezelfde webhook-URL
    • Plak de waarde van de authorization header in Authorization header value
    • Schakel deze opties in:
      • Exclude historical events
      • Send attribution
      • Send trial price
      • Send user attributes
    • Sla de configuratie op

3. Controleer het Insert Affiliate-attribuut in Adapty

  1. Ga naar app.adapty.io/profiles/users

  2. Zoek en selecteer de gebruiker die de testaankoop heeft gedaan

  3. Zoek de sectie Custom attributes

  4. Je zou het volgende moeten zien: insert_affiliate met de indeling {SHORT_CODE}-{UUID}

    • Voorbeeld: SAVE20-a1b2c3d4-e5f6-7890-abcd-ef1234567890

Als dit attribuut aanwezig en correct is → ontvangt Adapty de affiliatecode goed.

Als het ontbreekt → wordt de shortcode niet doorgegeven aan Adapty.

  • Dit betekent dat het probleem vóór Adapty ligt (deeplink → app → SDK → updateProfile-stap).

Met deze ene controle weet je meteen of de fout zit in:

  • Deeplinking
  • Je Insert Affiliate SDK-integratie
  • Of je Adapty-setup

4. Als het attribuut bestaat maar je nog steeds geen verkopen ziet in Insert Affiliate

Als insert_affiliate zichtbaar is in Adapty maar de verkoop niet op je Insert Affiliate-dashboard verschijnt, is het probleem een van de volgende:

a) Webhook wordt niet aangeroepen of is verkeerd ingesteld

Controleer de webhookconfiguratie nogmaals en zorg ervoor dat:

  • Zowel Production URL als Sandbox URL correct zijn ingesteld
  • De waarde van de authorization header correct is
  • Send user attributes is ingeschakeld
  • De webhook is opgeslagen en actief is

b) Ontbrekende webhookopties

Zorg dat alle vereiste opties zijn ingeschakeld:

  • Exclude historical events
  • Send attribution
  • Send trial price
  • Send user attributes

5. Als het attribuut ontbreekt

Als je het attribuut insert_affiliate niet ziet:

  • Deeplinking geeft mogelijk niet de juiste link door aan je app
  • De shortcode-callback wordt mogelijk niet afgehandeld
  • Je roept Adapty.updateProfile mogelijk niet aan met de affiliate-identifier
  • De gebruiker is mogelijk niet geattribueerd voordat de aankoop plaatsvindt
  • Het attribuut wordt mogelijk ergens anders in je code overschreven

Ga verder met:

  • Deeplinking debuggen
  • Testen met een shortcode
  • SDK-callbacks controleren
  • Runtime-logs controleren om te bevestigen wanneer updateProfile wordt aangeroepen

Android: Install Referrer werkt niet tijdens het testen

Als je op Android de flow "app niet geïnstalleerd" test (uitgestelde deeplinking via Google Play Install Referrer) en de attributie na installatie niet wordt toegepast, is de meest voorkomende oorzaak een verouderde Google Play Store-sessie.

Het probleem

Als de Google Play Store al open staat op de pagina van je app en je via een affiliatelink opnieuw naar diezelfde pagina navigeert, negeert Google Play de referrer-parameter in de URL. Daardoor geeft de Install Referrer API lege gegevens terug en gaat de attributie verloren.

Dit gebeurt vaak tijdens het testen, omdat je dezelfde app herhaaldelijk installeert en verwijdert en de Play Store tussen pogingen door op die pagina open laat staan.

De oplossing

Vóór elke test van de flow "niet geïnstalleerd":

  1. Forceer het afsluiten van de Google Play Store: ga naar Instellingen → Apps → Google Play Store → Gedwongen stoppen, of voer adb shell am force-stop com.android.vending uit
  2. Verwijder de app
  3. Klik daarna op de affiliatelink en installeer

Zo verwerkt de Play Store de referrer-URL als een nieuwe navigatie, precies zoals echte gebruikers het ervaren: zij hebben de Play Store niet al open staan op de pagina van je app.

Belangrijk

Dit is alleen een testprobleem. Echte gebruikers die voor het eerst op een affiliatelink klikken, hebben de Play Store niet open staan op de pagina van je app, dus de referrer wordt correct vastgelegd.

Nog steeds leeg? Controleer of er werkaccounts op het testapparaat staan

Als de referrer bij elke installatie vanaf één bepaalde telefoon leeg is, controleer dan of op die telefoon een Google-account van werk of school is ingelogd (bijvoorbeeld een Google Workspace-account dat door je bedrijf wordt beheerd).

Als er een beheerd account op het apparaat staat, kan Google Play de referrer laten vallen, en dan geeft de Install Referrer API zijn organische placeholder terug in plaats van je affiliatecode. Dit gebeurt zelfs als een persoonlijk Gmail-account de installatie uitvoert, dus het actieve account in de Play Store wisselen lost het niet op.

Om dit te bevestigen, verwijder je de werkaccounts van het apparaat (Instellingen → Wachtwoorden en accounts), of gebruik je een telefoon met alleen een persoonlijk Gmail-account. Forceer daarna het stoppen van de Play Store, verwijder de app en klik opnieuw op de affiliatelink.

Google documenteert dit gedrag niet, maar ontwikkelaars melden het op grote schaal. Anders dan bij de verouderde Play Store-sessie hierboven kan dit ook echte gebruikers treffen die een werkaccount op hun persoonlijke telefoon hebben. Voor die gebruikers zijn shortcodes het alternatief.

Met Insert Links kan dat.

Bij andere providers moet je hun documentatie raadplegen.

  1. Tik op de affiliatelink terwijl de app niet is geïnstalleerd.

  2. Installeer de app niet wanneer je op de pagina in de app store komt.

  3. Installeer de app in plaats daarvan lokaal.

  4. Als je Insert Links-setup correct is, gedraagt de attributie zich precies zoals wanneer je via de app store had geïnstalleerd.