Ön sayfanızda SDK

Genellikle bir ziyaretçi ön sayfaya (prelanding) ulaşır ve oradan kurulum düğmesinin bulunduğu PWA mağaza kartına geçer. Ancak kurulum ve push aboneliği doğrudan kendi ön sayfanızda da başlatılabilir: Browser SDK'yı bağlayarak kendi düğmelerinizden SDK metotlarını çağırabilirsiniz. Bu sayede ziyaretçi, mağaza kartına gitmeden uygulamayı kurar ve push bildirimlerine abone olur.

Bunun için ziyaretçinin uygulamayı kurması zorunlu değildir: push aboneliği kurulum olmadan da çalışır.

Önkoşullar

• Qubix'e yüklenmiş bir ön sayfa. Bu sayfa, Websites bölümündeki sayfanızdır — sıradan bir site gibi yükleyin (bkz. Web sitesi yükleme).
• Kurulu ve aktif bir alan adı. Ön sayfa, Qubix'te tanımlanmış ve aktif bir alan adı üzerinde sunulmalıdır (bkz. Domains). Bu zorunludur: kurulum ve push yalnızca sayfa ile SDK'nın hizmet adresleri aynı alan adında olduğunda çalışır.
• Oluşturulmuş bir PWA — PWA Apps bölümündeki karttan alacağınız tanımlayıcıya (pwaId) ihtiyacınız olacak.

Nasıl bağlanır

1. Ön sayfanın koduna yapılandırmayı ekleyin ve SDK betiğini yükleyin. Yapılandırma, betikten önce gelmelidir:

   index.htmlHTML

   <script>
     window.pwaConfig = {
       pwaId: 'YOUR-PWA-ID',
       domain: 'your-domain.com',
     }
   </script>
   <script src="https://your-domain.com/sdk.js" defer></script>

   Push anahtarı /sdk.js içine otomatik olarak eklenir — bunu elle eklemenize gerek yoktur. Alanların tam açıklaması Browser SDK referansında yer almaktadır.

2. SDK'yı kurulum için hazırlayın — sayfa yüklendiğinde yalnızca bir kez çağrılmalıdır. Bu çağrı servis bölümünü kaydeder ve uygulama manifestini ekler:

   JavaScript

   sdk.pwa.init()

3. Kurulumu kendi düğmenize bağlayın:

   HTML

   <button id="install">Uygulamayı kur</button>
   <script>
     document.getElementById('install').addEventListener('click', () => {
       sdk.pwa.install()
     })
   </script>

4. Push aboneliğini kendi düğmenize bağlayın (ya da uygun bir anda çağırın):

   JavaScript

   await sdk.subscribePush()

Tamamdır — kurulum ve abonelik sayfanız üzerinde gerçekleşir. Ziyaretçi mağaza kartına yönlendirilmez.

İpucu

Bazı senaryolarda mağaza kartının açılması gerekiyorsa sdk.showStore() bunu yapar. Bu metodu çağırmayın — ziyaretçi ön sayfanızda kalır.

Kurulumu tarayıcı gösterir

Kurulum düğmesini yalnızca kurulum gerçekten mümkün olduğunda gösterin — bunun için sdk.pwa.canInstall() değerini kontrol edin. Tarayıcılar her zaman kurulum istemine izin vermez: güvenli bir bağlantı (HTTPS) gereklidir ve genellikle ziyaretçinin sayfada bir işlem yapması beklenir. Bu nedenle hem kurulum hem de abonelik normalde, sayfa yüklendiğinde tetiklenmek yerine açık bir dokunuşa bağlanır.

Doğrulama

Ön sayfayı bir telefonda açın ve düğmelerinize dokunun — tarayıcı kurulum isteğini ve bildirim isteğini gösterecektir. Sonuç raporlarda görünür: install_accepted, push_allow ve diğer etkinlikler etkinlik akışına düşer.

Sırada ne var

Browser SDK referansı

Tüm Browser SDK metotları ve etkinlikleri.

Web sitesi yükleme

Qubix'e ön sayfa yükleme.

Push kampanyaları

Abone olanlara bildirim gönderme.