Testen en sandboxmodus

Test je Insert Affiliate-integratie grondig voordat je live gaat. Deze handleiding behandelt sandboxtesten, het aanmaken van test-affiliates en het debuggen van je integratie.

Ondersteunde testomgevingen

Je kunt Insert Affiliate volledig testen in de volgende omgevingen:

  • Lokale builds: draai je app direct vanuit je ontwikkelomgeving
  • TestFlight (iOS): het bètatestplatform van Apple
  • Google Play Internal Testing: gesloten of interne testtracks
  • Google Play Closed Testing: bètatesten met een beperkt publiek

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

Labels voor sandboxtransacties

Als je RevenueCat gebruikt voor aankoopverificatie, worden sandboxtransacties in je dashboard duidelijk als zodanig gelabeld. Zo kun je testaankopen eenvoudig onderscheiden van echte aankopen.

Test-affiliates aanmaken

Je kunt eenvoudig test-affiliateaccounts aanmaken met e-mailaliassen. Zo kun je meerdere affiliates testen zonder meerdere e-mailaccounts nodig te hebben.

E-mailaliassen gebruiken

De meeste e-mailproviders ondersteunen de +-aliassyntaxis:

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

Kun je test-affiliates aanmaken met:

Alle e-mails worden afgeleverd in je hoofdinbox ([email protected]), maar Insert Affiliate behandelt elk adres als een apart affiliateaccount.

Een test-affiliate aanmaken

  1. Ga naar Affiliate aanmaken
  2. Selecteer "Create Affiliate (Admin)"
  3. Voer je test-e-mailadres in (bijv. [email protected])
  4. Maak een affiliate-deeplink aan en plak deze
  5. Klik op Create Affiliate
Formulier Een affiliate aanmaken in het Insert Affiliate-dashboard met de adminmodus geselecteerd en de shortcode van de affiliate zichtbaar

Klik om op volledige grootte te bekijken

Noteer de shortcode van de affiliate: die gebruik je om te testen.

Testmethoden

Er zijn twee belangrijke manieren om je integratie te testen:

Methode 1: testen met een shortcode (aanbevolen)

Testen met shortcodes is de snelste en meest betrouwbare manier om je integratie te verifiëren.

Waarom shortcodes?

Testen met een shortcode isoleert Insert Affiliate van je deeplinkplatform, zodat je:

  • de Insert Affiliate-integratie los kunt verifiëren
  • kunt testen zonder je bezig te houden met de complexiteit van deeplinking
  • snel kunt itereren tijdens de ontwikkeling
  • kunt vaststellen of problemen bij Insert Affiliate of bij deeplinking liggen

Zo test je met shortcodes

  1. Voeg shortcode-invoer toe aan je app: bouw een manier om shortcodes handmatig in te voeren (zie Shortcodes voor implementatiedetails)
  2. Schakel uitgebreide logging in: zet SDK-logging aan om te zien wat er gebeurt
  3. Start je app: open hem op een testapparaat of simulator
  4. Voer de shortcode in: vul de shortcode van je test-affiliate in
  5. Controleer de attributie: kijk in de logs of de shortcode is opgeslagen
  6. Doe een testaankoop: voltooi een sandboxtransactie
  7. Controleer je dashboard: verifieer dat de transactie verschijnt in Insert Affiliate

Resultaten interpreteren

✅ Als attributie werkt met shortcodes maar NIET met deeplinks:

  • Het probleem zit in de integratie van je deeplinkplatform
  • Insert Affiliate werkt correct
  • Richt je bij het debuggen op de afhandeling van deeplinks

❌ Als attributie niet werkt met shortcodes:

  • Het probleem zit in je Insert Affiliate-setup of je setup voor aankoopverificatie
  • Volg de handleiding Probleemoplossing

Zodra testen met een shortcode werkt, test je de volledige flow met deeplinks.

Deeplinks testen (app al geïnstalleerd)

  1. Bouw en installeer je app op een testapparaat
  2. Klik op de deeplink van een affiliate (stuur hem via e-mail, een bericht of een QR-code)
  3. De app moet openen met de identifier van de affiliate
  4. Controleer de attributie: kijk in de logs of de shortcode is opgeslagen
  5. Doe een testaankoop: voltooi een sandboxtransactie
  6. Controleer je dashboard: verifieer dat de transactie verschijnt

Deeplinks testen (app niet geïnstalleerd, "cold start")

Hiermee test je de volledige gebruikerservaring wanneer iemand op een affiliatelink klikt zonder dat je app is geïnstalleerd.

Standaardmethode:

  1. Verwijder je app van het testapparaat
  2. Klik op de affiliatelink: die moet je naar de App Store/Play Store brengen
  3. Installeer de app vanuit de store
  4. Open de app: attributie moet werken bij de eerste keer openen
  5. Doe een testaankoop: voltooi een sandboxtransactie
  6. Verifieer in het dashboard: controleer of de transactie verschijnt

Snellere methode (alleen Insert Links):

Als je Insert Links gebruikt, kun je cold-start-attributie testen zonder via de app store te gaan:

  1. Verwijder je app
  2. Tik op de affiliatelink: je komt op de App Store-pagina terecht
  3. Installeer niet vanuit de store: installeer in plaats daarvan lokaal vanuit Xcode/Android Studio
  4. Start de lokaal geïnstalleerde app
  5. Als Insert Links correct is ingesteld, werkt de attributie precies alsof de app vanuit de store is geïnstalleerd

Raadpleeg voor andere deeplinkplatforms hun documentatie over de mogelijkheden om cold starts te testen.

Sandboxaankopen

Sandboxtesten op iOS

Vereisten:

  • Sandbox-Apple ID (aangemaakt in App Store Connect)
  • Ingelogd met het sandboxaccount op het testapparaat
  • Testproducten ingesteld in App Store Connect

Stappen:

  1. Maak een sandboxtesteraccount aan in App Store Connect
  2. Log op je apparaat uit bij je gewone App Store-account
  3. Start je app en probeer een aankoop te doen
  4. Log in met je sandboxaccount wanneer daarom wordt gevraagd
  5. Voltooi de testaankoop (die is gratis)
  6. Verifieer dat de transactie verschijnt in je Insert Affiliate-dashboard

Let op: sandboxaankopen op iOS worden duidelijk gemarkeerd in je dashboard als je RevenueCat gebruikt.

Sandboxtesten op Android

Vereisten:

  • Licentietesteraccount toegevoegd in Google Play Console
  • Testproducten ingesteld
  • App geüpload naar de interne testtrack (hoeft niet te worden beoordeeld)

Stappen:

  1. Voeg je test-e-mailadres toe als licentietester in Google Play Console
  2. Installeer je app via de interne testtrack
  3. Doe een testaankoop (gebruik een testcreditcard, anders is de aankoop gratis)
  4. Voltooi de aankoop
  5. Verifieer dat de transactie verschijnt in je Insert Affiliate-dashboard

Je integratie debuggen

Uitgebreide logging inschakelen

Alle Insert Affiliate-SDK's ondersteunen uitgebreide logging (verbose logging). Schakel dit in je ontwikkelbuilds in om te zien:

  • wanneer deeplinks worden ontvangen
  • wanneer shortcodes worden opgeslagen
  • wanneer aankopen naar Insert Affiliate worden verstuurd
  • eventuele fouten of problemen

Raadpleeg de SDK-documentatie van je platform voor hoe je uitgebreide logging inschakelt.

Veelvoorkomende debugscenario's

Scenario 1: shortcodes werken, deeplinks niet

Diagnose: probleem met de integratie van het deeplinkplatform

Debugstappen:

  1. Log de deeplink-URL die je app bij het opstarten ontvangt
  2. Controleer of die overeenkomt met het formaat dat je deeplinkplatform verwacht
  3. Controleer of je de link doorgeeft aan de Insert Affiliate-SDK
  4. Bekijk de documentatie van je deeplinkplatform

Scenario 2: attributie werkt, aankopen verschijnen niet

Diagnose: probleem met de integratie van de aankoopverificatie

Debugstappen:

  1. Controleer de webhookconfiguratie (RevenueCat/Apphud/Iaptic)
  2. Controleer of de identifier van de affiliate wordt doorgegeven aan het aankoopplatform
  3. Voor RevenueCat: controleer of het attribuut insert_affiliate verschijnt in het RevenueCat-dashboard
  4. Bekijk de handleiding Probleemoplossing

Scenario 3: niets werkt

Diagnose: meerdere problemen of problemen met de setup

Debugstappen:

  1. Begin met de handleiding Snel aan de slag
  2. Controleer of de API key correct is bij het initialiseren van de SDK
  3. Controleer of de instellingen in het Insert Affiliate-dashboard zijn geconfigureerd
  4. Schakel uitgebreide logging in
  5. Test eerst met shortcodes
  6. Volg de volledige handleiding Probleemoplossing

Testchecklist

Gebruik deze checklist om grondig te testen vóór de lancering:

Basistesten van de integratie

  • Attributie via shortcode werkt
  • Sandboxaankopen verschijnen in het dashboard
  • Aankoopbedragen zijn correct
  • Uitgebreide logging toont geen fouten
  • Deeplinks openen de app wanneer die is geïnstalleerd
  • Deeplinks worden correct toegeschreven wanneer de app is geïnstalleerd
  • Attributie werkt bij de eerste keer openen na installatie
  • Cold-start-attributie werkt (link → store → installeren → openen)

Platformspecifieke testen

  • Getest op iOS (indien van toepassing)
  • Getest op Android (indien van toepassing)

Best practices

Tijdens de ontwikkeling

  1. Test altijd eerst met shortcodes: zo isoleer je problemen
  2. Gebruik ruim uitgebreide logging: zo vang je problemen vroeg op
  3. Test vaak: wacht niet tot het einde met het testen van de integratie
  4. Test op echte apparaten: simulators kunnen zich anders gedragen

Vóór de lancering

  1. Werk de testchecklist af: zorg dat alle scenario's zijn gedekt
  2. Test cold-start-attributie: cruciaal voor de gebruikerservaring
  3. Bekijk je dashboard: maak jezelf vertrouwd met de gegevens

Na de lancering

  1. Houd de eerste transacties in de gaten: verifieer dat alles werkt in productie
  2. Houd uitgebreide logging beschikbaar: gebruik debugbuilds als er problemen ontstaan

Hulp krijgen

Als je tijdens het testen problemen tegenkomt:

  1. Bekijk Probleemoplossing: een stapsgewijze debughandleiding
  2. Bekijk de platformdocumentatie: handleidingen voor deeplinking en aankoopverificatie
  3. Neem contact op met support: mail naar [email protected] of ga naar app.insertaffiliate.com/help

Volgende stappen

Zodra het testen klaar is: