Test

Esegui una build di debug, apri l’app una volta e controlla la dashboard. Questa pagina spiega cosa conta come dispositivo di test, come vederne i dati e come testare i deep link differiti senza pubblicare su Google Play.

Dispositivi di test

Un’installazione segnata come dispositivo di test invia dati reali, ma la dashboard la tiene fuori dai tuoi numeri finché non la chiedi. Così i tuoi test non gonfiano mai installazioni, conversioni o ricavi.

Anche un’installazione che fa un acquisto sandbox con RevenueCat (TestFlight, tester con licenza su Google Play) diventa un dispositivo di test, con tutto ciò che ha inviato.

I canali di test di Google Play (interno, chiuso, aperto) non si distinguono sul telefono dalla versione pubblicata sullo store. Segna tu queste build, ad esempio con una variabile al momento della build:

// React Native / Expo: set EXPO_PUBLIC_UNOLINK_TEST=1 only for testing-track builds
Unolink.configure("ulk_…", { debug: __DEV__ || process.env.EXPO_PUBLIC_UNOLINK_TEST === "1" })

Vedere i dati di test nella dashboard

Apri la tua app → Funnel o Percorsi e attiva Includi dispositivi di test. Le installazioni di test compaiono allora accanto a quelle reali. Disattivalo di nuovo prima di leggere i tuoi numeri reali.

Una prima apertura compare entro pochi secondi dall’avvio dell’app. Gli eventi vengono inviati in lotti ogni 15 secondi mentre l’app è aperta, e subito quando va in background: premi Home per inviarli adesso.

Log di debug

L’SDK resta silenzioso quando tutto funziona: per impostazione predefinita registra solo avvisi ed errori. Per vedere ogni passaggio, alza il livello di log.

// Android: Logcat, tag "Unolink"
Unolink.configure(this, "ulk_…", UnolinkOptions(logLevel = LogLevel.DEBUG))

// iOS: Xcode console, prefix "[Unolink]"
Unolink.configure(apiKey: "ulk_…", options: UnolinkOptions(logLevel: .debug, debug: true))

// React Native: Xcode console or Logcat, tag "Unolink"
Unolink.configure("ulk_…", { debug: __DEV__, logLevel: "debug" })

// Flutter: Xcode console or Logcat, tag "Unolink"
await Unolink.configure('ulk_…', debug: kDebugMode, logLevel: UnolinkLogLevel.debug);

Riportalo al valore predefinito prima del rilascio.

Simulare un referrer di installazione di Play (Android)

Google Play passa un referrer di installazione solo per installazioni reali da Google Play. Per testare il codice dei tuoi deep link differiti senza averne uno, dai a una build di debug Android nativa un referrer finto:

Unolink.configure(this, "ulk_…", UnolinkOptions(
    debugInstallReferrer = "unolink_click_id=clk_01JA0000000000000000000000&unolink_deep_link=%2Fpromo%2F3for2&unolink_p_offer=3for2",
))

• Viene usato solo nelle build debuggable. Le build di release lo ignorano e leggono il referrer reale.
• Viene letto solo al primo avvio, come quello reale. Disinstalla l’app, o cancellane i dati, prima di ogni prova.
• Il listener dei tuoi deep link differiti riceve deepLink = "/promo/3for2" e params = {offer=3for2} dal referrer. L’SDK registra un avviso che dice di aver usato il referrer simulato.
• L’installazione in sé non viene attribuita a un link, a meno che l’ID del clic non sia un clic reale su uno dei link della tua app.

Questa opzione fa parte dell’SDK Android nativo. In React Native e Flutter, testa con un’installazione reale come qui sotto.

Testare con un’installazione reale (Android)

1. Carica una build in Google Play Console → Test → Test interno e aggiungi te stesso come tester.
2. Sul telefono, disinstalla l’app, poi apri uno dei tuoi link Unolink e installa dalla scheda di Play che si apre.
3. Apri l’app. L’installazione viene attribuita a quel link, e il listener dei deep link viene eseguito se il link ha un deep link.

Altri dettagli in Deep link differiti su Android.

iPhone

Su iPhone installazioni ed eventi vengono contati, ma alla tua app non viene mai detto quale link è stato toccato: non c’è nessun deep link differito, perché Apple non ha un referrer di installazione e Unolink non fa mai fingerprinting. La dashboard abbina comunque le installazioni iPhone al loro link, senza fingerprinting. Quindi su iOS verifica che installazioni ed eventi arrivino. Non c’è nessun deep link da controllare nell’app.

Checklist

• La prima apertura compare in Percorsi con Includi dispositivi di test attivo.
• Ogni chiamata del funnel compare come passaggio su quell’installazione.
• Con RevenueCat: un acquisto sandbox compare sulla stessa installazione dopo setUserId.
• Android: un’installazione dal test interno di Play partita da un link mostra il link, e il deep link si apre.
• Le build di release sono configurate senza debug: true e con il livello di log predefinito.

Manca qualcosa? Vedi Risoluzione dei problemi.