Free Basics

Linee guida tecniche

Sebbene la disponibilità degli smartphone sia in continua crescita in tutto il mondo, la maggior parte delle persone nei mercati emergenti usa ancora feature phone. Per garantire che Free Basics sia accessibile a tutti, la nostra attenzione è volta a fornire supporto per siti web mobile leggeri.

Dettagli

Per far sì che il tuo sito web venga visualizzato correttamente all'interno della piattaforma Free Basics e sia accessibile alle persone con tutti i tipi di telefoni e piani dati, deve soddisfare determinate condizioni tecniche create dal proxy di Free Basics. Nello specifico, i siti web mobile devono funzionare in assenza di:

  • JavaScript
  • iframe
  • Video e immagini ad alta definizione
  • Flash e applet Java

Qualora dovessimo rilevare che i siti web contengono uno qualsiasi dei suddetti elementi post-implementazione, li bloccheremo finché non potremo confermare che il contenuto è stato rimosso.

JavaScript

Per offrire un'esperienza in grado di funzionare su tutti i dispositivi, il tuo servizio deve rimanere funzionante e utile quando JavaScript è disabilitato. Ciò significa che i tuoi contenuti non devono fare affidamento su JavaScript per nessuna delle esperienze utente principali, in particolare per la navigazione o altre funzionalità chiave.

iframe

Negli iframe potrebbero esserci delle rimozioni, quindi assicurati che i tuoi contenuti non facciano affidamento su di essi. Consigliamo di evitare del tutto gli iframe, poiché tendono a peggiorare l'esperienza su mobile.

Video e immagini di grandi dimensioni

Per rispettare il basso consumo di dati per le persone che utilizzano Free Basics, evita risorse che consumano grandi quantità di dati come video e immagini ad alta definizione. Per fornire la migliore esperienza possibile potremmo dover modificare, e in alcuni casi non visualizzare, alcuni video e alcune immagini.

Flash e applet Java

Free Basics non supporta risorse Flash o applet Java. Se il tuo servizio si avvale di queste tecnologie, assicurati di implementare i fallback adeguati in modo che siano nascoste in modo appropriato e non influenzino la funzionalità del tuo sito.

Supporto HTTPS

Criptiamo le informazioni per Free Basics, dove possibile. Quando le persone usano l'app Free Basics per Android, il loro traffico è crittografato end-to-end a meno che tu non specifichi che il tuo servizio debba essere solo HTTP. Per il sito web di Free Basics in un browser mobile, usiamo un modello "a doppio certificato" per crittografare bi-direzionalmente il traffico tra il dispositivo di una persona e i nostri server. Se il tuo server supporta HTTPS, crittograferemo anche il traffico tra i nostri server e il tuo server. Anche se il tuo servizio non supporta ancora HTTPS, laddove possibile crittograferemo queste informazioni tra i nostri server e i dispositivi delle persone, a meno che tu non ci chieda di non usare l'HTTPS con doppio certificato. Quando le persone usano il sito web mobile Free Basics, le informazioni vengono temporaneamente decrittografate sui nostri server sicuri per garantire la corretta funzionalità dei servizi ed evitare addebiti imprevisti.

Preserviamo la privacy di tali informazioni mentre vengono decrittografate memorizzando solo il nome del dominio del tuo servizio e la quantità di dati utilizzati, le stesse informazioni che sarebbero visibili utilizzando la crittografia end-to-end, nonché i cookie memorizzati in un formato crittografato e illeggibile.

Proxy di Internet.org

Dall'interno di Free Basics, tutto il traffico viene instradato attraverso il proxy di Internet.org. Lo facciamo per creare un flusso di traffico standard in modo che gli operatori possano identificare correttamente il tuo servizio e non applicare addebiti relativi ad esso. È importante comprendere che il tuo servizio non è né ospitato né memorizzato nella cache da Internet.org: si trova ancora sui tuoi server ed è interamente gestibile da te. Rilevando le richieste che passano attraverso la piattaforma Free Basics, puoi applicare controlli come il blocco geografico per i tuoi contenuti e/o misurare il traffico della piattaforma Free Basics.

Indirizzi IP

  • Ricorda che, a causa della crittografia SSL, l'app Free Basics per Android non supporta i campi dell'intestazione HTTP x-iorg-fbs-uip e x-iorg-fbs.

Dal momento che le richieste passano attraverso il proxy di Internet.org, l'indirizzo IP della richiesta HTTP proviene sempre dai nostri server e non dal richiedente originale. L'IP del richiedente originale è recuperabile dal campo dell'intestazione HTTP X-IORG-FBS-UIP (creato dal nostro proxy).

Inoltre, il nostro proxy segue la convenzione X-Forwarded-For, quindi lo stesso indirizzo IP sarà riportato anche in quel campo (come primo indirizzo IP non privato).

Rilevamento delle richieste

Tutte le richieste che passano attraverso il proxy di Internet.org contengono il campo X-IORG-FBS (sempre impostato su true). Basta controllare la sua esistenza all'interno dell'intestazione.

Inoltre, nel campo Via dell'intestazione è inserita la stringa Internet.org, metodo secondario per identificare le richieste passate attraverso il nostro proxy.

Tutte le richieste provenienti dall'app Android conterranno un valore unico di intestazione HTTP utente-agente (che dipende dalla versione dell'app). Un esempio di tale utente-agente è il seguente:

Mozilla/5.0 (Linux; Android 7.1.2; Pixel Build/N2G47E; wv) AppleWebKit/537.36 (KHTML, come Gecko) Version/4.0 Chrome/57.0.2987.132 Mobile Safari/537.36[FBAN/InternetOrgApp; FBAV/7.0;]

Per rilevare la richiesta, puoi controllare se la stringa contiene "InternetOrgApp"

Cookie

I cookie sono supportati.

Agente utente (stringa UA)

La stringa UA del richiedente originale non è alterata dal proxy di Internet.org.

Dati statistici e misurazione

Sul tuo sito puoi usare i servizi di tracciamento come Google Analytics, Effective Measure, Chartbeat ecc. Come già detto, il nostro ambiente web al momento non supporta JavaScript ed è importante esserne consapevoli, poiché molti servizi di analisi fanno affidamento su JavaScript per la loro piena funzionalità, sebbene la maggior parte fornisca una soluzione alternativa quando JavaScript non è disponibile. Consulta la documentazione dei servizi che utilizzi.

Google Analytics

Per facilitare l'uso di Google Analytics senza JavaScript all'interno della piattaforma Free Basics, di seguito sono riportate alcune linee guida sulla configurazione del tuo servizio.

Rilevamento del Paese

Per individuare correttamente il Paese dell'utente, devi compilare correttamente il parametro di override UIP per la richiesta di Google Analytics. Il modo più semplice per farlo è utilizzare il campo dell'intestazione HTTP X-IORG-FBS-UIP(vedi proxy di Internet.org). Il parametro UIP deve essere impostato lato server per la richiesta a Google Analytics.

Tracciamento senza JavaScript

Per effettuare l'analisi del traffico senza JavaScript, devi utilizzare il lato server del servizio.

Le richieste di Google Analytics possono essere gestite completamente tramite back-end e il server può occuparsi della gestione dei cookie (o di distinguere gli utenti in qualche altro modo). Puoi decidere quali parametri della richiesta compilare e usare per le analisi. Questo è possibile grazie al protocollo di misurazione di Google Analytics.

Se hai già una soluzione iframe, devi fare una richiesta POST lato server all'indirizzo di Google Analytics. La maggior parte dei parametri sarà coerente con quelli usati dalla soluzione iframe.

Test

Prima di inviare il tuo sito web per la valutazione, devi testarlo per verificare che soddisfi tutti i requisiti sopra riportati. Le seguenti risorse possono aiutarti con feedback in tempo reale del tuo livello di conformità.

Emulatore di dispositivi Chrome

Il browser Chrome può emulare un'esperienza mobile e ciò facilita notevolmente la maggior parte degli aspetti del test. Consigliamo di abilitare Device Emulation e di testare l'intero sito con:

Le istruzioni sono disponibili qui: https://developer.chrome.com/devtools/docs/device-mode

Emulatore di Opera

Opera fornisce un emulatore proprio che permette di eseguire test più specifici di come il tuo sito viene visualizzato e si comporta sul browser Opera Mini.

Le istruzioni sono disponibili qui: http://dev.opera.com/articles/installing-opera-mini-on-your-computer/