이 페이지는 Cloud Translation API를 통해 번역되었습니다.

쿼리 매개변수를 사용하여 신뢰할 수 있는 웹 액티비티에 정보 전달

André Cipriani Bandarra

애플리케이션에서 신뢰할 수 있는 웹 활동을 사용하는 경우 개발자는 애플리케이션의 네이티브 부분을 프로그레시브 웹 앱 (PWA)에 전달할 수 있습니다.

일반적인 사용 사례는 맞춤 분석 세분화를 구현하여 설치를 측정하는 것입니다. 신뢰할 수 있는 웹 활동에서 시작된 세션입니다 실행 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 스튜디오 및 기본 LauncherActivity를 사용할 때 startUrl은 메타 태그로 정의됩니다. 신뢰할 수 있는 웹 활동을 시작하는 데 사용되는 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 수정

그 외의 경우에는 개발자가 사용자 또는 세션별로 변경되는 매개변수를 만들 수 있습니다. 인스턴스를 만들 수 있습니다 대부분의 경우 여기에는 프로그레시브 웹 앱으로 전달할 수 있습니다.

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을 정리합니다.

신뢰할 수 있는 웹 활동 프로토콜은 현재 애플리케이션의 네이티브 부분으로 구성됩니다.

기존 또는 출시 예정인 Web Platform API는 개발자가 필요로 하는 대부분의 사용 사례를 지원할 수 있다고 생각합니다. 만약 신규 또는 출시 예정인 웹 API를 찾고 있다면 새 기능 상태 페이지를 확인하세요.