技術指南

雖然智慧型手機在世界各地越來越普及,但新興市場的多數人仍使用功能手機。為確保所有人都能使用 Free Basics,我們專注於支援輕量級行動版網站。

詳細資訊

為了讓您的網站能在 Free Basics 平台中正確顯示,並可供使用所有類型手機和資費方案的用戶存取,您的行動版網站必須符合 Free Basics 代理伺服器建立的特定技術條件。具體來說,行動版網站運作時不應使用下列項目:

  • JavaScript
  • iframe
  • 影片和高畫質圖像
  • Flash 及 Java Applet

如果發現網站實作中含有上述任何項目,我們會封鎖網站,直到確認內容已移除為止。

JavaScript

為了提供能夠跨裝置運作的體驗,您的服務在停用 JavaScript 時仍應保持功能性和實用性。這表示您的內容不應依賴 JavaScript 來提供任何核心用戶體驗,尤其是導覽或其他核心功能。

iframe

iframe 可能會受到部分限制,因此請確認您的內容並未倚賴 iframe。建議完全避免使用 iframe,因為這容易損害行動版體驗。

影片和大型圖像

為符合 Free Basics 用戶的低資料使用量需求,請避免影片和高畫質圖像等使用大量資料的資源。為了盡可能提供最佳體驗,我們可能必須修改,且在某些情況下不顯示部分影片和圖像。

Flash 及 Java Applet

Free Basics 不支援 Flash 資源或 Java Applet。如果您的服務使用這些技術,請務必實作適當的遞補,讓這些內容能適當隱藏,不會干擾網站的功能。

HTTPS 支援

我們盡可能加密 Free Basics 資訊。用戶使用 Free Basics Android 應用程式時,除非您指定服務應僅使用 HTTP,否則其流量會經過端對端加密。對於行動瀏覽器中的 Free Basics 網站,我們使用「雙重憑證」模式,在用戶裝置與我們伺服器之間雙向加密流量。如果您的伺服器支援 HTTPS,我們也會加密我們伺服器與您伺服器之間的流量。即使您的服務尚未支援 HTTPS,但除非您要求我們不要使用雙重憑證 HTTPS,否則我們還是會盡可能將我們伺服器與用戶裝置之間的資訊加密。當用戶使用 Free Basics 行動網站時,我們的安全伺服器會暫時解密資訊,以確保服務正常運作,同時避免意外向用戶收費。

我們在解密時保留該資訊的隱私,只儲存服務的網域名稱和所使用的資料量(這是使用端對端加密時可見的資訊),以及以加密和不可讀格式儲存的 Cookie。

Internet.org 代理伺服器

在 Free Basics 中,所有流量都透過 Internet.org Proxy 傳送。這麼做是為了建立標準流量流,方便電信業者正確識別您的服務並免於計費。請務必瞭解,您的服務並非由 Internet.org 代管或快取,服務仍是在您自己的伺服器上運作,且您擁有完全維護權,而藉由偵測透過 Free Basics 平台傳遞的要求,您可針對內容套用地理位置封鎖等控制功能,和/或衡量您的 Free Basics 平台流量。

IP 位址

  • 請注意,由於使用 SSL 加密,Free Basics Android 應用程式不支援 x-iorg-fbs-uip 和 x-iorg-fbs HTTP 標頭欄位。

由於要求需透過 Internet.org 代理伺服器傳遞,HTTP 要求 IP 位址一律會顯示來自我們的伺服器,而非原始要求者。您可以從 X-IORG-FBS-UIP HTTP 標頭欄位(由我們的 Proxy 建立)取得原始要求者 IP。

我們的 Proxy 也遵循 X-Forwarded-For 慣例,因此該欄位中也能找到相同的 IP 位址(第一個非私人 IP 位址)。

偵測要求

透過 Internet.org 代理伺服器傳遞的所有要求都會包含 X-IORG-FBS 欄位(一律設為 true)。在標頭中檢查其存在即已足夠。

除此之外,系統會將 Internet.org 插入 Via 標頭欄位,此備用方法可識別透過我們 Proxy 所傳遞的要求。

來自 Android 應用程式的所有要求都將包含不重複的用戶代理程式 HTTP 標頭值(視應用程式版本而定)。此類用戶代理程式的範例如下:

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

為了偵測要求,您可以檢查字串是否包含「InternetOrgApp」

Cookie

支援 Cookie。

用戶代理程式(UA 字串)

原始要求者的 UA 字串不會遭 Internet.org Proxy 變更。

分析和成效衡量

您可以在您的網站上使用追蹤服務,例如 Google Analytics、Effective Measure、Chartbeat 等。如上所述,我們的網路環境目前不支援 JavaScript,這點需要特別注意,因為許多分析服務依賴 JavaScript 才能提供完整功能(儘管多數服務在無法使用 JavaScript 時有備用方案)。請參閱您所使用之任何服務的說明文件。

Google Analytics(分析)

為了更容易在 Free Basics 平台內不使用 JavaScript 來操作 Google Analytics(分析),以下是關於設定服務的一些準則。

偵測國家/地區

為了正確偵測用戶的國家/地區,您需要正確填寫 Google Analytics(分析)要求的 UIP 覆寫參數。最簡單的方法是利用 X-IORG-FBS-UIP HTTP 標頭欄位(請參閱 Internet.org Proxy)。向 Google Analytics 發出要求時,必須在伺服器端設定 UIP 參數。

不使用 JavaScript 追蹤

若要不使用 JavaScript 執行流量分析,您需要利用服務的伺服器端。

Google Analytics(分析)要求可由後端完全管理,伺服器可以負責管理 Cookie(或以其他方式區分用戶)。您可以決定在要求中填入哪些參數並用於分析。這可以使用 Google Analytics Measurement Protocol 執行。

如果您已經有 iframe 解決方案,您需要在伺服器端向 Google Analytics 位址發出 POST 要求。大部分的參數會和 iframe 解決方案使用的參數一致。

測試

提交網站以供審查之前,您應該透過上述所有要求來測試網站。以下資源可協助您取得與整備度相關的即時意見回饋。

Chrome 裝置模擬器

Chrome 瀏覽器可以模擬行動體驗,對測試的大部分方面都能帶來很大的幫助。建議您開啟裝置模擬功能,並依照下列情況測試整個網站:

如需操作說明,請參閱:https://developer.chrome.com/devtools/docs/device-mode

Opera 模擬器

Opera 提供自己的模擬器,可針對您的網站在 Opera Mini 瀏覽器上的呈現和運作方式進行更詳細的測試。

如需操作說明,請參閱以下網址:http://dev.opera.com/articles/installing-opera-mini-on-your-computer/