Unolink
Aan de slag

Problemen oplossen

Zet eerst debuglogs aan: die vertellen precies wat de SDK deed en waarom. Zie Debuglogs. Zoek naar de tag Unolink in Logcat, of [Unolink] in de Xcode-console.

Er verschijnt niets in het dashboard

  • Zet Testapparaten meetellen aan in Funnel of Trajecten. Debugbuilds zijn testapparaten en standaard verborgen.
  • Controleer of configure draait. Het moet één keer worden aangeroepen, vroeg: Application.onCreate() op Android, de init() van de @main App op iOS, de root-layout in React Native, main() in Flutter.
  • Verstuur de events nu. Events gaan elke 15 seconden de deur uit zolang de app open is, en als hij naar de achtergrond gaat. Druk op de thuisknop, of roep flush() aan.
  • Controleer het netwerk. Events wachten offline op het apparaat en worden verstuurd zodra er weer verbinding is.

"Invalid SDK key (401)"

De sleutel is fout, van een andere app, of ingetrokken. Kopieer hem opnieuw via je app → Instellingen → SDK-sleutels. Heb je hem niet bewaard toen je hem maakte, maak dan een nieuwe sleutel: de volledige sleutel wordt maar één keer getoond. Na een 401 wordt er niets verstuurd tot de volgende keer dat de app start.

"The SDK isn't included in this app's Unolink plan (403)"

De SDK hoort bij het Pro-abonnement en hoger. De eigenaar van de app moet upgraden onder Facturatie. Tot die tijd verstuurt de SDK niets en houdt hij niets in de wachtrij.

Sommige events ontbreken

  • Ongeldige naam. Eventnamen beginnen met een letter en bevatten alleen letters, cijfers, _ en ., maximaal 64 tekens. Ongeldige namen worden geweigerd en gelogd.
  • Te veel eigenschappen. Maximaal 20 per event, strings tot 200 tekens, 4 KB in totaal.
  • Ongeldige ID’s voor onboardingschermen. step en flow volgen dezelfde regel als eventnamen: how_heard, niet how-heard. In developmentbuilds geeft de React Native SDK (0.3.1 of later) een waarschuwing in de console.
  • Ver boven het maandelijkse tegoed. Bij je tegoed wordt niets geblokkeerd. Pas boven het dubbele van je tegoed worden je eigen (custom) events geweigerd, met quota_exceeded; de standaard funnelevents worden altijd vastgelegd.
  • Aangeroepen vóór configure. De native iOS- en Android-SDK’s negeren aanroepen die vóór configure worden gedaan. React Native (0.3.1 of later) bewaart ze en verstuurt ze direct daarna.
  • Tracking uitgezet. setEnabled(false) stopt de tracking en wordt onthouden tussen app-starts.

Aankopen of proefperiodes tellen dubbel, of helemaal niet

  • RevenueCat verbonden? Dan meldt RevenueCat proefperiodes en aankopen, en worden aanroepen van purchase en trialStarted vanuit de app genegeerd. Verwijder ze als je wilt; ze kunnen geen kwaad.
  • RevenueCat-aankopen worden niet aan de installatie gekoppeld? Meld de eigen app-gebruikers-ID van RevenueCat. Met SDK 0.3.2 of nieuwer houdt connectRevenueCat die actueel (zie RevenueCat). Roep anders setUserId ermee aan (Purchases.shared.appUserID, Purchases.sharedInstance.appUserID, Purchases.getAppUserID() of Purchases.appUserID) na Purchases.configure, na elke Purchases.logIn en Purchases.logOut, en bij elke start. Een aankoop die binnenkomt voordat de app zijn gebruiker heeft gemeld, wacht, en wordt gekoppeld zodra dat gebeurt. Elke gebruikers-ID die een installatie heeft gemeld telt mee, dus een gast die iets koopt en daarna een account maakt, houdt de aankoop. Meldt de app alleen de account-ID, dan wordt de aankoop van een gast alleen gekoppeld bij het volgende event van RevenueCat voor die klant (bijvoorbeeld de eerste verlenging). Zie Gasten en accounts.
  • Geen RevenueCat? Roep purchase aan met de prijs als decimaal getal en een valutacode van drie letters, nadat de store de aankoop heeft bevestigd.

Geen uitgestelde deep link

  • Op iPhone is dat normaal. Apple heeft geen install referrer, dus uitgestelde deep links zijn alleen voor Android.
  • Installeer via Google Play. Gesideloade installaties en installaties via Android Studio hebben geen Play-referrer. Gebruik interne tests, of debugInstallReferrer in een debugbuild. Zie Testen.
  • Alleen bij de eerste keer openen. De referrer wordt één keer per installatie gelezen. Verwijder de app, of wis de opslag ervan, om opnieuw te testen.
  • Stel een deeplink in op de link. In het dashboard: Links → ⋯ → Bewerken → Deeplink. Een link zonder deeplink schrijft de installatie nog steeds toe, maar er is niets om te openen.
  • Registreer de listener. Hij kan na configure worden toegevoegd: een link die eerder binnenkwam, wordt nog steeds afgeleverd. In React Native heb je daarvoor 0.3.1 of later nodig; met 0.3.0 abonneer je je direct na configure.
  • Zit het scherm achter de onboarding of het inloggen? De listener draait één keer per installatie. Lees na de onboarding getPendingDeferredDeepLink(), open de link en roep daarna consumeDeferredDeepLink() aan. Vanaf 0.3.3 wacht de link tot je hem als gebruikt markeert, ook als de app intussen wordt gesloten (tot 30 dagen). Zie Open hem na de onboarding.
  • Opent dezelfde link bij elke start? Roep consumeDeferredDeepLink() aan zodra je hem hebt geopend.

Een herinstallatie wordt niet aan de link toegeschreven

Elke klik wordt aan maar één installatie toegeschreven. Na een herinstallatie kan Google Play dezelfde referrer opnieuw aan de app geven, en die tweede installatie wordt niet nog een keer aan de link toegeschreven. Unolink gokt nooit.

React Native en Flutter

  • Expo Go werkt niet. De SDK bevat native code: maak een development build (npx expo prebuild of EAS Build).
  • "Native module not found" of MissingPluginException. Bouw de app opnieuw na de installatie. Een JavaScript-reload of een hot restart in Flutter laadt geen nieuwe native code.
  • iOS-build mislukt na de installatie. Voer pod install uit in de map ios (kale React Native) en bouw dan opnieuw.

Kom je er nog steeds niet uit?

Mail [email protected] met de naam van je app, het platform, de SDK-versie en de debuglog van één keer starten van de app.