Sorgu Parametrelerini Kullanarak Güvenilir Web Etkinliğine Bilgi Aktarma

André Cipriani Bandarra

Uygulamalarında Güvenilir Web Etkinliği kullanılırken geliştiricilerin, yerel kısmını Progresif Web Uygulamasına (PWA) aktarmaya yardımcı olur.

Bunun yaygın bir kullanım alanı, yüklemeleri ölçmek için özel analiz segmentasyonu uygulamaktır ve Güvenilir Web Etkinliği'nden başlatılan oturumlar. Sorgu parametreleri, başlatma URL'sine eklenebilir sahip olacaksınız.

Başlangıç URL'sini değiştirme

PWA'ya geçirilmekte olan parametre tüm kullanıcılar ve parametresi açıldığında, parametre doğrudan başlatma URL'sine eklenebilir. Bu kullanıma örnek olarak Geliştiriciler Güvenilir Web'den oluşturulan gezinme oturumlarının sayısını ölçmek istediklerinde Etkinlik'e dokunun.

Baloncuk Sargısını Kullanma

Bubblepack, geliştiricilerin bir projeye yönelik Güvenilir Web'i kullanarak mevcut PWA'ları başlatan Android uygulaması Etkinlik'e dokunun. Hem kitaplık hem de Komut Satırı Arayüzü (KSA) içerir.

Yeni proje oluşturma

BubbleWrap KSA kullanılırken init komutuyla bir proje başlatılır ve Web Manifest'inde parametre olarak sağlanan varsayılan değerler:

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

Sihirbaz, varsayılan olarak Web Manifest'teki start_url değerini kullanır ve kullanıcılardan onaylamalarını ister. Böylece, geliştiricilere Progresif Web Uygulaması.

Mevcut bir projeyi değiştirme

BubbleWrap bir proje oluşturduğunda, söz konusu projeye ilişkin bilgiler bir dosyada depolanır twa-manifest.json adlı dosyayı proje klasöründe bulabilirsiniz. Mevcut projenin başlangıç URL'sini değiştirmek için geliştiricilerin dosyayı değiştirmesi gerekir:

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

Sonra, proje dosyalarını yeniden oluşturun ve yeni başlangıç URL'sini uygulayın

bubblewrap update

Android Studio'yu kullanma

Android Studio ve varsayılan LauncherActivity kullanılırken startUrl bir meta etiket olarak tanımlanır içerebilir.Güvenilir Web Etkinliği'ni başlatmak için kullanılan URL'yi değiştirin:

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

Başlangıç URL'sini dinamik bir şekilde değiştirme

Bazı durumlarda ise geliştiriciler, çeşitli faktörlerden bağımsız olarak, kullanıcılar veya oturumlar kullanır. Çoğu durumda bu işlem, cihazın Android tarafından bilgi toplamayı içerir. bunu Progresif Web Uygulaması'na (pwa) aktarmak için kullanılır.

1. Adım: Özel bir LauncherActivity oluşturun

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. Adım: Özel LauncherActivity'yi kullanmak için AndroidManifest.xml öğesini değiştirin

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

Sonuç

Bir uygulamanın yerel bölümünden web bölümüne bilgi aktarmak için sorgu parametreleridir. Sorgu dizesine bir parametre eklendiğinde, komut dosyaları bu parametreye erişebilir veya kullanıcı farklı bir sayfaya gittiğinde yönlendirmenin de parçası olabilir. Geliştirici bir paylaşım işlemi uygular.

Geliştiriciler bu sonuçların farkında olmalıdır ve aşağıdaki link rel=noreferrer veya page location API'yi kullanarak URL'yi temizleyin.

Güvenilir Web Etkinliği protokolü, şu anda kullanıcılarla mesajlaşmak için bir mekanizma sağlamamaktadır web bölümü çağrıldıktan sonra uygulamanın yerel kısmı

Mevcut veya gelecekte kullanıma sunulacak Web Platformu API'lerinin, geliştiricilerin ihtiyaç duyduğu çoğu kullanım alanını sağlayacağını düşünüyoruz. Eğer Yeni veya gelecek Web API'lerini arıyorsanız Yeni Özellikler durum sayfasına bakın.