在應用程式中使用受信任的網路活動時,開發人員可能需要 整合到漸進式網頁應用程式 (PWA) 中
常見的用途是導入自訂分析區隔來評估安裝量 以及透過「受信任的網路活動」啟動的工作階段。你可以將查詢參數新增至啟動網址 以便實作這項功能
修改起始網址
如果傳遞至 PWA 的參數保持不變, 就會直接將參數附加至啟動網址。其中一個例子是 當開發人員想評估來自受信任網路的導覽工作階段數量時 活動。
使用 Bubblewrap
Bubblewrap 這項工具可協助開發人員為 可使用受信任網頁啟動現有 PWA 的 Android 應用程式 活動。其中包含程式庫和指令列介面 (CLI)。
建立新專案
使用 Bubblewrap CLI 時,您透過 init
指令初始化專案,然後
網路資訊清單的預設值,做為參數提供:
bubblewrap init --manifest https://material.money/manifest.json
精靈將預設使用網路資訊清單的 start_url,並要求使用者確認 值,讓開發人員有機會將額外參數加到 漸進式網頁應用程式。
修改現有專案
當 Bubblewrap 產生專案時,該特定專案的資訊會儲存在檔案中
twa-manifest.json
,位於專案資料夾中。如要修改現有專案的起始網址,請按照下列步驟操作:
必須修改這個檔案:
{
...
"startUrl": "/?utm_source=trusted-web-activity",
...
}
接著,請重新產生專案檔案,並套用新的起始網址
bubblewrap update
使用 Android Studio
使用 Android Studio 和預設的 LauncherActivity 時,startUrl 會定義為中繼標記 ,我們就能變更用來啟動受信任網路活動的網址,方法是 修改:
<activity android:name="com.google.androidbrowserhelper.trusted.LauncherActivity"
android:label="@string/app_name">
...
<meta-data android:name="android.support.customtabs.trusted.DEFAULT_URL"
android:value="https://svgomg.firebaseapp.com/?utm_source=trusted-web-activity" />
...
</activity>
動態修改起始網址
在其他情況下,開發人員可能想建立能在使用者或工作階段之間變化的參數,例如 執行個體。大多數情況下,您需要從 Android 裝置的 Android 端收集詳細資料 並傳遞給 Progressive Web App
步驟 1:建立自訂 LauncherActivity
public class CustomQueryStringLauncherActivity extends LauncherActivity {
private String getDynamicParameterValue() {
return String.valueOf((int)(Math.random() * 1000));
}
@Override
protected Uri getLaunchingUrl() {
// Get the original launch Url.
Uri uri = super.getLaunchingUrl();
// Get the value we want to use for the parameter value
String customParameterValue = getDynamicParameterValue();
// Append the extra parameter to the launch Url
return uri
.buildUpon()
.appendQueryParameter("my_parameter", customParameterValue)
.build();
}
}
步驟 2:修改 AndroidManifest.xml
,以便使用自訂 LauncherActivity
<activity android:name="com.myapp.CustomQueryStringLauncherActivity"
android:label="@string/app_name">
...
<meta-data android:name="android.support.customtabs.trusted.DEFAULT_URL"
android:value="https://squoosh.app/?utm_source=trusted-web-activity" />
...
</activity>
結論
您可以使用 查詢參數。您在查詢字串中加入參數後,指令碼就能存取該參數 而且當使用者瀏覽其他網頁時,也可能會列入推薦連結 開發人員會實作分享動作
開發人員必須瞭解這些影響,並可使用 link rel=noreferrer (使用 page location API 清理網址)。
「信任的網路活動」通訊協定目前並未提供交換訊息的機制 應用程式原生部分。
我們相信現有或即將推出的 Web Platform API 可以滿足開發人員所需的大部分使用情境。如果 如果想要尋找全新或即將推出的 Web API,請參閱新功能狀態頁面。