使用查詢參數將資訊傳送至受信任的網路活動

André Cipriani Bandarra

在應用程式中使用受信任的網路活動時，開發人員可能需要 整合到漸進式網頁應用程式 (PWA) 中

常見的用途是導入自訂分析區隔來評估安裝量 以及透過「受信任的網路活動」啟動的工作階段。你可以將查詢參數新增至啟動網址 以便實作這項功能

修改起始網址

如果傳遞至 PWA 的參數保持不變， 就會直接將參數附加至啟動網址。其中一個例子是 當開發人員想評估來自受信任網路的導覽工作階段數量時 活動。

使用 Bubblewrap

Bubblewrap 這項工具可協助開發人員為 可使用受信任網頁啟動現有 PWA 的 Android 應用程式 活動。其中包含程式庫和指令列介面 (CLI)。

建立新專案

使用 Bubblewrap CLI 時，您透過 init 指令初始化專案，然後 網路資訊清單的預設值，做為參數提供：

bubblewrap init --manifest https://material.money/manifest.json

精靈將預設使用網路資訊清單的 start_url，並要求使用者確認 值，讓開發人員有機會將額外參數加到 漸進式網頁應用程式。

顯示 Bubblewrap CLI 輸出內容

修改現有專案

當 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，請參閱新功能狀態頁面。