このページは Cloud Translation API によって翻訳されました。

クエリパラメータを使用して信頼できるウェブアクティビティに情報を渡す

André Cipriani Bandarra

アプリで信頼できるウェブアクティビティを使用する際、デベロッパーはアプリケーションのネイティブ部分をプログレッシブウェブアプリ（PWA）に移行する。

一般的なユースケースは、カスタム分析セグメンテーションを実装してインストールを測定することです。 Trusted Web Activity で開始されたセッションをクエリパラメータを起動 URL に追加するこれを実装する必要があります

開始 URL の変更

PWA に渡されるパラメータが、このパラメータを起動 URL に直接追加できます。この使用例は信頼できるウェブページから作成されたナビゲーションセッションの数をデベロッパーが測定する場合アクティビティ。

バブルラップの使用

Bubblewrap は、デベロッパー向けのプロジェクトを作成するデベロッパーを支援するツールで信頼できるウェブを使用して既存の PWA を起動する Android アプリアクティビティ。ライブラリとコマンドラインインターフェース（CLI）の両方が含まれています。

新しいプロジェクトを作成する

Bubblewrap CLI を使用する場合、プロジェクトは init コマンドで初期化され、プロジェクトがウェブマニフェストのデフォルト値を次のように指定します。

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

ウィザードではウェブマニフェストの start_url をデフォルトとして使用し、ユーザーに確認を求めます。このパラメータにより、デベロッパーは、プログレッシブウェブアプリ

Bubblewrap CLI の出力を表示する

既存のプロジェクトの変更

Bubblewrap がプロジェクトを生成すると、そのプロジェクトの情報がファイルに保存される twa-manifest.json という名前の（プロジェクトフォルダ内）。既存のプロジェクトの開始 URL を変更するには、次の操作を行います。ファイルを変更する必要があります。

{
  ...
  "startUrl": "/?utm_source=trusted-web-activity",
  ...
}

次に、プロジェクトファイルを再生成して新しい開始 URL を適用する

bubblewrap update

Android Studio の使用

Android Studio とデフォルトの LauncherActivity を使用する場合、startUrl はメタタグとして定義される AndroidManifest.xml 内にあります。Trusted Web Activity の起動に使用する URL は、次のように変更します。

<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>

開始 URL の動的な変更

また、ユーザーまたはセッションによって変化するパラメータを作成し、作成します。ほとんどの場合は、Android 側から詳細情報を収集します。プログレッシブウェブアプリに渡します。

ステップ 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: カスタムの LauncherActivity を使用するように `AndroidManifest.xml` を変更する

<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 を使用して URL をクリーンアップします。

現在のところ、Trusted Web Activity プロトコルには、アプリケーションのネイティブ部分を呼び出します。

Google は、既存または今後のウェブプラットフォーム API によって、デベロッパーが必要とするほとんどのユースケースを実現できると考えています。条件新規または今後のウェブ API をお探しの場合は、新機能のステータスページをご確認ください。